> For the complete documentation index, see [llms.txt](https://yogupay.gitbook.io/yogupay-payout-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yogupay.gitbook.io/yogupay-payout-api/payouts/payout-latam.md).

# Payout LATAM

{% hint style="info" %}
This endpoint assumes that you already have completed the process of account creation and that you have either a valid access token. If you have not completed this step, please review the guide that applies to your connection type.
{% endhint %}

## Create a LATAM Payout

<mark style="color:green;">`POST`</mark> `/payout`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |
| token        | `<token>`          |

**Body**

<table><thead><tr><th width="227">Name</th><th width="96">Type</th><th>Description</th></tr></thead><tbody><tr><td>collection_network<mark style="color:red;">*</mark></td><td>string</td><td>The <a data-footnote-ref href="#user-content-fn-1">Collection Network</a> used</td></tr><tr><td>recipient_name<mark style="color:red;">*</mark></td><td>string</td><td>The name of the recipient.</td></tr><tr><td>bank_account_number<mark style="color:red;">*</mark></td><td>string</td><td>The bank account number of the recipient.</td></tr><tr><td>msisdn</td><td>string</td><td>The mobile number of the recipient.</td></tr><tr><td>dest_currency<mark style="color:red;">*</mark></td><td>string</td><td>The currency in which the recipient will receive the funds.</td></tr><tr><td>dest_amount<mark style="color:red;">*</mark></td><td>number</td><td>The amount the recipient will receive .</td></tr><tr><td>purpose_of_funds<mark style="color:red;">*</mark></td><td>string</td><td>The purpose of the funds transfer</td></tr><tr><td>country_code<mark style="color:red;">*</mark></td><td>string</td><td>The country code of the recipient.</td></tr><tr><td>reference_number<mark style="color:red;">*</mark></td><td>string</td><td>A reference unique to your system</td></tr><tr><td>bank_code<mark style="color:red;">*</mark></td><td>string</td><td>The <a data-footnote-ref href="#user-content-fn-2">bank code</a> of the recipient's bank</td></tr><tr><td>recipient_email</td><td>string</td><td>The email address of the recipient.</td></tr><tr><td>account_type<mark style="color:red;">*</mark></td><td>string</td><td>The <a data-footnote-ref href="#user-content-fn-3">type</a> of Account </td></tr><tr><td>document_type<mark style="color:red;">*</mark></td><td>string</td><td>The type of document used for Identification<br></td></tr><tr><td>document_id<mark style="color:red;">*</mark></td><td>string</td><td>The recipients Document ID</td></tr><tr><td>bank_name<mark style="color:red;">*</mark></td><td>string</td><td>The name of the recipients Bank</td></tr><tr><td>branch_code</td><td>string</td><td>The Branch Code of the Recipients Bank</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="Request" %}

```json
curl --location 'https://api.tumapay.com/payout' \
--header 'token: <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "collection_network": "LATAM",
    "recipient_name": "John Doe",
    "bank_account_number": "01234567898765432",
    "msisdn": 702423791,
    "dest_currency": "MXN",
    "purpose_of_funds": "Fee payment",
    "country_code": "MEX",
    "reference_number": "Yogupay test",
    "dest_amount": 50,
    "bank_code": "012",
    "recipient_email": "johndoe@yogupay.com",
    "account_type": "C",
    "document_type": "RFC",
    "document_id": "ABCD7215128Y5",
    "bank_name": "BBVA Bancomer",
    "branch_code": ""
}'
```

{% endtab %}

{% tab title="Successful Response" %}

```json
{
    "status": "1",
    "message": "Payout accepted for processsing"
}
```

{% endtab %}

{% tab title="Unsuccessful Response" %}

```json
{
  "error": "Invalid request"
}
```

{% endtab %}
{% endtabs %}

[^1]: <mark style="background-color:green;">I</mark>n this case, it will be 'LATAM'

[^2]: Refer to [Bank Codes](/yogupay-payout-api/payouts/bank-codes.md)

[^3]: <mark style="background-color:green;">(Savings (S) or Current (C))</mark>


---

# 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://yogupay.gitbook.io/yogupay-payout-api/payouts/payout-latam.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.