# 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](https://yogupay.gitbook.io/yogupay-payout-api/payouts/bank-codes)

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