Webhooks

Webhooks

We send webhooks to your callback URL set in the developer section of your profile on our website. Webhooks expect a 200 status code from your callback URL, or it will retry 5 more times, exponentially backing off each time over 24 hours.

We send webhooks on 3 different events:

card_created: a card request has been successfully created and the details of the card is being delivered. A meta key is delivered if this was included in the card request. It bears an object sent along with the card request.
topup_created: sent after a successful funding/topup for a card bearing the details
card_transaction: sent at a debit or credit transaction on a card

topup_failed: sent at a failed funding/topup for a card bearing the details. Arrival of this webhook implies reversal of charged amount has been completed.

card_failed: sent at a failed card creation. Arrival of this webhook implies reversal of charged amount has been completed.

Callback URL

Setup your callback URL for webhooks we send to your service at the completion of select events. See a list of webhook events below.

Sample webhook

Python

{
    "event": "card_created",
    "data": {
                "card_request_id": "20221010sjgj3h08gufv3",
                "card_id": "sdfgagsghgdshjjy",
                "account": {"_id": "23rgwrjepvoijkrpo34g9"}
            },
     "metadata": {"user_id": "1234"}
}