> For the complete documentation index, see [llms.txt](https://docs.epayment.ng/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.epayment.ng/funds-transfer.md).

# Funds Transfer

Note: all requests should have your API Token as a bearer token in authorization header. Content-Type application/json

There are three endpoints involved in funds transfer in the order of ***Account Number Validation***, ***Funds Transfer*** and ***Transfer Confirmation***

### Account Number Validation

The first process is to validate account number to get the account name. Bank list can be gotten from [here](/authorizations.md#authorization-and-bank-list)

<mark style="color:green;">`POST`</mark> `http://epayment.com.ng/epayment/api/3pbank_validate`

#### Headers

| Name                                           | Type | Description    |
| ---------------------------------------------- | ---- | -------------- |
| Bearer token<mark style="color:red;">\*</mark> |      | your-api-token |

#### Request Body

| Name                                   | Type | Description                                                     |
| -------------------------------------- | ---- | --------------------------------------------------------------- |
| Body<mark style="color:red;">\*</mark> |      | <p>{</p><p>"accountnumber":"1019956135", "bankcode":"033" }</p> |

{% tabs %}
{% tab title="200: OK {"status":"200","name":"YOUR ICT LTD"}" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

### Funds Transfer

<mark style="color:green;">`POST`</mark> `http://epayment.com.ng/epayment/api/3pbank_transfer`

#### Headers

| Name                                           | Type   | Description    |
| ---------------------------------------------- | ------ | -------------- |
| Bearer Token<mark style="color:red;">\*</mark> | String | your-api-token |

#### Request Body

| Name                                   | Type | Description                                                                                             |
| -------------------------------------- | ---- | ------------------------------------------------------------------------------------------------------- |
| Body<mark style="color:red;">\*</mark> |      | { "accountnumber":"1100483979", "amount":"500", "customer\_reference":"1B884843", "bankcode":"000004" } |

{% tabs %}
{% tab title="200: OK  {"status":"Successful","message":"Transaction processed successfully","data":{"provider\_response\_code":"00","provider": "ProvidusBank","errors":null,"error":null,"provider\_response":{ "reference":"HDzgkfbe\_epayment\_1542\_1017161476\_033\_512486","pay ment\_id":null,"destination\_institution\_code":"033","beneficiary *account\_name":"Mr K Tester","beneficiary\_account\_number":"8373288237","beneficiary* kyc\_level":null,"originator\_account\_name":"ePayment Services","originator\_account\_number":null,"originator\_kyc\_leve l":null,"narration":"|HDzgkfbe\_epayment\_1542\_1017161476\_033\_512 486|Money Transfer","transaction\_final\_amount":100000,"meta":{}},"client\_ info":{"name":null,"id":null,"bank\_cbn\_code":null,"bank\_name":n ull,"console\_url":null,"js\_background\_image":null,"css\_url":nul l,"logo\_url":null,"footer\_text":null,"show\_options\_icon":false, "paginate":false,"paginate\_count":0,"options":null,"merchant":n ull,"colors":null,"meta":null}}}" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

### Verify Completed Transfer

To verify completed transfers, use the following:

<mark style="color:green;">`POST`</mark> `http://epayment.com.ng/epayment/api/3pbank_verify`

#### Headers

| Name                                           | Type | Description    |
| ---------------------------------------------- | ---- | -------------- |
| Bearer Token<mark style="color:red;">\*</mark> |      | your-api-token |

#### Request Body

| Name                                   | Type | Description                        |
| -------------------------------------- | ---- | ---------------------------------- |
| Body<mark style="color:red;">\*</mark> |      | { "customer\_reference":"100123" } |

{% tabs %}
{% tab title="200: OK  {"status":"Successful","message":"Transaction processed successfully","data":{"provider\_response\_code":"00","provider": "ProvidusBank","errors":null,"error":null,"provider\_response":{ "reference":"HDzgkfbe\_epayment\_1542\_1017161476\_033\_512486","pay ment\_id":null,"destination\_institution\_code":"033","beneficiary *account\_name":"Mr K Tester","beneficiary\_account\_number":"8373288237","beneficiary* kyc\_level":null,"originator\_account\_name":"ePayment Services","originator\_account\_number":null,"originator\_kyc\_leve l":null,"narration":"|HDzgkfbe\_epayment\_1542\_1017161476\_033\_512 486|Money Transfer","transaction\_final\_amount":100000,"meta":{}},"client\_ info":{"name":null,"id":null,"bank\_cbn\_code":null,"bank\_name":n ull,"console\_url":null,"js\_background\_image":null,"css\_url":nul l,"logo\_url":null,"footer\_text":null,"show\_options\_icon":false, "paginate":false,"paginate\_count":0,"options":null,"merchant":n ull,"colors":null,"meta":null}}}" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}