2 letters e.g. Egypt: “EG”
See “Country\_code & currency\_code list” below.
| | purpose | string | Yes | Purpose of the payout |Enum:
“revenue\_share”,
“salaries”,
“payment\_for\_suppliers”
Pakistan: Influencer payments should be reported as “revenue\_share”. These will be charged withholding tax.
| | reference | string | No | This is a reference you wish to attach to the payout. It will be displayed to the beneficiary if the payment method used allows it. |This is a free text field.
Max 255 char
| | request\_id | string | Yes | A unique request ID that is attached to the payout request, created by Merchant. **Please note that this has to be idempotent**. | Only allow alphanumeric characters, hyphen “-”, and underscore “\_” | ### **amount** | Parameter | Type | Required | Description | Validation | | -------------- | ------ | -------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | | value | number | Yes | Request amount – total requested payout amount. | Max decimal place: 2 | | currency\_code | string | Yes |Request currency – currency of the request amount.
3-letter currency code ISO 4217.
|3 letters e.g. EGP
See “Country\_code & currency\_code list” below.
| ### **payout\_method** | Parameter | Type | Required | Description | Validation | | --------------- | ------ | -------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | string | Yes | Payout method used | Enum: ”bank\_transfer”, “wallet” | | payment\_method | string | Yes | Payment method used |One of the payment methods supported.
See “Country details” below for supported methods in each country.
| | beneficiary | Object | Yes | Details of the beneficiary | See beneficiary details below | ### **beneficiary** | Parameter | Type | Required | Description | Validation | | ----------------------- | ------ | -------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | | name | string | Yes | Recipient’s full name | Max 255 char | | payout\_method\_details | Object | Yes | Details on the recipient’s account for the specified payment channel. | See “[Country details](broken://pages/rsGLjgDb73MoKkdoUCPG)” below for supported methods in each country. | Depending on the payment channel you want to use to send the payout to the beneficiary, the “payout\_method\_details” object would be named differently and have different mandatory fields. You can find below the list of payment channels supported and the mandatory fields for each. ### **Response parameters** | Parameter | Description | | --------------------- | --------------------------------------------------------------------------------------------------------------------------- | | payout\_method.type | Country code + the Payout method used, passed in the request | | amount.value | Request amount – total requested payout amount. Passed in the API request. | | amount.currency\_code |Request currency – currency of the request amount.
3-letter currency code ISO 4217, passed in the API request.
| | country\_code |Country of payout.
2-letter country code ISO 3166, passed in the API request
| | purpose | Purpose of payout, passed in the API request | | reference | Free text, passed in the API request | | request\_id | A unique request ID that is attached to the payout request, created by Merchant. Passed in the API request. | | due\_date | As passed in the API request | | id | Coda payout transaction id: string | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.coda.co/payout/integration-guides/api-reference/initiate-a-payout-request.md?ask=