---
title: "Create payout recipient"
method: POST
path: "/fx/payout-recipients"
---

# Create payout recipient

`POST /fx/payout-recipients`

## Request

- Base URL: `https://api-sandbox.straitsx.com/v1`
- URL: `https://api-sandbox.straitsx.com/v1/fx/payout-recipients`
- Auth: API key in header `X-XFERS-APP-API-KEY`

Create a new payout recipient for FX payouts.

## Headers

- `X-XFERS-APP-API-KEY` string, required
- `X-PUBLIC-KEY-ID` string
- `X-TIMESTAMP` string
- `X-NONCE` string
- `X-SIGNATURE` string

## Request body

- object
  - `data` object
    - `attributes` object
      - `initiator` object: Optional. If omitted, defaults to the authenticated user (self). Provide to act on behalf of a customer profile.
        - `mode` string: Currently only `onBehalfOf`.
        - `customerProfileId` string: UUID of the customer profile.
      - `recipientCountry` string, required: ISO 3166 alpha-2 country code (e.g. `ID` for Indonesia).
      - `recipientInformation` object, required
        - `disbursementMethod` string, required: Currently only `bankTransfer`.
        - `entityType` string, required: One of: `individual`, `business`.
        - `recipientName` string, required: Name of the recipient.<br>Length: Max 255 characters.
        - `currency` string, required: Currently only `IDR`.
        - `bankAccountNo` string, required: Bank account number.<br>Regex: `/^[a-zA-Z0-9\-]{5,34}$/`
        - `swiftBic` string, required: SWIFT/BIC code of the recipient bank.<br>Regex: `/^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$/`<br><br><strong>Note:</strong> Must be uppercase.
        - `bankAccountProofUrl` string: URL to the bank account proof document.<br>Must be a valid HTTP or HTTPS URL.

## Response `201`

201

- object
  - `data` object
    - `id` string: Payout recipient ID.
    - `type` string: Resource type. Always `fxPayoutRecipient`.
    - `attributes` object
      - `initiator` object: Initiator information. Present when acting on behalf of a customer profile.
        - `mode` string: Initiator mode. Currently only `onBehalfOf`.
        - `customerProfileId` string: UUID of the customer profile.
      - `verificationStatus` string: Bank account verification status. One of: `pending`, `verified`, `rejected`.
      - `recipientCountry` string: ISO 3166 alpha-2 country code.
      - `recipientInformation` object: Recipient information.
        - `disbursementMethod` string: Disbursement method used to send funds.
        - `entityType` string: Recipient entity type. One of: `individual`, `business`.
        - `recipientName` string: Name of the recipient.
        - `currency` string: Currency for the transfer.
        - `bankAccountNo` string: Recipient's bank account number.
        - `bankShortCode` string: Numeric bank code (e.g. `009` for BNI, `014` for BCA). Auto-populated from swiftBic.
        - `swiftBic` string: SWIFT/BIC code of the recipient bank.
        - `bankName` string: Name of the recipient bank.
      - `createdAt` string: Timestamp when the recipient was created (ISO 8601, Singapore timezone).
      - `updatedAt` string: Timestamp when the recipient was last updated (ISO 8601, Singapore timezone).

## Other responses

- `400`: Bad Request
- `422`: Unprocessable Entity

## Changes

- **2026-11-03** `d17239d67150`: 1 info
  - the request property `data/attributes/recipientInformation/bankAccountProofUrl` became optional

[Operation history](https://skmtc.dev/straitsx/apis/straitsx-sandbox-base-url/changes/fx/payout-recipients/post.md)

---

[API](https://skmtc.dev/straitsx/apis/straitsx-sandbox-base-url.md) - [All operations](https://skmtc.dev/straitsx/apis/straitsx-sandbox-base-url/llms.txt) - [OpenAPI document](https://skmtc.dev/straitsx/apis/straitsx-sandbox-base-url/revisions/d17239d67150?raw)