# Request payment (RTP) from a customer for an invoice

`POST https://api.leapa.co/v2/invoices/{invoiceId}/request-rtp`

Send your API key as a bearer token in the `Authorization` header.

## Path parameters

- `invoiceId` · _string_ · **required**
  Example: `inv_7c1f9a2b48`

## Request body

Required. `application/json`.

- `debtor_alias` · _string_
- `debtor_account` · _string_
- `debtor_bank_bic` · _string_
- `debtor_name` · _string_
- `amount` · _integer<int64>_
- `currency` · _string_

```json
{
  "debtor_alias": "+25779123456",
  "debtor_account": "00012345678901",
  "debtor_bank_bic": "BIBUBIBI",
  "debtor_name": "Jeanne Ndayishimiye",
  "amount": 45000,
  "currency": "BIF"
}
```

## Response 200

- `invoice_id` · _string_
- `uetr` · _string_
- `amount` · _integer<int64>_
- `currency` · _string_
- `status` · _string_
- `expires_at` · _integer<int64>_
- `message` · _string_

```json
{
  "invoice_id": "inv_7c1f9a2b48",
  "uetr": "97ed4827-7b6f-4491-a06f-b548d5a7512d",
  "amount": 45000,
  "currency": "BIF",
  "status": "pending",
  "expires_at": 1769850251000,
  "message": "Request sent to the payer"
}
```

## Status codes

- `200` OK
- `400` Bad request
- `401` Unauthorized
- `402` Payment required
- `403` Forbidden
- `404` Not found
- `428` Precondition required
- `500` Server error

## Example

```bash
curl -X POST "https://api.leapa.co/v2/invoices/inv_7c1f9a2b48/request-rtp" \
  -H "Authorization: Bearer $LEAPA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "debtor_alias": "+25779123456",
    "debtor_account": "00012345678901",
    "debtor_bank_bic": "BIBUBIBI",
    "debtor_name": "Jeanne Ndayishimiye",
    "amount": 45000,
    "currency": "BIF"
  }'
```

---

_Generated from the Leapa documentation at leapa.co/docs._