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

# Create payout recipient

`POST /fx/payout-recipients`

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, required — 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

---

[API](https://skmtc.net/straitsx/apis/straitsx-sandbox-base-url.md) · [All operations](https://skmtc.net/straitsx/apis/straitsx-sandbox-base-url/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/straitsx/straitsx-sandbox-base-url/versions/9ceee2969aeb/schema)