Create a customer profile bank account

post

https://api-sandbox.straitsx.com/v1/customer_profile/{customer_profile_id}/bank_accounts

[Available in Sandbox/Production environment] Add a bank account for a customer profile

Path Params

customer_profile_id

string

required

Customer Profile ID is retrieved from the response id of Create Customer Profile API
Regex: /^\s*.{1,191}\s*$/

Body Params

account_no

string

required

Bank account number
Bank account length: Between 5 - 34
Regex: /^[a-zA-Z0-9\-]{5,34}$/

bank

string

Only required for FAST
SG Bank account abbreviation (abbreviation) can be retrieved from Get a list of supported banks API
Regex: /^\s*.{1,191}\s*$/

swift_bic

string

SWIFT code of the bank account
Required field if you are doing SWIFT payments
Regex: /^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$/

intermediary_swift_bic

string

Intermediary SWIFT code if applicable(Must be alphanumeric with 11 characters)
Regex: /^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$/

routing_code

string

Routing code if applicable(Must be alphanumeric with maximum 31 characters)
Regex: /^[A-Z0-9]{1,31}$/

account_holder_name

string

required

Name of bank account holder(The length must be within 191 characters)
Regex: /^\s*.{1,191}\s*$/

bank_account_proof

object

required

Must have either fileData or fileUrl

payment_reason

string

Payment reason is a field used to pass clear, specific instructions to the receiving bank.
Length: 1 - 150 characters (Non-blank)
Regex: /^\s*.{1,150}\s*$/

Note: This value will override the default Remittance Information (MT103 Field 70 / pacs.008) in the final payment message sent to the bank when provided.

Headers

X-XFERS-APP-API-KEY

string

required

You can retrieve this from your Dashboard Developer Tools.

Note: The X-XFERS-APP-API-KEY is a mandatory header for all authentication methods, including standard API key usage and HTTP Request Signing mode.

X-PUBLIC-KEY-ID

string

The Key ID, can be retrieved from your StraitsX Dashboard.

Note: This header attribute is required when HTTP Request Signing is enabled for your account.

X-TIMESTAMP

string

Current Unix epoch time in seconds. Must be within ±300 seconds of server time.

Note: This header attribute is required when HTTP Request Signing is enabled for your account.

X-NONCE

string

A unique UUID string per request, used for replay protection. Must not be reused within the timestamp window.
Regex: /\A[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\z/i

Note: This header attribute is required when HTTP Request Signing is enabled for your account.

X-SIGNATURE

string

Base64-encoded digital signature of the canonical request string.

Note: This header attribute is required when HTTP Request Signing is enabled for your account.

Responses

200200

400400