# Create a new payout

Endpoint: POST /payouts
Version: 1.0.0
Security: JWT

## Request fields (application/json):

  - `source_currency` (string, required)
    The currency from which you want the amount to be deducted from source balance.
    Example: "USD"

  - `source_amount` (number)
    The amount you intend to send, also specified in the smallest unit of the selected currency. For example, 1000 equates to $10.00 in USD. The currency field determines which currency is used. As with destination_amount, "cents" is a placeholder for the minimal unit, not specifically USD.
    Example: 1000

  - `destination_currency` (string, required)
    The currency in which recipient will receive the payout. The currency code should be in  [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, USD.
    Example: "USD"

  - `destination_amount` (number)
    The amount the beneficiary will receive, expressed in the smallest unit of the specified currency (e.g., cents for USD, paisa for INR).  For example, 1000 represents $10.00 in USD. The actual currency is determined by the currency field. Note: "cents" is used generically to denote  the minimal currency unit, not necessarily USD.
    Example: 1000

  - `beneficiary_id` (string, required)
    The unique identifier for the beneficiary.
    Example: "bene_5JU9yv0lGSUP"

  - `purpose_code` (string, required)
    Purpose code for why you want to receive this payment
    Example: "S0017"

  - `documents` (array, required)
    List of documents to attach to the payout
    Example: ["doc_5JU9yv0lGSUP","doc_678a5aa9SKkEr"]

## Response 201 fields (application/json):

  - `id` (string)
    The unique identifier for the payin.
    Example: "payout_DdWp_HUbOnlg"

  - `status` (string)
    The status of the payout.
    Example: "success"

  - `destination_amount` (number)
    The amount the beneficiary will receive, expressed in the smallest unit of the specified currency (e.g., cents for USD, paisa for INR). 
      For example, 1000 represents $10.00 in USD. The actual currency is determined by the currency field. Note: "cents" is used generically to denote 
      the minimal currency unit, not necessarily USD.
    Example: 1000

  - `destination_currency` (string)
    The currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, USD.
    Example: "USD"

  - `source_amount` (number)
    The amount you intend to send, also specified in the smallest unit of the selected currency. For example, 1000 equates to $10.00 in USD. The currency field determines which currency is used. As with destination_amount, "cents" is a placeholder for the minimal unit, not specifically USD.
    Example: 1000

  - `source_currency` (string)
    The currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, USD.
    Example: "USD"

  - `beneficiary_id` (string)
    The unique identifier for the beneficiary.
    Example: "bene_5JU9yv0lGSUP"

  - `documents` (array)
    The attached documents for the payout.

  - `documents.id` (string)
    The unique identifier for the Document.
    Example: "doc_nYUqLpuYQ0M8"

  - `documents.type` (string)
    The type of the Document.
    Example: "invoice"

  - `documents.status` (string)
    Enum: "pending", "uploaded", "rejected", "approved"

  - `documents.rfi_doc_id` (string,null)
    The unique identifier for the RFI Document. This will be null if the document is not an RFI Document.
    Example: "rfidoc_nYUqLpuYQ0M8"

  - `purpose_code` (string)
    Purpose code for why you want to receive this payment
    Example: "S0017"

  - `mid_market_rate` (number)
    The mid-market rate at the time of payout creation.
    Example: 1

  - `fees` (object)
    The fees applied to this payout

  - `fees.fx` (object)
    The foreign exchange fees applied to the payout

  - `fees.fx.currency` (string)
    The currency code for the FX fee
    Example: "USD"

  - `fees.fx.amount` (number)
    The amount of the FX fee
    Example: 200

  - `fees.transaction` (object)
    The transaction fees applied to the payout

  - `fees.transaction.currency` (string)
    The currency code for the transaction fee
    Example: "USD"

  - `fees.transaction.amount` (number)
    The amount of the transaction fee
    Example: 100

  - `created_at` (string)
    Timestamp representing when the payout was created
    Example: "2021-06-01T12:00:00Z"

  - `updated_at` (string)
    Timestamp representing when the payout was last updated
    Example: "2021-06-01T12:00:00Z"