Callback Configuration

StraitsX sends HTTP POST callbacks to your registered endpoints when transaction or resource statuses change. You can configure callback URLs from your StraitsX Business Dashboard under Platform Tools → Callback URL.

The Dashboard organizes events into two tabs:

TabContains
Client EventEvents triggered by your own platform's activity (deposits, withdrawals, blockchain actions, bank accounts, virtual accounts)
End Customer EventEvents triggered by your customers' activity (payments, payouts, CP verification, CP bank accounts, transaction limits, RFI)
📘

You can set a different URL for each event type, or use the same URL for multiple events. Leaving a field empty means no callback will be sent for that event.



Available client callback events

Payments & Transactions

Callback EventDescription
User Deposit Status UpdateTriggered when the status of an incoming bank transfer deposit is updated.
User Withdrawal Status UpdateTriggered when the status of a user withdrawal is updated.
Blockchain Withdrawal Status UpdateTriggered when the status of a blockchain withdrawal is updated.
Blockchain Deposit Status UpdateTriggered when the status of a blockchain deposit is updated.
Swap Status UpdateTriggered when the status of a swap transaction is updated.

Accounts

Callback EventDescription
User Bank Account CreatedTriggered when your bank account is created.
User Bank Account Verification Status UpdatedTriggered when the verification status of your bank account is updated.
Virtual Account Status UpdateTriggered when the status of a virtual bank account is updated to enabled or disabled.


Available end customer callback events

Payments & Payout

Callback EventDescription
Bank / PayNow Payout Status UpdateTriggered when the status of a First party / Third party / Regular payout is updated.
Bank / PayNow Payment Status UpdateTriggered when the status of an incoming bank payments / PayNow payments is updated.

Accounts

Callback EventDescription
Customer Profile Bank Account CreatedTriggered when a customer profile bank account is created.
Customer Profile Bank Account Verification Status UpdatedTriggered when the verification status of a customer profile bank account is updated.

Profile Verification & Limits

Callback EventDescription
Customer Profile Verification Status UpdateTriggered when the verification status of a customer profile is updated.
Customer Profile Transaction Limit UpdateTriggered when the transaction limit of a customer profile is updated.
Customer Profile Transaction Limit Update Request Status UpdateTriggered when the status of a transaction limit update request of a customer profile is updated.

Request for Information (RFI)

Callback EventDescription
Request For Information (RFI)Triggered when StraitsX requires more information during onboarding and transaction approval.


Configuring via API

You can also register callback URLs programmatically using the PATCH /webhooks endpoint:

📘

Only the events you include will be updated — others remain unchanged.



Did this page help you?