1. Fiat Account Management
v2.1 (Production)
  • v2.1 (Production)
  • v2.1 (Sandbox)
  • v2.0 (Sandbox)
  • v1.0 (Deprecated)
  • v2.1
    • Getting Started
    • Account Setup
    • Idempotent Requests
    • Webhook
    • API Error Handling Guide
    • Changelog 20260408
    • Authentication
      • Create Token
    • Account Management
      • Get Balance
      • Internal Transfer
      • Get Internal Transfer
    • Merchant Management
      • Create Merchant
      • Get Merchant
      • Merchant Status Webhook
    • Fiat Payment
      • Fiat Deposit
        • Get Deposit Bank Account
        • Get Fiat Deposit Detail
        • Get Fiat Deposit History
        • Fiat Deposit Webhook
      • Fiat Account Management
        • Get Fiat Account Capabilities
          GET
        • Create Fiat Account Request
          POST
        • Submit Additional Information for Fiat Account Request
          POST
        • Get Fiat Account Application Status
          GET
        • Get Bank Accounts
          GET
        • Add Bank Account
          POST
        • Fiat Account Request Status Webhook
      • Fiat Withdrawal
        • Get Same Name Withdrawal Capabilities
        • Activate Same Name Withdrawal
        • Submit Additional Information for Activating Same Name Withdrawal
        • Activate Same Name Withdrawal Webhook
        • Create Fiat Withdrawal
        • Submit Additional Information for Fiat Withdrawal Request
        • Get Fiat Withdrawal Detail
        • Get Fiat Withdrawal History
        • Fiat Withdrawal Webhook
    • Crypto Payment
      • Crypto Deposit
        • Update Crypto Deposit Travel Rule Info
        • Get Crypto Deposit Wallet
        • Get Crypto Deposit
        • Get Crypto Deposit History
        • Crypto Deposit Webhook
      • Crypto Withdrawal
        • Register Wallet Address
        • Remove Wallet Address
        • Create Crypto Withdrawal
        • Get Wallet Address
        • Get Crypto Withdrawal
        • Get Crypto Withdrawal History
        • Crypto Withdrawal Webhook
      • Crypto Checkout
        • Create Crypto Checkout
        • Create Crypto Checkout Link
        • Crypto Checkout Wallet Connection
        • Generate POS Payment Request
        • Close Crypto Checkout
        • Get Convertible Cryptos
        • Get Supported Blockchains
        • Get Crypto Checkout
        • Get Crypto Checkout Link
        • Get Crypto Checkout Currencies
        • Crypto Checkout Webhook
      • Crypto Collection
        • Buyer Management
          • Create Buyer
          • Get Buyer
          • Update Buyer
          • Buyer Status Webhook
        • Create Collection Wallet
        • Update Collection Wallet
        • Get Collection Wallet
        • Get Crypto Collection
        • Update Co-KYT status
        • Crypto Collection Wallet Webhook
        • Crypto Collection Webhook
      • Crypto Refund
        • Create Crypto Refund
        • Confirm Crypto Refund
        • Get Crypto Refund
        • Crypto Refund Webhook
    • Conversion
      • Create Quotation
      • Create Conversion
      • Get Quotation
      • Get Conversion
      • Conversion Webhook
    • Tool
      • Upload File
      • getTnC
  1. Fiat Account Management

Fiat Account Request Status Webhook

Webhook
POST
Fiat Account Request Status Webhook
API Overview
ItemValue
API StatusRecommended
Current Versionv2.0
Backward CompatibilityYes
Applicable EnvironmentProduction
Applicable User RolesPSP and Direct Client
TypeWebhook (Incoming)
Description
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.

Request

Authorization
Header Params

Body Params application/json

