# Integration

{% hint style="warning" %}
You have to redirect to the link which is returned in respomse data. In addition, you need to store the value of field reference and orderid for using api Verify Transaction.
{% endhint %}

## Payout Transaction

<mark style="color:green;">`POST`</mark> `https://borderlesspaymentng.com/api/payout`

#### Headers

| Name                                            | Type   | Description              |
| ----------------------------------------------- | ------ | ------------------------ |
| authorization<mark style="color:red;">\*</mark> | String | Bearer YOUR\_SECRET\_KEY |
| content-type<mark style="color:red;">\*</mark>  | String | application/json         |

#### Request Body

<table><thead><tr><th>Name</th><th width="191">Type</th><th>Description</th></tr></thead><tbody><tr><td>amount<mark style="color:red;">*</mark></td><td>String</td><td>amount</td></tr><tr><td>currency<mark style="color:red;">*</mark></td><td>String</td><td>currency - NGN/KES/GHN</td></tr><tr><td>reference<mark style="color:red;">*</mark></td><td>String</td><td>your transaction reference </td></tr><tr><td>receiver_name<mark style="color:red;">*</mark></td><td>String</td><td>receiver name</td></tr><tr><td>sender_name<mark style="color:red;">*</mark></td><td>String</td><td>sender name</td></tr><tr><td>email<mark style="color:red;">*</mark></td><td>String</td><td>email</td></tr><tr><td>phone<mark style="color:red;">*</mark></td><td>String</td><td>phone</td></tr><tr><td>receiver_address<mark style="color:red;">*</mark></td><td>String</td><td>receiver address</td></tr><tr><td>sender_address<mark style="color:red;">*</mark></td><td>String</td><td>sender address</td></tr><tr><td>bank_name<mark style="color:red;">*</mark></td><td>String</td><td>bank name if type is BANK</td></tr><tr><td>bank_account_number<mark style="color:red;">*</mark></td><td>String</td><td>bank account number if type is BANK</td></tr><tr><td>network_name<mark style="color:red;">*</mark></td><td>String</td><td>name of mobile network if type is MOBILE</td></tr><tr><td>ip_address<mark style="color:red;">*</mark></td><td>String</td><td>ip address</td></tr><tr><td>type<mark style="color:red;">*</mark></td><td>string</td><td>BANK / MOBILE</td></tr><tr><td>webhook_url<mark style="color:red;">*</mark></td><td>String</td><td>webhook url with method POST</td></tr></tbody></table>

{% tabs %}
{% tab title="200: OK " %}

```json
{
  "status" : "success",
  "message" : "success",
  "data":
   {
      "status" : "approved",
      "message" : "Successfully deposited N100.00 to bank account ******1748. Transaction Id: NYHD0.",
      "transaction" :
      {
         "reference" : "e5d7d46e76c378ba3b188648f964d824",
         "orderid" : "NYHD0",
         "bank_uuid" : "30AE3B3E-F20D-431F-959B-DDC9CEEE79A5",
         "bank_account_number" : "7063861748",
         "amount" : "100.00",
         "fee" : 53.75,
         "vat" : 3.75
      }
   } 
}
```

{% endtab %}

{% tab title="401: Unauthorized " %}

```json
{
    "status" : "failed",
    "message" : "Invalid Token"
}
```

{% endtab %}

{% tab title="400: Bad Request " %}

```json
{
    "status" : "failed",
    "message" : "Bad Request"
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: 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:

```
GET https://doc.borderlesspaymentng.com/payment/payout-local/integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.