Callback Samples

Once your server is configured to receive callbacks, it'll listen for any request sent to the endpoint you configured.

Callback for Bank Transfer Payment Status Update

{
    "id": "contract_820d55d3621342bbad68a5d795e8a88d",
    "type": "Direct bank transfer",
    "idempotency_id": "0ded43ab-3f06-498d-a776-8fa8fd8ddf35",
    "amount": "100.0",
    "fees": "0.0",
    "status": "completed",
    "bank_account_no": "885381014328374",
    "merchant_ref": "John Doe",
    "blocked_reasons": [],
    "currency": "xusd",
    "end_to_end_ref": null,
    "transaction_remarks": null,
    "sender_bank": null,
    "sender_bank_account_no": "123456789",
    "sender_bank_account_holder_name": "John Doe",
    "sender_bank_swift_bic": "DBSSSGSGXXX",
    "created_at": "2025-04-16T08:15:42.681Z",
    "customer_profile_id": "customer_profile_74a5cfe1-587e-4dcf-8885-3e92f5d3c96c",
    "additional_info": null
}
{
  "amount": 0.1,
  "bank_account_no": "32112345678910",
  "created_at": "2025-06-26T03:12:47.206Z",
  "currency": "xsgd",
  "customer_profile_id": "customer_profile_74a5cfe1-587e-4dcf-8885-3e92f5d3c96c",
  "end_to_end_ref": "Hello World",
  "fees": 0.1,
  "id": "contract_3edcf5f0e1f123498c3ac45e40aaf249",
  "idempotency_id": "SUBSCRIPTION_3f5e581012e73827382ee8d82db7e3982",
  "merchant_ref": "John Doe",
	"blocked_reasons": [],
  "sender_bank": "DBS Bank Ltd",
  "sender_bank_account_holder_name": "John Doe",
  "sender_bank_account_no": "12345678",
  "sender_bank_swift_bic": "DBSSSGSGXXX",
  "status": "completed",
  "transaction_remarks": "",
  "type": "Direct bank transfer"
}

Callback for Bank Transfer Payout Status Update

{
  "id": "contract_b0efcd48df41475babb29dd22664ec29",
  "idempotency_id": "withdrawal_unique_id1231213",
  "type": "Withdrawal on behalf",
  "status": "pending",
  "created_at": "2025-01-17T08:58:18.807Z",
  "currency": "xusd",
  "amount": "100.0",
  "fees": "0.0",
  "account_no": "434343DSE",
  "bank_abbrev": "SWIFT",
  "swift_bic": "ZZZSSGSG",
  "intermediary_swift_bic": "",
  "routing_code": "",
  "wallet_name": "Digital Goods",
  "express": "FAST",
  "charge_option": "SHA",
  "arrival": "",
  "description": "sample description",
  "external_reference": "sample external ref",
  "failure_reason": "",
  "payout_invoice_id": "withdrawal_unique_id1231213",
  "bank_account_holder_name": "John Doe",
  "beneficiary_address": "Northside 18th, Singapore, Singapore, SG, 8809"
}
{
    "id": "contract_2bb032dd191012e3d9898fa5cb4",
    "type": "Withdrawal on behalf",
    "idempotency_id": "12343533",
    "amount": "10.0",
    "fees": "0.0",
    "status": "completed",
    "account_no": "1234567",
    "bank_abbrev": "DBS",
    "failure_reason": "",
    "arrival": "26 Jun 2025 - 11:22 AM",
    "currency": "xsgd",
    "express": "FAST",
    "payout_invoice_id": "12345645",
    "wallet_name": "Digital Goods",
    "created_at": "2025-06-26T03:22:24.005Z",
    "external_reference": null
  }

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": {
    "attributes": {
      "currency": "USD",
      "instructions": {
        "accountNo": "8853810110288",
        "bankAddress": "12 Marina Boulevard, DBS Asia Central, Marina Bay Financial Centre Tower 3, Singapore 018982",
        "bankCountry": "Singapore",
        "bankName": "DBS Bank",
        "swiftBic": "DBSSSGS0XXX"
      },
      "referenceId": "bob_test_usd",
      "status": "enabled"
    },
    "id": "StraitsX-2370-3cac90df-3e2f-48ab-9985-873065959c0d",
    "type": "virtual_bank_account"
  }
}

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"
  }
}

Callback for User Withdrawal Status Update

{
  "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",
    "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 Blockchain Withdrawal Status Update

{
  "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"
  }
}

Callback for Customer Profile Verification Status Update

{
    "data": {
        "id": "customer_profile_989407bb-1cc8-4e9b-a73b-864a4d1ba1c0",
        "type": "customer_profile",
        "attributes": {
            "customerName": "ABC Pte Ltd",
            "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",
            "countryOfIncorporation": "SG",
            "dateOfIncorporation": "1999-09-09",
            "registrationIdType": "business_reg_no",
            "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"
            },
            "createdAt": "2024-12-26T17:01:52Z",
            "updatedAt": "2024-12-26T17:01:59Z"
        }
    }
}

Callback for Customer Profile Transaction Limit Update

{
  "data": {
    "id": "abc_1234",
    "type": "transactionLimits",
    "attributes": {
      "customerProfileId": "customer_profile_12313123",
      "totalAnnualPaymentLimit": "",
      "availablePaymentLimit": "",
      "totalAnnualPayoutLimit": "",
      "availablePayoutLimit": "",
      "totalDailyTransactionLimit": 300000,
      "availableDailyTransactionLimit": 300000,
      "transactionSizeLimit": ""
    }
  }
}

Callback for Customer Profile Transaction Limit Update Request Status Update

{
	"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"
		}
	}
}