# Payout Ghana

## Create a Payout to Ghana

<mark style="color:green;">`POST`</mark> `/`[`auth/payout`](https://sandbox.yogupay.com/auth/payout)

Ghana Payout

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |
| Token        | token              |

**Body**

{% hint style="info" %}
The required fields for this request are marked <mark style="color:red;">\*</mark>
{% endhint %}

<table><thead><tr><th width="223">Field</th><th width="169">Type</th><th>Description</th></tr></thead><tbody><tr><td>bank_account_number</td><td>string</td><td>The bank account number of the recipient.</td></tr><tr><td>bank_code</td><td>string</td><td>The bank code of the recipient's bank</td></tr><tr><td>country_code<mark style="color:red;">*</mark></td><td>string</td><td>The <a data-footnote-ref href="#user-content-fn-1">country code</a> of the recipient </td></tr><tr><td>source_currency<mark style="color:red;">*</mark></td><td>string</td><td>The <a data-footnote-ref href="#user-content-fn-2">currency </a>in which the funds will be deducted from.</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</td><td>string</td><td>The purpose of the funds transfer</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>msisdn<mark style="color:red;">*</mark></td><td>string</td><td>The mobile number of the recipient.</td></tr><tr><td>recipient_email</td><td>string</td><td>The email address of the recipient.</td></tr><tr><td>payment_reference<mark style="color:red;">*</mark></td><td>string</td><td>A reference unique to your system</td></tr><tr><td>collection_network<mark style="color:red;">*</mark></td><td>string</td><td>The collection network for the payout</td></tr><tr><td>channel<mark style="color:red;">*</mark></td><td>string</td><td>The channel through which the payout will be made.</td></tr></tbody></table>

**Request & Response**

{% tabs %}
{% tab title="Request" %}
{% code fullWidth="false" %}

```json
{
    "bank_account_number": "",
    "country_code": "GH",
    "source_currency": "GHS",
    "source_amount": "10",
    "purpose_of_funds": "School Fees",
    "recipient_name": "John Doe",
    "bank_code": "",
    "msisdn": "233248284561",
    "recipient_email": "johndoe@yogupay.com",
    "payment_reference": "johnkghstest1",
    "collection_network": "MOBILEMONEY",
    "channel": "MOBILEMONEY"
}

```

{% endcode %}
{% endtab %}

{% tab title="Successful Response" %}

```json
{
    "status": 1,
    "trx_code": "ECEM8LGFEO",
    "message": "Success You have successfully initiated a transfer. Please wait a few minutes as we complete this for you"
}
```

{% endtab %}

{% tab title="Unsuccessful Response" %}

```json
{
    "status": "0",
    "message": "Cannot complete this transaction, please contact admin"
}

```

{% endtab %}
{% endtabs %}

[^1]: <mark style="background-color:blue;">In this case, it will be 'GH'</mark>

[^2]: GHS
