We released a new endpoint GET /v1/payout-recipients/requirements that allows you to query for the recipient's data requirements depending on the recipient's country, currency, the disbursement method, the proxy type (when disbursement method is paynow) and the entity type. The data requirements are returned in regex and you can apply the same validation on your platforms to support recipient creation.

Note that if you are using the regex in a programming language that requires double backslashes (like Ruby or Java), then the response is already the correct regex. However, if you are using it directly in a regex engine (like JavaScript or Python), you would need to replace the double backslashes \\ with single backslash \.

For added convenience, you can now also query and update webhooks for the various supported events directly via the following endpoints:

  • GET /v1/webhooks
  • PATCH /v1/webhooks

Updating webhooks via the StraitsX dashboard continues to be available to you.

When creating a payout recipient via POST /payout-recipients you now also have to pass in the following required fields:

  • recipientInformation.entityType
  • recipientInformation.currency

We now also support creating a SWIFT payout recipient (with additional required fields) to allow for payouts in USD.

For more information, check out the API reference here.

We are excited to announce that we now support passing in purpose code for all SGD withdrawals and payouts via FAST. This field is optional and will be defaulted to OTHR (Others) if omitted. Full list of supported purpose codes can be found here.

Enhanced Endpoints:

  • POST /customer_profile/{customer_profile_id}/withdrawals
  • POST /customer_profile/{customer_profile_id}/payouts
  • POST /payouts

StraitsX API v1.1.0

by Lim Zi Xuan

We’re thrilled to announce the launch of StraitsX API v1.1.0, a new version that introduces the highly requested third party and regular transfers capabilities to our API suite. With this release, we now officially support three different integration models, depending on your business profile and requirements:

Detailed integration flows are now included in the revamped Guides section and all relevant endpoints have been updated in the API Reference section. If you are unsure or need clarification, contact us.


Other changes

  • We have made some underlying improvements on how we handle FX rates and network fee estimation for our Blockchain and Swap API and removed the rate limit error on these endpoints
  • Added two optional fields for POST /v1/customer_profile/{customer_profile_id}/withdrawals to support overseas withdrawals:
    • routing_code: Maximum 31 char alphanumeric
    • intermediary_swift_bic: Maximum 11 char alphanumeric

We now support two more swap pairs on our Swap API! You can now access the following swap pairs:

  • XSGDXUSD
  • XSGDUSDC
  • XUSDUSDC
  • USDCUSDT

We have released a new endpoint for you to get your account statement and ledger for easy reconciliation. This endpoint will return all ledger items as well as the opening and closing balance of the queried period.

See the API reference here: Account Statement

Added a new endpoint: GET List of Payments for a Customer Profile v2

  • GET /customer_profile/{customer_profile_id}/payments

Modified response of sandbox endpoint:

  • POST /sandbox/paynow_simulations now returns contract data instead of just success

Added the following sandbox endpoints:

  • Update status of a mock bank transfer/PayNow payment: PUT /v1/sandbox/customer_profile/{customer_profile_id}/payments/{contract_id}
  • Create blockchain address: POST /v1/sandbox/blockchain_transfer/addresses
  • Mock verification status of blockchain address: POST /v1/sandbox/blockchain_transfer/addresses/{blockchain_address_id}
  • Mock status of blockchain withdrawal: PUT /v1/sandbox/blockchain_transfer/withdrawals/{contract_id}

We are excited to announce that we have officially moved to the latest API host (live since March 2024). If you are new to StraitsX API, please integrate using the latest host (api-sandbox.straitsx.com and api.straitsx.com). This marks an important step for StraitsX in terms of the streamlining of our API offering. You can also look forward to v2 (scheduled for release in 2024H2), where we will revamp and align all endpoint requests and responses, as well as rolling out various updates including error handling and consolidation of endpoints.

For existing partners, we will continue to support the old host (xfers.io) until further notice, so there's nothing you need to do now. However, we strongly encourage you to switch over to the latest host whenever possible. If you require any support, feel free to reach out to us directly.