---
title: "Create a Payout Method"
method: POST
path: "/api/counterparties/{id}/payout-methods"
tags: ["Payout Methods"]
---

# Create a Payout Method

`POST /api/counterparties/{id}/payout-methods`

Creates a new payout method for a counterparty. This stores the payment details (bank account, blockchain address, etc.) that can be referenced when creating a payout within a payout requests.

## Path parameters

- `id` string, uuid, required

## Headers

- `on-behalf-of` string

## Request body

- CreatePayoutMethodRequestBody
  - `alias` string, required — Internal user-friendly alias name for this payout method
  - `payoutMethod` union, required — The payout method details for this counterparty
    - USDPayoutMethod
      - `details` union, required
        - USDDomesticPayoutMethodDetails
          - `accountType` 'CHECKING' | 'SAVINGS', required
          - `bankAccountNumber` string, required
          - `bankName` string, required
          - `bankRoutingNumber` string, required
          - `symbol` 'USD', required
          - `transferType` 'ACH' | 'WIRE', required — Transfer type (ACH or WIRE)
          - `type` 'usdDomestic', required
        - USDPeruPayoutMethodDetails
          - `accountType` 'CHECKING' | 'SAVINGS', required
          - `bankAccountNumber` string, required
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumber` string, required
          - `documentType` 'NATIONAL_ID' | 'PASSPORT' | 'RESIDENT_ID' | 'RUC' | 'TAX_ID', required
          - `symbol` 'USD', required
          - `type` 'usdPeru', required
        - USDChinaPayoutMethodDetails
          - `accountType` 'CHECKING' | 'SAVINGS', required
          - `bankAccountNumber` string, required
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumber` string, required
          - `documentType` 'PASSPORT' | 'TAX_ID' | 'RESIDENT_ID', required
          - `phoneNumber` string, phone, required
          - `swiftBic` string, required
          - `symbol` 'USD', required
          - `type` 'usdChina', required
        - USDPanamaPayoutMethodDetails
          - `accountType` 'CHECKING' | 'SAVINGS', required
          - `bankAccountNumber` string, required
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumber` string, required
          - `documentType` 'NATIONAL_ID' | 'RUC_NIT' | 'PASSPORT' | 'RESIDENT_ID', required
          - `symbol` 'USD', required
          - `type` 'usdPanama', required
        - USDHongKongPayoutMethodDetails
          - `bankAccountNumber` string, required
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `swiftBic` string, required
          - `symbol` 'USD', required
          - `type` 'usdHongKong', required
      - `type` 'usd', required
    - ARSPayoutMethod
      - `details` union, required
        - ARSAliasPayoutMethodDetails
          - `alias` string, required — Alias of the bank account
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumber` string, required
          - `symbol` 'ARS', required
          - `type` 'arsAlias', required
        - ARSAccountNumberPayoutMethodDetails
          - `bankAccountNumber` string, required
          - `bankAccountNumberType` 'CVU' | 'CBU', required — Type of bank account number (CVU or CBU)
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumber` string, required
          - `symbol` 'ARS', required
          - `type` 'arsAccountNumber', required
      - `type` 'ars', required
    - BRLPayoutMethod
      - `details` union, required
        - BRLPixPhonePayoutMethodDetails
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumber` string, required
          - `phoneNumber` string, phone, required — PIX phone number key
          - `symbol` 'BRL', required
          - `type` 'pixPhone', required
        - BRLPixEmailPayoutMethodDetails
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumber` string, required
          - `email` string, email, required — PIX email key
          - `symbol` 'BRL', required
          - `type` 'pixEmail', required
        - BRLPixDocumentPayoutMethodDetails
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumber` string, required — PIX document key (CPF or CNPJ)
          - `symbol` 'BRL', required
          - `type` 'pixDocument', required
        - BRLPixBankAccountPayoutMethodDetails
          - `bankAccountNumber` string, required — PIX bank account key
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumber` string, required
          - `symbol` 'BRL', required
          - `type` 'pixBankAccount', required
        - BRLWirePayoutMethodDetails
          - `accountNumber` string, required
          - `accountType` 'CHECKING' | 'SAVINGS', required
          - `bankBranch` string, required
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumber` string, required
          - `symbol` 'BRL', required
          - `type` 'wire', required
      - `type` 'brl', required
    - COPPayoutMethod
      - `details` union, required
        - COPDomesticPayoutMethodDetails
          - `accountType` 'CHECKING' | 'SAVINGS', required
          - `bankAccountNumber` string, required
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumber` string, required — Identification number of the counterparty. Special characters are not allowed.
          - `documentType` 'NATIONAL_ID' | 'RUC_NIT' | 'PASSPORT' | 'RESIDENT_ID', required — Identification type of the counterparty
          - `phoneNumber` string, phone, required
          - `symbol` 'COP', required
          - `type` 'copDomestic', required
        - COPBreBPayoutMethodDetails
          - `keyValue` string, required — Bre-B key value (alphanumeric identifier like @CB...) registered in the real-time payments network
          - `symbol` 'COP', required
          - `type` 'copBreB', required
      - `type` 'cop', required
    - EURPayoutMethod
      - `details` EURSepaPayoutMethodDetails, required
        - `bankName` string, required
        - `country` string, alpha2 codes, required
        - `iban` string, required
        - `swiftBic` string, required
        - `symbol` 'EUR', required
        - `type` 'eurSepa', required
      - `type` 'eur', required
    - MXNPayoutMethod
      - `details` MXNDomesticPayoutMethodDetails, required
        - `bankAccountNumber` string, required
        - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
        - `symbol` 'MXN', required
        - `type` 'mxnDomestic', required
      - `type` 'mxn', required
    - CLPPayoutMethod
      - `details` CLPDomesticPayoutMethodDetails, required
        - `accountType` 'CHECKING' | 'SAVINGS', required
        - `bankAccountNumber` string, required
        - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
        - `documentNumber` string, required
        - `documentType` 'NATIONAL_ID' | 'PASSPORT' | 'RESIDENT_ID' | 'RUC' | 'TAX_ID', required
        - `symbol` 'CLP', required
        - `type` 'clpDomestic', required
      - `type` 'clp', required
    - PENPayoutMethod
      - `details` PENDomesticPayoutMethodDetails, required
        - `accountType` 'CHECKING' | 'SAVINGS', required
        - `bankAccountNumber` string, required
        - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
        - `documentNumber` string, required
        - `documentType` 'NATIONAL_ID' | 'PASSPORT' | 'RESIDENT_ID' | 'RUC' | 'TAX_ID', required
        - `symbol` 'PEN', required
        - `type` 'penDomestic', required
      - `type` 'pen', required
    - BOBPayoutMethod
      - `details` BOBDomesticPayoutMethodDetails, required
        - `bankAccountNumber` string, required
        - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
        - `documentNumber` string, required
        - `documentType` 'NATIONAL_ID' | 'RUC_NIT' | 'RESIDENT_ID', required
        - `symbol` 'BOB', required
        - `type` 'bobDomestic', required
      - `type` 'bob', required
    - CRCPayoutMethod
      - `details` CRCDomesticPayoutMethodDetails, required
        - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
        - `documentNumber` string, required
        - `documentType` 'NATIONAL_ID' | 'PASSPORT' | 'RESIDENT_ID' | 'RUC' | 'TAX_ID', required
        - `iban` string, required
        - `symbol` 'CRC', required
        - `type` 'crcDomestic', required
      - `type` 'crc', required
    - ZARPayoutMethod
      - `details` ZARDomesticPayoutMethodDetails, required
        - `accountType` 'CHECKING' | 'SAVINGS', required
        - `bankAccountNumber` string, required
        - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
        - `symbol` 'ZAR', required
        - `type` 'zarDomestic', required
      - `type` 'zar', required
    - BlockchainPayoutMethodDetails
      - `blockchain` 'ETHEREUM' | 'POLYGON' | 'BASE' | 'CELO' | 'PLASMA' | 'SOLANA', required — The blockchain network. SOLANA is accepted only for USD payouts.
      - `type` 'blockchainWallet', required
      - `walletAddress` string, required — The wallet address for blockchain payouts. EVM (0x-prefixed hex) or Solana (base58-encoded 32-byte pubkey), matching the blockchain value.

## Response `201`

The successfully created payout method

- PayoutMethodResponse
  - `alias` string, required — Internal user-friendly alias name for this payout method
  - `counterpartyId` string, uuid, required — ID of the counterparty this payout method belongs to
  - `createdAt` string, date-time, required — Timestamp when the payout method was created
  - `id` string, uuid, required — Unique identifier for the payout method
  - `payoutMethod` union, required — Payout method details including type and payment information
    - USDPayoutMethodInfo
      - `details` union, required
        - USDDomesticPayoutMethodResponseDetails
          - `accountType` 'CHECKING' | 'SAVINGS', required
          - `bankAccountNumberTruncated` string, required — Masked bank account number (format: ****1234)
          - `bankName` string, required
          - `bankRoutingNumberTruncated` string, required — Masked bank routing number (format: ****1234)
          - `symbol` 'USD', required
          - `transferType` 'ACH' | 'WIRE', required — Transfer type (ACH or WIRE)
          - `type` 'usdDomestic', required
        - USDPeruPayoutMethodResponseDetails
          - `accountType` 'CHECKING' | 'SAVINGS', required
          - `bankAccountNumberTruncated` string, required — Masked bank account number (format: ****1234)
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
          - `documentType` 'NATIONAL_ID' | 'PASSPORT' | 'RESIDENT_ID' | 'RUC' | 'TAX_ID', required
          - `symbol` 'USD', required
          - `type` 'usdPeru', required
        - USDChinaPayoutMethodResponseDetails
          - `accountType` 'CHECKING' | 'SAVINGS', required
          - `bankAccountNumberTruncated` string, required — Masked bank account number (format: ****1234)
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
          - `documentType` 'PASSPORT' | 'TAX_ID' | 'RESIDENT_ID', required
          - `phoneNumberTruncated` string, required — Masked phone number (format: ****1234)
          - `swiftBicTruncated` string, required — Masked SWIFT/BIC code (format: ****1234)
          - `symbol` 'USD', required
          - `type` 'usdChina', required
        - USDPanamaPayoutMethodResponseDetails
          - `accountType` 'CHECKING' | 'SAVINGS', required
          - `bankAccountNumberTruncated` string, required — Masked bank account number (format: ****1234)
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
          - `documentType` 'NATIONAL_ID' | 'RUC_NIT' | 'PASSPORT' | 'RESIDENT_ID', required
          - `symbol` 'USD', required
          - `type` 'usdPanama', required
        - USDHongKongPayoutMethodResponseDetails
          - `bankAccountNumberTruncated` string, required — Masked bank account number (format: ****1234)
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `swiftBicTruncated` string, required — Masked SWIFT/BIC code (format: ****ABCD)
          - `symbol` 'USD', required
          - `type` 'usdHongKong', required
      - `type` 'usd', required
    - ARSPayoutMethodInfo
      - `details` union, required
        - ARSAliasPayoutMethodResponseDetails
          - `aliasTruncated` string, required — Masked bank account alias (format: ****1234)
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
          - `symbol` 'ARS', required
          - `type` 'arsAlias', required
        - ARSAccountNumberPayoutMethodResponseDetails
          - `bankAccountNumberTruncated` string, required — Masked bank account number (format: ****1234)
          - `bankAccountNumberType` 'CVU' | 'CBU', required — Type of bank account number (CVU or CBU)
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
          - `symbol` 'ARS', required
          - `type` 'arsAccountNumber', required
      - `type` 'ars', required
    - BRLPayoutMethodInfo
      - `details` union, required
        - BRLPixPhonePayoutMethodResponseDetails
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
          - `phoneNumberTruncated` string, required — Masked phone number (format: ****1234)
          - `symbol` 'BRL', required
          - `type` 'pixPhone', required
        - BRLPixEmailPayoutMethodResponseDetails
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
          - `emailTruncated` string, required — Masked email (format: ****1234)
          - `symbol` 'BRL', required
          - `type` 'pixEmail', required
        - BRLPixDocumentPayoutMethodResponseDetails
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
          - `symbol` 'BRL', required
          - `type` 'pixDocument', required
        - BRLPixBankAccountPayoutMethodResponseDetails
          - `bankAccountNumberTruncated` string, required — Masked bank account number (format: ****1234)
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
          - `symbol` 'BRL', required
          - `type` 'pixBankAccount', required
        - BRLWirePayoutMethodResponseDetails
          - `accountNumberTruncated` string, required — Masked account number (format: ****1234)
          - `accountType` 'CHECKING' | 'SAVINGS', required
          - `bankBranchTruncated` string, required — Masked bank branch (format: ****1234)
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
          - `symbol` 'BRL', required
          - `type` 'wire', required
      - `type` 'brl', required
    - COPPayoutMethodInfo
      - `details` union, required
        - COPDomesticPayoutMethodResponseDetails
          - `accountType` 'CHECKING' | 'SAVINGS', required
          - `bankAccountNumberTruncated` string, required — Masked bank account number (format: ****1234)
          - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
          - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
          - `documentType` 'NATIONAL_ID' | 'RUC_NIT' | 'PASSPORT' | 'RESIDENT_ID', required
          - `phoneNumberTruncated` string, required — Masked phone number (format: ****1234)
          - `symbol` 'COP', required
          - `type` 'copDomestic', required
        - COPBreBPayoutMethodResponseDetails
          - `keyValueTruncated` string, required — Masked Bre-B key value (format: ****1234)
          - `symbol` 'COP', required
          - `type` 'copBreB', required
      - `type` 'cop', required
    - EURPayoutMethodInfo
      - `details` EURSepaPayoutMethodResponseDetails, required
        - `bankName` string, required
        - `country` string, alpha2 codes, required
        - `ibanTruncated` string, required — Masked IBAN (format: ****1234)
        - `swiftBicTruncated` string, required — Masked SWIFT/BIC code (format: ****1234)
        - `symbol` 'EUR', required
        - `type` 'eurSepa', required
      - `type` 'eur', required
    - MXNPayoutMethodInfo
      - `details` MXNDomesticPayoutMethodResponseDetails, required
        - `bankAccountNumberTruncated` string, required — Masked bank account number (format: ****1234)
        - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
        - `symbol` 'MXN', required
        - `type` 'mxnDomestic', required
      - `type` 'mxn', required
    - CLPPayoutMethodInfo
      - `details` CLPDomesticPayoutMethodResponseDetails, required
        - `accountType` 'CHECKING' | 'SAVINGS', required
        - `bankAccountNumberTruncated` string, required — Masked bank account number (format: ****1234)
        - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
        - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
        - `documentType` 'NATIONAL_ID' | 'PASSPORT' | 'RESIDENT_ID' | 'RUC' | 'TAX_ID', required
        - `symbol` 'CLP', required
        - `type` 'clpDomestic', required
      - `type` 'clp', required
    - PENPayoutMethodInfo
      - `details` PENDomesticPayoutMethodResponseDetails, required
        - `accountType` 'CHECKING' | 'SAVINGS', required
        - `bankAccountNumberTruncated` string, required — Masked bank account number (format: ****1234)
        - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
        - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
        - `documentType` 'NATIONAL_ID' | 'PASSPORT' | 'RESIDENT_ID' | 'RUC' | 'TAX_ID', required
        - `symbol` 'PEN', required
        - `type` 'penDomestic', required
      - `type` 'pen', required
    - BOBPayoutMethodInfo
      - `details` BOBDomesticPayoutMethodResponseDetails, required
        - `bankAccountNumberTruncated` string, required — Masked bank account number (format: ****1234)
        - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
        - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
        - `documentType` 'NATIONAL_ID' | 'RUC_NIT' | 'RESIDENT_ID', required
        - `symbol` 'BOB', required
        - `type` 'bobDomestic', required
      - `type` 'bob', required
    - CRCPayoutMethodInfo
      - `details` CRCDomesticPayoutMethodResponseDetails, required
        - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
        - `documentNumberTruncated` string, required — Masked document number (format: ****1234)
        - `documentType` 'NATIONAL_ID' | 'PASSPORT' | 'RESIDENT_ID' | 'RUC' | 'TAX_ID', required
        - `ibanTruncated` string, required — Masked IBAN (format: ****1234)
        - `symbol` 'CRC', required
        - `type` 'crcDomestic', required
      - `type` 'crc', required
    - ZARPayoutMethodInfo
      - `details` ZARDomesticPayoutMethodResponseDetails, required
        - `accountType` 'CHECKING' | 'SAVINGS', required
        - `bankAccountNumberTruncated` string, required — Masked bank account number (format: ****1234)
        - `bankId` string, required — Bank ID from the /counterparties/payment-methods/supported-banks endpoint
        - `symbol` 'ZAR', required
        - `type` 'zarDomestic', required
      - `type` 'zar', required
    - BlockchainPayoutMethodInfo
      - `details` BlockchainPayoutMethodResponseDetails, required
        - `blockchain` 'ETHEREUM' | 'POLYGON' | 'BASE' | 'CELO' | 'PLASMA' | 'SOLANA', required — The blockchain network. SOLANA is only returned for wallets registered on the USD payout path.
        - `walletAddress` string, required — The wallet address for blockchain payouts
      - `type` 'blockchainWallet', required

## Other responses

- `400` — AdditionalCounterpartyInformationRequired
- `401` — Unauthorized
- `403` — SignedAgreementRequiredException

---

[API](https://skmtc.net/muralpay/apis/mural-api.md) · [All operations](https://skmtc.net/muralpay/apis/mural-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/muralpay/mural-api/versions/437d277f5948/schema)