# PesaLink

> Instant bank-to-bank transfers for customers in Kenya via the PesaLink network.

PesaLink is an instant payment channel that lets customers pay directly from their bank account. Each transaction is completed using a temporary account number and reference generated by Paystack. Only KES is supported on PesaLink

<callout type="info" title="Availability">

PesaLink is available to registered Kenyan businesses. Contact [support@paystack.com](mailto:support@paystack.com) to enable this channel on your account.

</callout>

## How the channel works

1. Create a [Charge](/api/charge#create) with the customer email, amount, and a `bank_transfer` object.
2. Paystack returns a temporary `account_number` and a `transaction_reference`.
3. You display both values to the customer. They use the account number as the destination and the transaction reference as the narration in their bank transfer.
4. The customer makes the transfer from their internet or mobile banking app.
5. Paystack sends a `charge.success` webhook event when the transfer is matched.

<localized-snippet src="payments/channels/pesalink-charge">



</localized-snippet>

<table>
<thead>
  <tr>
    <th>
      Field
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        account_expires_at
      </code>
    </td>
    
    <td>
      ISO 8601 timestamp for account expiry. Must be within 25 minutes from now. Set to <code>
        null
      </code>
      
       to use the maximum.
    </td>
  </tr>
</tbody>
</table>

<callout type="info" title="Account Validity">

The account number is valid for **25 minutes** from charge creation. Communicate this timeout clearly at checkout to avoid failed or unmatched transfers.

If the `account_expires_at` value exceeds 25 minutes, Paystack defaults to 25 minutes.

</callout>

```json
{
  "status": true,
  "message": "Charge attempted",
  "data": {
    "reference": "kcvu0t3kzs",
    "status": "pending_bank_transfer",
    "display_text": "Please make a transfer to the account specified",
    "account_name": "Paystack Payments Kenya Limited",
    "account_number": "1234567891",
    "bank": {
      "slug": "dtbk-bank",
      "name": "Diamond Trust Bank Kenya Ltd",
      "id": 225
    },
    "account_expires_at": "2025-04-24T16:55:57.954Z",
    "amount": 10000,
    "transaction_reference": "1234567"
  }
}
```

<callout type="warning">

Always show the `transaction_reference` to the customer and instruct them to use it as the narration. Paystack uses this to match the incoming transfer to your transaction. Without it, the payment may not reconcile correctly.

</callout>

<callout type="danger">

Customers using **Diamond Trust Bank (DTB)** accounts cannot complete transfers via PesaLink.

</callout>

## Handling incorrect amounts

If the customer transfers an incorrect amount, Paystack rejects the payment and sends a `bank.transfer.rejected` event. A refund is automatically processed. The customer must start a new payment with the correct amount.

## Webhook events

<table>
<thead>
  <tr>
    <th>
      Event
    </th>
    
    <th>
      Meaning
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        charge.success
      </code>
    </td>
    
    <td>
      Transfer was received and matched to the transaction
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        bank.transfer.rejected
      </code>
    </td>
    
    <td>
      Incorrect amount sent. The refund is processed automatically.
    </td>
  </tr>
</tbody>
</table>

```json
{
  "event": "charge.success",
  "data": {
    "status": "success",
    "reference": "your_reference",
    "amount": 50000,
    "currency": "KES",
    "channel": "bank_transfer"
  }
}
```
