Webhook Examples

The webhooks the Fyatu service sends to notify you of events.

The following is a list of the webhook events the Fyatu system will send to your endpoint via a POST request:

card.authentication

We send this event whenever there is a transaction that needs to be approved by the cardholder.
This is generally the 3D Secure code to authenticate an online transaction.

3D Secure OTP - Webhook Exemple

{
    "event":"card.authentication",
    "message":"OTP 3D Secure Notification",
    "data":{
        "status":"Pending Auth",
        "cardId":"966d6cdc-95cc-4dc6-a7bf-6fdbbf48fr87",
        "maskedNumber":"536898*******5143",
        "otpCode":"542789",
        "validity":"15 Minutes"
    },
    "version":"1.0",
    "hash":"hTMud6e88eDTd4390AGLUZW=="
}

card.transaction.success

We send this event whenever there is a successful transaction made with a card.

Successful Transaction - Webhook Exemple

{
    "event":"card.transaction.success",
    "message":"Transaction successfully approved",
    "data":{
        "transactionId":"9587d6cdc-95cc-4dc6-a7bf-6fdbbdf4c87",
        "status":"Successful",
        "amount":12.56,
        "currency":"USD",
        "maskedNumber":"536898*******5143",
        "merchantName":"market place gombe zar",
        "availableBalance":46.89
    },
    "version":"1.0",
    "hash":"hTMud6e88eDTd4390AGLUZW=="
}

card.transaction.failed

We send this event whenever there is a failed transaction occured when trying to pay with a card.

Failed Transaction - Webhook Exemple

{
    "event":"card.transaction.failed",
    "message":"Transaction declined",
    "data":{
        "transactionId":"9587d6cdc-95cc-4dc6-a7bf-6fdbbdf4c87",
        "status":"Failed",
        "amount":12.56,
        "currency":"USD",
        "maskedNumber":"536898*******5143",
        "merchantName":"market place gombe zar",
        "availableBalance":46.89
    },
    "version":"1.0",
    "hash":"hTMud6e88eDTd4390AGLUZW=="
}

Did this page help you?