Example
{
    "code": 200,
    "msg": "success",
    "eventType": "fiat.account.request.updated.v2",
    "notificationId": "a09a9437-120a-4a7f-8884-58cc8977c03a",
    "data": {
        "requestId": "202604150003",
        "participantCode": "B0100106",
        "country": "US",
        "currency": "USD",
        "accountDetails": [
            {
                "beneficiaryName": "Sammy Schmeler",
                "beneficiaryAddress": "[\"77935 Merle Island\",\"Apt 3B\",\"Los Angeles, CA 90001\"]",
                "baNumber": "US12345678901234567890",
                "swiftCode": "CHASUS33",
                "countryCode": "US",
                "bankName": "JPMorgan Chase Bank",
                "bankAddress": "270 Park Avenue, New York, NY 10017",
                "intermediarySwiftCode": null,
                "intermediaryCountryCode": null,
                "intermediaryBankName": null,
                "intermediaryBankAddress": null,
                "currency": "USD",
                "paymentReference": null,
                "accountId": "27"
            },
            {
                "beneficiaryName": "Susie Donnelly",
                "beneficiaryAddress": "[\"75336 Washington Road\",\"Suite 200\",\"Chicago, IL 60601\"]",
                "baNumber": "US98765432109876543210",
                "swiftCode": "CHASUS33",
                "countryCode": "US",
                "bankName": "JPMorgan Chase Bank",
                "bankAddress": "270 Park Avenue, New York, NY 10017",
                "intermediarySwiftCode": null,
                "intermediaryCountryCode": null,
                "intermediaryBankName": null,
                "intermediaryBankAddress": null,
                "currency": "USD",
                "paymentReference": null,
                "accountId": "47"
            },
            {
                "beneficiaryName": "Kristine Turner",
                "beneficiaryAddress": "[\"37675 Daphney Plaza\",\"Floor 12\",\"Houston, TX 77002\"]",
                "baNumber": "US55555555555555555555",
                "swiftCode": "CHASUS33",
                "countryCode": "US",
                "bankName": "JPMorgan Chase Bank",
                "bankAddress": "270 Park Avenue, New York, NY 10017",
                "intermediarySwiftCode": null,
                "intermediaryCountryCode": null,
                "intermediaryBankName": null,
                "intermediaryBankAddress": null,
                "currency": "USD",
                "paymentReference": null,
                "accountId": "48"
            }
        ],
        "status": 1,
        "statusInfo": "PENDING",
        "tncToBeAccepted": [
            "X101"
        ],
        "missingFields": [],
        "createdAt": 1776046508000,
        "updatedAt": 1776132908000
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://your-api-server.com' \
--header 'X-Signature: t=1758867971711,v0=b2468f1bc285eb64be242ee6d02e3c959dfb61482abe47ddb50da4b6be55997e' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": 200,
    "msg": "success",
    "eventType": "fiat.account.request.updated.v2",
    "notificationId": "a09a9437-120a-4a7f-8884-58cc8977c03a",
    "data": {
        "requestId": "202604150003",
        "participantCode": "B0100106",
        "country": "US",
        "currency": "USD",
        "accountDetails": [
            {
                "beneficiaryName": "Sammy Schmeler",
                "beneficiaryAddress": "[\"77935 Merle Island\",\"Apt 3B\",\"Los Angeles, CA 90001\"]",
                "baNumber": "US12345678901234567890",
                "swiftCode": "CHASUS33",
                "countryCode": "US",
                "bankName": "JPMorgan Chase Bank",
                "bankAddress": "270 Park Avenue, New York, NY 10017",
                "intermediarySwiftCode": null,
                "intermediaryCountryCode": null,
                "intermediaryBankName": null,
                "intermediaryBankAddress": null,
                "currency": "USD",
                "paymentReference": null,
                "accountId": "27"
            },
            {
                "beneficiaryName": "Susie Donnelly",
                "beneficiaryAddress": "[\"75336 Washington Road\",\"Suite 200\",\"Chicago, IL 60601\"]",
                "baNumber": "US98765432109876543210",
                "swiftCode": "CHASUS33",
                "countryCode": "US",
                "bankName": "JPMorgan Chase Bank",
                "bankAddress": "270 Park Avenue, New York, NY 10017",
                "intermediarySwiftCode": null,
                "intermediaryCountryCode": null,
                "intermediaryBankName": null,
                "intermediaryBankAddress": null,
                "currency": "USD",
                "paymentReference": null,
                "accountId": "47"
            },
            {
                "beneficiaryName": "Kristine Turner",
                "beneficiaryAddress": "[\"37675 Daphney Plaza\",\"Floor 12\",\"Houston, TX 77002\"]",
                "baNumber": "US55555555555555555555",
                "swiftCode": "CHASUS33",
                "countryCode": "US",
                "bankName": "JPMorgan Chase Bank",
                "bankAddress": "270 Park Avenue, New York, NY 10017",
                "intermediarySwiftCode": null,
                "intermediaryCountryCode": null,
                "intermediaryBankName": null,
                "intermediaryBankAddress": null,
                "currency": "USD",
                "paymentReference": null,
                "accountId": "48"
            }
        ],
        "status": 1,
        "statusInfo": "PENDING",
        "tncToBeAccepted": [
            "X101"
        ],
        "missingFields": [],
        "createdAt": 1776046508000,
        "updatedAt": 1776132908000
    }
}'

Responses

🟢200OK
application/json
Body

Example
{}
Modified at 2026-04-17 08:50:01
Previous
Add Bank Account
Next
Fiat Withdrawal
Built with