STstraitsx

Add Funds to Cards Sub-Wallet

Changed on

[Available in Production/Sandbox environment] Transfer funds from the merchant's main wallet to their Cards sub-wallet. Supports same-currency transfers and fiat-to-stablecoin 1:1 conversions.

post/sub-wallets/cards-settlement/transfers

Request

  • Base URL
    https://api-sandbox.straitsx.com/v1
  • URL
    https://api-sandbox.straitsx.com/v1/sub-wallets/cards-settlement/transfers
  • Auth
    API key in header X-XFERS-APP-API-KEY

Headers

X-XFERS-APP-API-KEYstring required

You can retrieve this from your Dashboard Developer Tools.<br><br><strong>Note:</strong> 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-IDstring

The Key ID, can be retrieved from your StraitsX Dashboard.<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.

X-TIMESTAMPstring

Current Unix epoch time in seconds. Must be within ±300 seconds of server time.<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.

X-NONCEstring

A unique UUID string per request, used for replay protection. Must not be reused within the timestamp window.<br>Regex: /\A[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\z/i<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.

X-SIGNATUREstring

Base64-encoded digital signature of the canonical request string.<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.

Request body

Response

201

Example response

{
  "data": {
    "type": "subWalletTransaction",
    "attributes": {
      "transactionType": "add_funds"
    }
  }
}

Changes