---
title: "Create a payout transaction"
method: POST
path: "/payments/transactions/payout"
tags: ["Transactions"]
---

# Create a payout transaction

`POST /payments/transactions/payout`

Use this endpoint to create a payout transaction. You can find sample code in our public Postman collection, or build it in the adjacent API explorer. The link to our postman collection is: [https://www.postman.com/meldeng/workspace/meld-io-public-api-collection](https://www.postman.com/meldeng/workspace/meld-io-public-api-collection)

**IDEMPOTENT REQUESTS**: Please refer to [Idempotency Key](https://docs.meld.io/docs/idempotency-key)

**ERRORS**: Please refer to [Error Responses](https://docs.meld.io/docs/fiat-error-responses)

## Headers

- `X-Idempotency-Key` string, uuid

## Request body

- PayoutTransactionRequest
  - `customerId` string — Meld's internal Id for the Customer
  - `description` string — A description about the transaction
  - `externalCustomerId` string — Your (optional) Id for this customer, for example an id or reference from your database which you may supply during customer creation
  - `paymentMethod` PaymentMethodInput — PaymentMethod objects represent your customer's payment instruments
    - `details` union, required — [Details of the payment method used for this transaction](https://docs.meld.io/docs/payment-methods-and-tokenization)
      - object — Credit card details
        - `cvc` string, required — Card CVC
        - `expiration` CardExpiration
          - `month` integer — Integer value for the expiration month
          - `year` integer — Integer value for the expiration year
        - `name` string — The cardholder's name
        - `number` string, required — Card number
      - object — ACH details
        - `accountNumber` string, required — Account number
        - `accountType` 'BUSINESS_CHECKING' | 'CHECKING' | 'SAVINGS', required — Bank account type
        - `name` Name
          - `firstName` string, required
          - `lastName` string, required
        - `routingNumber` string, required — Routing number
      - object — Meld payment token details
        - `meldPaymentToken` string, required — Meld Payment Token
    - `type` 'ACH' | 'CARD' | 'MELD_PAYMENT_TOKEN' | 'PLAID_TRANSFER_AUTHORIZATION', required — Payment method type used for this transaction, some methods may only apply for some providers, e.g. PLAID_TRANSFER_AUTHORIZATION for PLAID
  - `serviceProvider` 'ACROSS' | 'AEROPAY' | 'AKOYA' | 'ALCHEMYPAY' | 'APPLEPAY' | 'AUTHORIZENET' | 'BANXA' | 'BILIRA' | 'BINANCECONNECT' | 'BINANCEPAY' | 'BLOCKCHAINDOTCOM' | 'BOOMFI' | 'BRAINTREE' | 'BRALE' | 'BTCDIRECT' | 'CASHAPP' | 'CHECKOUT' | 'CIRCLE' | 'COINBASEPAY' | 'COINFLOW' | 'DUENETWORK' | 'ELDORADO' | 'FINICITY' | 'FLASHNET' | 'FONBNK' | 'GUARDARIAN' | 'HARBOUR' | 'KOYWE' | 'KRYPTONIM' | 'MERCURYO' | 'MESH' | 'MESO' | 'MOONPAY' | 'MOOV' | 'MX' | 'NMI' | 'NOAH' | 'ONMETA' | 'ONRAMPMONEY' | 'PAYBIS' | 'PAYPAL' | 'PLAID' | 'RAMP' | 'REVOLUT' | 'ROBINHOOD' | 'ROUTERPROTOCOL' | 'SALTEDGE' | 'SALTEDGEPARTNERS' | 'SARDINE' | 'SHIFT4' | 'SHOPIFY' | 'SIMPLEX' | 'SKRILLCRYPTO' | 'SQUARE' | 'STRIPE' | 'SUMSUB' | 'SWAPPED' | 'TANGOCARD' | 'TELLER' | 'TOPPER' | 'TRANSAK' | 'TREMENDOUS' | 'TRANSFI' | 'UNLIMIT' | 'WYRE' | 'XANPOOL' | 'YELLOWCARD' | 'YODLEE' — The service provider used for this transaction.
  - `serviceProviderDetails` object — Provider specific details which may can be provided for this transaction, if supported by the Service Provider.
  - `sourceAmount` string, required — Amount intended to be sent by this payout
  - `sourceCurrencyCode` string, required — Three-letter ISO currency code, in lowercase. Must be a supported currency

## Response `201`

Payout transaction created successfully

## Other responses

- `400` — Bad Request : check request values and format
- `401` — Invalid credentials
- `403` — Unauthenticated or authenticated with insufficient access
- `425` — It is too early for a retry
- `500` — Internal Error

---

[API](https://skmtc.net/meld/apis/bank-linking.md) · [All operations](https://skmtc.net/meld/apis/bank-linking/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meld/bank-linking/revisions/818d6079a611/schema)