v1

latestOpenAPI 3.0.02026-08-04134348905.1 KB

Subaccounts

Create a USD Withdrawal Request for a subaccount

Permissions required: Subaccount

Creates a USD Withdrawal Request for an Asset within a Subaccount (FIAT only for now)

This will trigger an e-mail to be sent to the program customer to authorize the withdrawal.

post/subaccounts/{subaccountId}/fiat/withdrawals

Path parameters

subaccountIdstring required

Unique Identifier for the subaccount

Headers

Api-Signaturestring required

A hex-encoded Ed25519 signature of timestamp_epoch_seconds + uppercase(http_method) + request_path + request_body.

Construction example:


toHex(

	ed25519Sign( 	signing_key, 	'{}{}{}{}'.format(timestamp_epoch_seconds, toUpper(httpMethod), httpRequestPath, httpBody) 	) )

Api-Timestampinteger required

Current timestamp, represented as unix epoch seconds

Request body

Example request

{
  "asset": {
    "assetType": "USD",
    "amount": "10.01"
  },
  "customerDetails": {
    "beneficiary": {
      "name": "John Doe",
      "accountNumber": "123",
      "address": {
        "address": "123 Main Street",
        "city": "Windsor",
        "state": "Iowa",
        "zipcode": "12312"
      }
    },
    "financialInstitution": {
      "address": {
        "address": "123",
        "address2": "123",
        "city": "123",
        "zipcode": "123",
        "state": "123"
      },
      "name": "name",
      "id": "123",
      "code": "ABA"
    },
    "memo": "12312312"
  }
}

Response

The ID of the created Transaction

Example response

{
  "data": {
    "transactionId": "c4c4652f-0c07-472c-a7f8-955fbe07775d"
  }
}