# How to use partial debits

> Recover part of a recurring payment when the full amount cannot be charged from a saved authorization.

## Confirm eligibility

Partial debit is available only on request. Access is granted after review by Paystack’s team. The feature currently supports Mastercard and Verve authorizations.

## Start from a saved authorization

Partial debits work only on existing authorizations. Use the same email attached to the authorization and the authorization code from a previous successful payment.

## Call the partial debit endpoint

Send the authorization, currency, amount, and email to `https://api.paystack.co/transaction/partial_debit`.

```bash
curl https://api.paystack.co/transaction/partial_debit \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
  "authorization_code": "AUTH_72btv547",
  "currency": "NGN",
  "amount": "20000",
  "email": "customer@email.com"
}' \
-X POST
```

You can also include:

- `reference` for tracking and idempotency
- `at_least` to set the minimum amount Paystack should try to recover

`at_least` must not be greater than `amount`.

## Use bulk charge when processing many partial retries

If you are charging many customers at once, pass `attempt_partial_debit: true` in each bulk charge object. Combine it with `at_least` when you want to define a lower acceptable recovery amount.

## Verify the result

When partial debit is involved, Paystack returns two important amount fields during verification and webhook processing:

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

<tbody>
  <tr>
    <td>
      <code>
        amount
      </code>
    </td>
    
    <td>
      The amount actually charged
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        requested_amount
      </code>
    </td>
    
    <td>
      The amount you originally tried to charge
    </td>
  </tr>
</tbody>
</table>

Use `amount` to determine what was recovered, and `requested_amount` to compare the original bill against the settled amount.

## Reconcile before fulfilment

Only mark the payment flow complete after you verify the transaction or receive the final webhook event. If your fulfilment depends on collecting the full amount, compare `amount` and `requested_amount` before granting access or shipping goods.
