Callback Samples
Once your server is configured to receive callbacks, it'll listen for any request sent to the endpoint you configured.
Deposit/Payment Callbacks
Payment transactions with a status of completed/refunded share the same JSON payload structure. The only difference is that the status field reflects either
completedorrefunded.
{
"id": "contract_820d55d3621342bbad68a5d795e8a88d",
"type": "Direct bank transfer",
"idempotency_id": "0ded43ab-3f06-498d-a776-8fa8fd8ddf35",
"amount": "29955.0",
"fees": "0.0",
"status": "completed",
"bank_account_no": "885381014328374",
"merchant_ref": "John Doe",
"blocked_reasons": [],
"currency": "xusd",
"end_to_end_ref": "S0661340E3B601",
"transaction_remarks": "MYSELF PERSONAL PURPOSE",
"payment_method": {
"id": "virtual_account_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"reference_id": "John Doe",
"account_no": "885381014328374",
"bank_short_code": "DBS",
"bank_name": "DBS Bank",
"bank_address": "12 MARINA BOULEVARD, MBFC TOWER 3, SINGAPORE 018982",
"bank_country": "Singapore",
"swift_bic": "DBSSSGSGXXX",
"recipient_name": "JOHN DOE"
},
"sender_information": {
"account_holder_name": "JOHN DOE",
"account_number": "SA 832-011076-001",
"bank_short_code": null,
"bank_name": null,
"end_to_end_ref": "S0661340E3B601",
"swift_bic": "SABBSARIXXX",
"transaction_remarks": "MYSELF PERSONAL PURPOSE"
},
"sender_bank": null,
"sender_bank_account_no": "SA 832-011076-001",
"sender_bank_account_holder_name": "JOHN DOE",
"sender_bank_swift_bic": "SABBSARIXXX",
"created_at": "2025-04-16T08:15:42.681Z",
"updated_at": "2025-04-16T08:15:43.330Z",
"customer_profile_id": "customer_profile_74a5cfe1-587e-4dcf-8885-3e92f5d3c96c"
}
{
"id": "contract_ce3e2a69c5694665a41fe3f7130e0f35",
"type": "Direct bank transfer",
"idempotency_id": "a4e709611640500d5b1c66241850c3b6",
"amount": "1000.0",
"fees": "0.0",
"status": "completed",
"bank_account_no": "3225445900001",
"merchant_ref": "merchant-va-ref-001",
"blocked_reasons": [],
"currency": "xsgd",
"end_to_end_ref": "Acme Fintech 0514023018201",
"transaction_remarks": null,
"payment_method": {
"id": "StraitsX-175932-fc1783e5-7854-4388-8111-035385ff9220",
"reference_id": "merchant-va-ref-001",
"account_no": "3225445900001",
"bank_short_code": "FAZZ",
"recipient_name": "Xfers Pte Ltd"
},
"sender_information": {
"account_holder_name": "ACME FINTECH PTE. LTD.",
"account_number": "0721100001",
"bank_short_code": "DBS",
"bank_name": "DBS Bank Ltd",
"end_to_end_ref": "Acme Fintech 0514023018201",
"swift_bic": "DBSSSGSGXXX",
"transaction_remarks": null
},
"sender_bank": "DBS Bank Ltd",
"sender_bank_account_no": "0721100001",
"sender_bank_account_holder_name": "ACME FINTECH PTE. LTD.",
"sender_bank_swift_bic": "DBSSSGSGXXX",
"created_at": "2025-04-16T02:30:22.492Z",
"updated_at": "2025-04-16T02:30:22.850Z",
"customer_profile_id": "customer_profile_af516116-f262-4582-9536-4ddc86fc7442"
}
{
data: {
"attributes": {
"amount": "200.0",
"createdAt": "2025-07-07T15:19:07.898+08:00",
"currency": "xsgd",
"fees": "0.0",
"idempotencyId": "f58cdudhdd-bb77-4352-877e-a4387i36de",
"senderInformation": {
"accountHolderName": "Ettie Satterfield",
"accountNumber": "123456787",
"swiftBic": ""
},
"transactionRemarks": "sgd deposit",
"status": "completed"
},
"id": "contract_f75ca6e1234nfj5n56454667959cc93",
"type": "bankTransfer"
}
}{
"data": {
"id": "contract_dcf0c5e4065a41f78a0fb601b10ecacf",
"type": "bankTransfer",
"attributes": {
"idempotencyId": "04e708d2-f53d-4f70-bf18-518e5b897019",
"currency": "usd",
"amount": "100.0",
"fees": "0.0",
"status": "completed",
"createdAt": "2025-07-17T14:22:33.399+08:00",
"senderInformation": {
"accountHolderName": "Ettie Satterfield",
"accountNumber": null,
"swiftBic": null,
"transactionRemarks": "nas bt test callback"
},
"blockedReasons": []
}
}
}{
"id": "contract_a1b2c3d4e5f6789012345678abcdef01",
"type": "paynowTransaction",
"idempotency_id": "2026051400001234",
"amount": "50.0",
"fees": "0.0",
"status": "completed",
"bank_account_no": null,
"merchant_ref": "2026051400001234",
"blocked_reasons": [],
"currency": "xsgd",
"end_to_end_ref": "paynow1a2b3c4d5e6f789012",
"transaction_remarks": null,
"payment_method": {
"id": "paynow_b2c3d4e5-f6a7-8901-bcde-f12345678901",
"reference_id": "2026051400001234",
"base64_encoded_image": "<base64 QR code image>",
"qr_code_data": "00020101021226650009SG.PAYNOW...",
"expires_at": "2026-05-14T14:25:32.000Z"
},
"sender_information": {
"account_holder_name": "Jane Smith",
"account_number": "1234567890",
"bank_short_code": "UOB",
"bank_name": "United Overseas Bank Ltd",
"end_to_end_ref": "paynow1a2b3c4d5e6f789012",
"swift_bic": "UOVBSGSGXXX",
"transaction_remarks": null
},
"sender_bank": "United Overseas Bank Ltd",
"sender_bank_account_no": "1234567890",
"sender_bank_account_holder_name": "Jane Smith",
"sender_bank_swift_bic": "UOVBSGSGXXX",
"customer_profile_id": "customer_profile_c3d4e5f6-a7b8-9012-cdef-123456789012",
"created_at": "2026-05-14T14:19:33.483Z",
"updated_at": "2026-05-14T14:19:58.509Z"
}Callback for Bank Transfer Payout Status Update
{
"id": "contract_c3d4e5f6-a7b8-9012-cdef-123456789012",
"type": "Withdrawal on behalf",
"idempotency_id": "payout-usd-unique-key-789",
"amount": "10000.0",
"fees": "0.0",
"status": "completed",
"account_no": "068760057173",
"bank_abbrev": "",
"failure_reason": "",
"arrival": "14 May 2026 - 9:11 AM",
"currency": "usd",
"payout_invoice_id": "payout-usd-unique-key-789",
"wallet_name": "Digital Goods",
"bank_account_holder_name": "Acme Corp Pte. Ltd.",
"swift_bic": "TSIBTWTP",
"beneficiary_address": "123 Main Street, Singapore, SG, 018982",
"routing_code": "",
"intermediary_swift_bic": "",
"description": null,
"external_reference": "payout-ext-ref-789",
"charge_option": "OUR",
"created_at": "2026-05-14T01:11:03.800Z",
"updated_at": "2026-05-14T01:11:27.946Z"
}{
"id": "contract_b2c3d4e5-f6a7-8901-bcde-f12345678901",
"type": "Withdrawal on behalf",
"idempotency_id": "payout-unique-key-456",
"amount": "500.0",
"fees": "0.0",
"status": "completed",
"account_no": "1234567890",
"bank_abbrev": "OCBC",
"failure_reason": "",
"arrival": "13 May 2026 - 10:51 PM",
"currency": "sgd",
"payout_invoice_id": "payout-unique-key-456",
"wallet_name": "Digital Goods",
"external_reference": "payout-unique-key-456",
"created_at": "2026-05-13T14:51:07.967Z",
"updated_at": "2026-05-13T14:51:09.814Z",
"express": "FAST"
}{
"attributes": {
"amount": "0.1",
"bankAccount": {
"account_holder_name": "STRAITSX DEMO ACCOUNT",
"account_no": "0101754639",
"bank": "",
"intermediary_swift_bic": "",
"routing_code": "",
"swift_bic": "SCBLSG22XXX"
},
"createdAt": "2025-06-13T12:39:53.033+08:00",
"currency": "xsgd",
"fees": "0.0",
"transactionRemarks": "Payment for invoice #1234",
"idempotencyId": "trxn_idempotency_id_0000001_test_callback_again",
"netAmount": "0.1",
"status": "pending",
"updatedAt": "2025-06-13T12:39:53.127+08:00"
},
"id": "contract_bc14ed598f274bd09ccbf27401920154",
"type": "withdrawal"
}Callback for FX Payout Status Update (Coming Soon)
{
"data": {
"id": "d4d1da72-111e-4d52-bdbf-2e74a2d803d5",
"type": "fxPayout",
"attributes": {
"status": "completed",
"quoteId": "fx_quote_c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
"recipientId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"rate": 15832.5,
"from": {
"currency": "XUSD",
"amount": "1000.00"
},
"to": {
"currency": "IDR",
"amount": "15832500.00"
},
"fee": {
"currency": "XUSD",
"amount": "1.50"
},
"initiator": null,
"createdAt": "2025-03-25T20:04:05+08:00",
"updatedAt": "2025-03-25T20:10:00+08:00"
}
}
}
{
"data": {
"id": "d4d1da72-111e-4d52-bdbf-2e74a2d803d5",
"type": "fxPayout",
"attributes": {
"status": "failed",
"quoteId": "fx_quote_c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
"recipientId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"rate": 15832.5,
"from": {
"currency": "XUSD",
"amount": "1000.00"
},
"to": {
"currency": "IDR",
"amount": "15832500.00"
},
"fee": {
"currency": "XUSD",
"amount": "1.50"
},
"initiator": {
"mode": "onBehalfOf",
"customerProfileId": "b2c3d4e5-f6a7-8901-bcde-f23456789012"
},
"createdAt": "2025-03-25T20:04:05+08:00",
"updatedAt": "2025-03-25T22:15:30+08:00"
}
}
}
Callback for Virtual Bank Account Status Update
{
"data": {
"attributes": {
"currency": "USD",
"referenceId": "finaltesting123_usd_biz",
"status": "disabled"
},
"id": "StraitsX-2370-0fbec826-5c15-4afe-b338-5818cc706da5",
"type": "virtual_bank_account"
}
}{
"data":{
"id":"virtual_account_df1689fc-9fd5-452b-bbad-2eccfbc7459b",
"type":"virtual_bank_account",
"attributes":{
"referenceId":"414186459",
"currency":"USD",
"status":"enabled",
"instructions":{
"recipientName":"ABC LIMITED",
"bankName":"DBS Bank",
"bankAddress":"12 MARINA BOULEVARD, MBFC TOWER 3, SINGAPORE 018982",
"bankCountry":"Singapore",
"swiftBic":"DBSSSGSGXXX",
"accountNo":"885375018112345"
},
"createdAt":"2025-12-04T06:51:39.669Z"
}
}
}Callback for Swap Status Update
{
"data": {
"attributes": {
"createdAt": "2024-04-03T13:56:05.219+08:00",
"customerProfileId": "",
"fees": [
{
"type": "TransactionFee",
"amount": 13.3,
"currency": "XSGD"
}
],
"fixedSide": "target",
"idempotencyId": "sang_test3",
"quoteId": "8185705a-857d-4e0c-a0e0-8453b3cf4929",
"rate": 0.7516,
"sourceCurrency": "XSGD",
"sourceCurrencyAmount": 13304.95,
"status": "completed",
"swapPair": "XSGDUSDC",
"targetCurrency": "USDC",
"targetCurrencyAmount": 10000.0,
"totalSourceCurrencyAmount": 13318.25,
"updatedAt": "2024-04-03T18:25:51.936+08:00"
},
"id": "contract_ff8c902f245f4124b1f28bed306f9b8b",
"type": "swapTransaction"
}
}Blockchain Deposit and Withdrawal Status Update Callbacks
The JSON payload structure is the same for both deposit and withdrawal status update callbacks. To determine the event type, inspect the
typefield:
- Blockchain Deposit:
stablecoin_deposit_contract- Blockchain Withdrawal:
stablecoin_withdraw_contract
{
"data": {
"attributes": {
"amount": "1.0",
"blockchain": "XSGD_ERC20",
"created_at": "2026-01-23T11:07:45.693Z",
"idempotency_id": "e8b7c6d5a4f3e2d1c0b9a8f7e6d5c4b3",
"network": "Ethereum",
"network_fees": "0.0",
"status": "completed",
"token": "xsgd",
"total_amount": "1.0",
"transaction_hash": "0x7f3e8b2a1c9d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e",
"transaction_source": "0x1234567890abcdef1234567890abcdef12345678"
},
"id": "contract_0d151e28146d42aabf9115ee3f6c6926",
"type": "stablecoin_deposit_contract"
}
}{
"data": {
"attributes": {
"amount": "2.0",
"blockchain": "XSGD_MATIC",
"created_at": "2024-06-11T04:48:39.912Z",
"idempotency_id": "testing",
"network": "Polygon",
"network_fees": "0.02",
"status": "completed",
"token": "xsgd",
"total_amount": "2.02",
"transaction_hash": "0x658043f80b1684cce02a0f4c0ed5449589eef495492bae5a849e47e80c46dd4d",
"transaction_source": "0x4fd0f684dcf7c6c862114db8cebfe8bf6bb175c3"
},
"id": "contract_7afa75105cad43579f9589ebe30b6784",
"type": "stablecoin_withdraw_contract"
}
}Customer Profile Callbacks
{
"data": {
"id": "customer_profile_8bcef957-74a5-4c07-bcaa-0b377c02ca13",
"type": "customer_profile",
"attributes": {
"customerName": "Xfers Pte. Ltd.",
"tradingName": "Xfers",
"registrationType": "business",
"registrationIdType": "business_reg_no",
"registrationIdCountry": "SG",
"registrationId": "201411660R",
"address": {
"street": "10 Albert Street",
"city": "Singapore",
"postalCode": "000000",
"state": "Singapore",
"country": "SG"
},
"placeOfBiz": "10 Albert Street, 000000 Singapore",
"placeOfBizCountry": "SG",
"countryOfIncorporation": "SG",
"dateOfIncorporation": "2020-11-14",
"verificationStatus": "verified",
"createdAt": "2025-06-13T04:24:39Z",
"updatedAt": "2025-06-13T04:30:12Z"
}
}
}
{
"data": {
"id": "customer_profile_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"type": "customer_profile",
"attributes": {
"customerName": "Jane Doe",
"registrationType": "personal",
"registrationId": "S1234567A",
"verificationStatus": "verified",
"dateOfBirth": "1990-01-15",
"gender": "FEMALE",
"nationality": "SG",
"email": "[email protected]",
"address": {
"street": "123 Orchard Road",
"city": "Singapore",
"country": "SG",
"postalCode": "238888"
},
"registrationIdCountry": "SG",
"registrationIdType": "identity_card",
"createdAt": "2026-05-14T08:16:53Z",
"updatedAt": "2026-05-14T08:17:55Z"
}
}
}{
"data": {
"id": "customer_profile_989407bb-1cc8-4e9b-a73b-864a4d1ba1c0",
"type": "customer_profile",
"attributes": {
"customerName": "ABC Pte Ltd",
"tradingName": "ABC Brand",
"registrationType": "business",
"registrationId": "20123232321",
"verificationStatus": "verified",
"address": {
"city": "Singapore",
"state": "Singapore",
"street": "Northside 18th",
"country": "SG",
"postalCode": "8809"
},
"operatingAddress": {
"city": "Singapore",
"state": "Singapore",
"street": "Northside 18th",
"country": "SG",
"postalCode": "8809"
},
"registrationIdCountry": "SG",
"placeOfBiz": "SG",
"placeOfBizCountry": "SG",
"countryOfIncorporation": "SG",
"dateOfIncorporation": "1999-09-09",
"registrationIdType": "business_reg_no",
"purposeOfAccount": "OTHERS",
"otherPurposeOfAccount": "TEST",
"entityLegalForm": "PUBLIC_COMPANY",
"businessContact": "+6565123456",
"intermediaries": true,
"natureOfBusiness": "PERSONAL_INVESTMENT_COMPANIES",
"usOwnership": true,
"monthlyTransactionVolume": "80001_TO_100000",
"sourceOfFunds": ["PERSONAL_SAVINGS", "OTHERS"],
"otherSourceOfFunds": "other source of funds",
"directors": [
{
"lastName": "Doe",
"firstName": "John",
"nationality": "SG",
"dateOfBirth": "1950-01-01",
"registrationId": "A12321321",
"countryOfResidence": "SG",
"registrationIdType": "passport",
"registrationIdCountry": "SG"
},
{
"lastName": "Doe",
"firstName": "Jane",
"nationality": "SG",
"dateOfBirth": "1950-01-01",
"registrationId": "A12321321",
"countryOfResidence": "SG",
"registrationIdType": "identity_card",
"registrationIdCountry": "SG"
}
],
"beneficialOwners": [
{
"lastName": "Doe",
"firstName": "John",
"nationality": "SG",
"dateOfBirth": "1950-01-01",
"registrationId": "A12321321",
"countryOfResidence": "SG",
"registrationIdType": "passport",
"registrationIdCountry": "SG"
},
{
"lastName": "Doe",
"firstName": "Jane",
"nationality": "SG",
"dateOfBirth": "1950-01-01",
"registrationId": "A12321321",
"countryOfResidence": "SG",
"registrationIdType": "identity_card",
"registrationIdCountry": "SG"
}
],
"trader": {
"lastName": "Doe",
"firstName": "John",
"nationality": "SG",
"dateOfBirth": "1950-01-01",
"livenessResult": true,
"registrationId": "A12321321",
"countryOfResidence": "SG",
"registrationIdType": "identity_card",
"registrationIdCountry": "SG"
},
"licensingStatus": "NOT_SUBJECTED_TO_LICENSING_REQUIREMENTS",
"createdAt": "2024-12-26T17:01:52Z",
"updatedAt": "2024-12-26T17:01:59Z"
}
}
}{
"data": {
"id": "abc_1234",
"type": "transactionLimits",
"attributes": {
"customerProfileId": "customer_profile_12313123",
"totalAnnualPaymentLimit": 200000,
"availableAnnualPaymentLimit": 200000,
"totalAnnualPayoutLimit": 200000,
"availableAnnualPayoutLimit": 200000,
"transactionSizeLimit": null
}
}
}{
"data": {
"id": "abc_1234",
"type": "transactionLimits",
"attributes": {
"customerProfileId": "customer_profile_12313123",
"totalDailyPaymentLimit": 200000,
"availableDailyPaymentLimit": 200000,
"totalDailyPayoutLimit": 200000,
"availableDailyPayoutLimit": 200000,
"transactionSizeLimit": null
}
}
}{
"data": {
"id": "abc_1234",
"type": "transactionLimitsUpdateRequest",
"attributes": {
"status": "approved",
"customerProfileId": "customer_profile_12313123",
"createdAt": "2025-01-16T09:52:52Z",
"updatedAt": "2025-01-16T09:52:52Z"
}
}
}{
"data": {
"id": "customer_profile_08d5ffe5-8a02-4dc2-aabb-9057b8ab3c65",
"type": "customer_profile",
"attributes": {
"customerName": "TEST REJECT",
"isRetryable": true,
"verificationRejectionSummary": "Rejected due to StraitsX policy",
"registrationType": "personal",
"registrationId": "S9823457FY",
"verificationStatus": "rejected",
"dateOfBirth": "1998-03-14",
"gender": "MALE",
"nationality": "SG",
"email": "[email protected]",
"phoneNo": "6595109217",
"address": {
"city": "KUALA LUMPUR",
"country": "MALAYSIA",
"postalCode": "18000",
"state": "KUALA LUMPUR",
"street": "SOUTH 16TH"
},
"registrationIdCountry": "SG",
"registrationIdType": "passport",
"registrationIdExpiryDate": "2030-12-30",
"businessIndustry": "PAWN_BROKERAGE",
"occupation": "SENIOR_ASSOCIATE_OR_SENIOR_EXECUTIVE",
"expectedAnnualTransactionAmount": "0_TO_1000",
"expectedTransactionSize": "0_TO_1000",
"expectedTransactionFrequency": "AT_LEAST_ONCE_EVERY_2_WEEKS",
"annualIncome": "0_TO_30000",
"identityDocuments": {
"selfie": {
"rejectionReason": "",
"status": "verified"
},
"passport": {
"rejectionReason": "",
"status": "verified"
},
"proofOfAddress": {
"rejectionReason": "",
"status": "verified"
},
"livenessSnapshot": {
"rejectionReason": "",
"status": "verified"
},
"livenessResult": true
},
"ipAddresses": ["10.0.1.1", "10.0.1.6"],
"countryOfResidence": "SG",
"customerNativeName": "中国宝武钢铁集团",
"customerFirstName": "TEST",
"customerLastName": "REJECT",
"sourceOfWealth": {
"cashSavings": {
"rejectionReason": "",
"status": "verified"
},
"lotteryWinnings": {
"rejectionReason": "",
"status": "verified"
}
},
"createdAt": "2025-09-15T07:07:16Z",
"updatedAt": "2025-09-15T07:10:22Z",
"riskRating": {
"status": "rejected",
"rejection_reason": ["Rejected due to StraitsX policy"]
}
}
}
}Customer Profile Bank Account Callbacks
{
"id": 1,
"account_no": "26862672670",
"account_holder_name": "John Doe",
"bank_abbrev": "BCA",
"disabled": false,
"verification_status": "pending",
"bank_account_proof": "bankAccountProofPlaceholder.png",
"updated_at": "2026-02-03T10:13:25.237Z",
"payment_reason": "Invoice #12345"
}{
"id": 1,
"account_no": "26862672670",
"account_holder_name": "John Doe",
"bank_abbrev": "BCA",
"disabled": false,
"verification_status": "verified",
"bank_account_proof": "bankAccountProofPlaceholder.png",
"updated_at": "2026-02-03T10:13:25.237Z",
"payment_reason": "Invoice #12345"
}RFI Callback
{
"attributes": {
"activeRfRequest": {
"createdAt": "2025-09-11T08:59:32Z",
"rfQuestions": [
{
"id": "1823",
"question": "What is your primary business activity?",
"optional": false,
"replyType": "TEXT",
"userReply": "",
"questionStatus": "pending",
"rejectionReason": "",
"requiresAction": true
},
{
"id": "1024",
"question": "Provide your payslip for the last 3 months",
"optional": false,
"replyType": "DOC",
"userReply": "",
"questionStatus": "pending",
"rejectionReason": "",
"requiresAction": true
},
{
"id": "1025",
"question": "What is your payment method preference?",
"optional": false,
"replyType": "CHECKBOX",
"userReply": "",
"questionStatus": "pending",
"rejectionReason": "",
"requiresAction": true,
"checkboxOptions": ["Credit Card", "PayPal", "Bank Transfer"]
}
],
"status": "sent",
"rfProgressSummary": {
"acceptedQuestions": 0,
"completionPercentage": 0
},
"daysExpired": 0,
"daysUntilExpiry": 2,
"expiryDate": "2025-09-30T16:59:52Z",
"pendingQuestions": 3,
"rejectedQuestions": 0,
"totalQuestions": 3
}
},
"id": "rfi_request_usy4lc8xoadpl8",
"customerProfileId": "customer_profile_123_abc",
"type": "rfiRequest"
}Updated 9 days ago
