# Transfer recipients

> Create and manage recipients that you can send money to.

A transfer recipient is a beneficiary created on your integration to allow you send money. Before sending money from your integration, you need to collect the customer’s details to create a transfer recipient.

Paystack supports the following recipient types:

<localized-table page-key="disbursements/recipients" section="recipient_types">



</localized-table>

To create the transfer recipient, make a `POST` request to the <api-link path="/transfer-recipient#create" title="Transfer Recipient">



</api-link>

 endpoint passing the customer’s details for the recipient type.

## Bank account

When creating a transfer recipient with a bank account, you need to collect the customer’s bank details. Typically, the account number and associated bank should suffice, however, more details could be required for account verification. You should design your user interface to allow the collection of the necessary details based on your business operation.

### List banks

When creating your user interface (UI) to collect the user’s bank details, you’ll need to populate the UI with a list of banks available via the <api-link path="/bank#list" title="List bank">



</api-link>

 endpoint.

To fetch a list of banks in a country, make a `GET` request passing the `currency` in the query parameter:

<localized-request-response src="disbursements/recipients/list-bank">



</localized-request-response>

<localized-block regions="gh">
<callout title="Ghanaian bank transfer support" type="danger">

At the moment, transfers can't be made to the **Bank of Ghana**. We recommend
that you exclude it from the list of banks as we work on supporting transfers
to it.

</callout>
</localized-block>

<localized-block regions="ng, gh, za">

### Verify the account number

You need to collect the destination account number and confirm that it’s valid. This is to ensure you don’t send money to the wrong or invalid account.

<localized-block regions="ng, gh">

Use [Resolve account number](/disbursements/transfers/verify-account#resolve-account-number) to confirm the account name before you create the recipient.

</localized-block>

<localized-block regions="za">

Use [Account validation](/disbursements/transfers/verify-account#account-validation) to confirm the account details before you create the recipient.

</localized-block>
</localized-block>

### Create recipient

With the verification completed, you can pass the customer’s bank details and the recipient `type` to the <api-link path="/transfer-recipient#create" title="Create Transfer recipient">



</api-link>

 endpoint:

<localized-request-response src="disbursements/recipients/create-bank">



</localized-request-response>

<localized-block regions="gh, ke">

## Mobile money

<callout title="Feature availability" type="info">

This feature is currently available to businesses in Ghana and Kenya.

</callout>

Mobile money allows a merchant send money to a customer’s mobile number. To start with, you need to collect the customer’s phone number and telco. To fetch the supported telcos, call <api-link path="/bank#list" title="List Banks">



</api-link>

 with your `currency` and `type` set to `mobile_money`:

<localized-request-response src="disbursements/recipients/list-telcos">



</localized-request-response>

With the customer’s mobile number, you can then create a recipient by using the telco code as the `bank_code` and the mobile number as the `account_number`:

<localized-request-response src="disbursements/recipients/create-mobile-money">



</localized-request-response>
</localized-block>

<localized-block regions="ke">

### M-PESA Paybill and Till numbers

M-PESA has several `bank_code` options:

1. `MPESA` for individual Mpesa users
2. `MPPAYBILL` for Paybill numbers and requires additional information during disbursement
3. `MPTILL` for business Till numbers

The recipient type for Paybill and Till numbers is `mobile_money_business`.

<localized-request-response src="disbursements/recipients/create-mpesa-till">



</localized-request-response>
</localized-block>

## Authorization code

An authorization code is returned after a successful card payment by a customer. Combining the authorization code with the email address used for payment, you can create a transfer recipient:

<request-response>
<template v-slot:curl="">

```bash
curl https://api.paystack.co/transferrecipient \
  -H "Authorization: Bearer $PAYSTACK_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "authorization",
    "name": "Revs Ore",
    "email": "revs@ore.com",
    "authorization_code": "AUTH_ncx8hews93"
  }' \
  -X POST
```

</template>

<template v-slot:js="">

```javascript
const https = require("https");

const params = JSON.stringify({
  "type": "authorization",
  "name": "Revs Ore",
  "email": "revs@ore.com",
  "authorization_code": "AUTH_ncx8hews93"
});

const options = {
  hostname: "api.paystack.co",
  port: 443,
  path: "/transferrecipient",
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PAYSTACK_SECRET_KEY}`,
    "Content-Type": "application/json",
  },
};

const req = https.request(options, (res) => {
  let data = "";
  res.on("data", (chunk) => {
    data += chunk;
  });
  res.on("end", () => {
    console.log(res.statusCode, JSON.parse(data));
  });
});

req.on("error", (error) => {
  console.error(error);
});

req.write(params);
req.end();
```

</template>

<template v-slot:php="">

```php
<?php
$fields = [
  "type" => "authorization",
  "name" => "Revs Ore",
  "email" => "revs@ore.com",
  "authorization_code" => "AUTH_ncx8hews93",
];

$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.paystack.co/transferrecipient",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode($fields),
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer " . getenv("PAYSTACK_SECRET_KEY"),
    "Content-Type: application/json",
    "Cache-Control: no-cache",
  ),
));
$response = curl_exec($curl);
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . " " . $response;
?>
```

</template>

<template v-slot:response="">

```json
{
  "status": true,
  "message": "Transfer recipient created successfully",
  "data": {
    "active": true,
    "createdAt": "2022-02-21T11:35:59.302Z",
    "currency": "NGN",
    "domain": "test",
    "email": "revs@ore.com",
    "id": 25747878,
    "integration": 463433,
    "name": "Revs Ore",
    "recipient_code": "RCP_wql6bj95bll7m6h",
    "type": "authorization",
    "updatedAt": "2022-02-21T11:35:59.302Z",
    "is_deleted": false,
    "isDeleted": false,
    "details": {
      "authorization_code": "AUTH_ncx8hews93",
      "account_number": null,
      "account_name": null,
      "bank_code": "057",
      "bank_name": "Zenith Bank"
    }
  }
}
```

</template>
</request-response>

<callout title="Account Number Association" type="warning">

If an account number isn’t associated with the authorization code, we return a
response with a message: `Account details not found for this authorization`.
If you get this error, request the customer's account details and
follow the process to create a transfer recipient using a bank account.

</callout>

## Save the recipient code

The `recipient_code` in the `data` object of the response is the unique identifier for the customer and would be used to make transfers to the specified account. This code should be saved with the customer’s records in your database.

```json
{
  "status": true,
  "message": "Transfer recipient created successfully",
  "data": {
    "active": true,
    "name": "Revs Ore",
    "recipient_code": "RCP_wql6bj95bll7m6h",
    "type": "authorization"
  }
}
```
