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

# Domestic Banks Payouts

{% hint style="info" %}
**Good to know:** The minimum payout amount to a domestic bank is **KES. 100**
{% endhint %}

## Initiate domestic bank payout

<mark style="color:green;">`POST`</mark> `https://api.chpter.co/v1/payout/domestic-bank`

#### Headers

| Name                                      | Type   | Description            |
| ----------------------------------------- | ------ | ---------------------- |
| Api-Key<mark style="color:red;">\*</mark> | String | Your chpter Public Key |
| Content-Type                              | String | application/json       |

{% tabs %}
{% tab title="400: Bad Request invalid payload" %}

```json
{
    "message": "invalid payload",
    "success": false,
    "status": 400
}
```

{% endtab %}

{% tab title="200: OK payout initiated" %}

```
{
    "message": "payout initiated",
    "success": false,
    "status": 200
}
```

{% endtab %}

{% tab title="401: Unauthorized merchant not activated" %}

```json
{
    "message": "merchant not activated. please contact support@chpter.co ",
    "success": false,
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Good to know:** This API uses webhooks to notify you of the payout status through the callback url.&#x20;
{% endhint %}

#### Quick view

{% tabs %}
{% tab title="API Body" %}

```json
{
	"client_details": {
		"full_name": "John Doe",
		"phone_number": "254700123123",
		"email": "johndoe@mail.com"
	},
	"destination_details": {
		"country_code": "KE",
		"bank_code": "1234",
		"bank_name": "Example Bank",
		"bank_account_name": "John Doe",
		"bank_account_number": "0123456789"
	},
	"transfer_details": {
		"currency_code": "KES",
		"amount": 200.5
	},
	"callback_details": {
		 "notify_customer": true,
		"payout_reference": "ABC123",
		"callback_url": "https://eozdpom307nca3.m.pipedream.net"
	}
}
```

{% endtab %}

{% tab title="Successfull Callback Response" %}

```json
{
    "message": "Success",
    "success": true,
    "status": 200,
    "amount": 100,
    "currency": "KES",
    "payout_reference": "ABCD123",
}
```

{% endtab %}

{% tab title="Failed Callback Response" %}

```json
{
    "message": "Payout failed contact support@chpter.co",
    "success": false,
    "status": 200,
    "payout_reference": "ABCD123",
}
```

{% endtab %}
{% endtabs %}