Fiat Account Request Status Webhook

Webhook

POST

To notify fiat account application status

This is a webhook endpoint that must be implemented by the recipient to receive these notifications.
Important:

You do not need to call this API; instead, you need to expose a public endpoint matching this specification.

Refer to the Webhook section for details on signature verification, retry policy, and security best practices.

Applies to: PSP and Direct Client

Request

Authorization

Header Params

Body Params application/json

Example

eventType: fiat.account.request.updated.v2

{
    "data": {
        "accountDetails": [
            {
                "accountId": "4757",
                "baNumber": "79011400000301",
                "bankAddress": "FLOOR 29, MANAMA CENTER BUILDING 1B, 2901 ISA AL-KABEER AVENUE, 365, BLOCK 316, MANAMA, 199",
                "bankName": "SINGAPORE GULF BANK B.S.C. CLOSED",
                "beneficiaryAddress": "{\"addressLine1\":\"1 St\",\"city\":\"SG\",\"country\":\"SG\",\"postcode\":\"123456\"}",
                "beneficiaryName": "Hook2 Test",
                "countryCode": "BH",
                "currency": "USD",
                "swiftCode": "SGBDBHB2XXX"
            }
        ],
        "country": "BH",
        "createdAt": 1784530125000,
        "currency": "USD",
        "participantCode": "A0104989",
        "requestId": "4693",
        "status": 3,
        "statusInfo": "ACTIVE",
        "updatedAt": 1784530129000
    },
    "eventType": "fiat.account.request.updated.v2",
    "notificationId": "fb6ff2d7-a04d-4230-962e-8f42981fab5b"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://your-api-server.com' \
--header 'X-Signature: t=1758867971711,v0=b2468f1bc285eb64be242ee6d02e3c959dfb61482abe47ddb50da4b6be55997e' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "accountDetails": [
            {
                "accountId": "4757",
                "baNumber": "79011400000301",
                "bankAddress": "FLOOR 29, MANAMA CENTER BUILDING 1B, 2901 ISA AL-KABEER AVENUE, 365, BLOCK 316, MANAMA, 199",
                "bankName": "SINGAPORE GULF BANK B.S.C. CLOSED",
                "beneficiaryAddress": "{\"addressLine1\":\"1 St\",\"city\":\"SG\",\"country\":\"SG\",\"postcode\":\"123456\"}",
                "beneficiaryName": "Hook2 Test",
                "countryCode": "BH",
                "currency": "USD",
                "swiftCode": "SGBDBHB2XXX"
            }
        ],
        "country": "BH",
        "createdAt": 1784530125000,
        "currency": "USD",
        "participantCode": "A0104989",
        "requestId": "4693",
        "status": 3,
        "statusInfo": "ACTIVE",
        "updatedAt": 1784530129000
    },
    "eventType": "fiat.account.request.updated.v2",
    "notificationId": "fb6ff2d7-a04d-4230-962e-8f42981fab5b"
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{}

Modified at 2026-08-05 08:19:11

Add Bank Account

Fiat Withdrawal