Skip to main content
Version: multi-v3

Card Notifications

Card webhook notifications inform you of events that happen and that apply to the cards of your customers. Learn how you can start receiving webhook notifications in the webhooks guide.

Weavr sends the following card-related webhook notifications:

Card Authorisations

Weavr informs you in real-time via webhooks when someone makes a card authorisation attempt. Weavr sends the outcome of the attempt via webhooks together with the details of the purchase. You can use these notifications to notify customers in real-time that someone attempted or made a purchase using the card.

The information will be sent to you using the ${WEBHOOK_URL}/managed_cards/authorisations/watch webhook URL.

info

The ${WEBHOOK_URL} is the URL configured in your application settings.

You will receive card authorisation notifications both when the purchase is approved or rejected. You can find the outcome of the purchase authorisation in the request body of the notification in the approved field, which has a boolean value. If the purchase was rejected, the request body will also contain the declineReason field containing the reason why the purchase was rejected.

Card Settlements

In most cases, a card settlement is a confirmation of a card authorisation initiated earlier. You should expect to receive a settlement of a purchase after a purchase was initiated. Card authorisations can take up to 30 days to be settled, but in most cases you receive a settlement transaction in just a few hours.

The settlement information will be sent to you using the ${WEBHOOK_URL}/managed_cards​/settlements​/watch webhook URL.

The notification includes the following fields:

  • The transactionAmount, which is the amount that has been deducted from the card
  • The sourceAmount, which is the original purchase amount; if the card was used to make a purchase in a currency that is different than the card’s currency, this field will show the amount in the currency of the purchase

System Balance Adjustments

In some situations, the system updates the balance of the card. This means that the system either deducts funds or credits them to the card. For example, when you replace a lost or stolen physical card with a new one, the system automatically transfers funds from the old card to the new card.

Whenever the system performs a system balance adjustment, the transaction information will be sent to you using the ${WEBHOOK_URL}/managed_cards/adjustments/watch webhook URL.

The notification includes the following fields:

  • The adjustmentAmount credited or deducted from the card
  • The availableBalance of the card after the adjustment