List payment intents

GET/api/merchant/payment-intents

List payment intents

Request

Parameters

Name	Location	Type	Required
status	query	string	No
merchantReference	query	string	No
limit	query	integer	No

Responses

200 Payment intents

Example response

{
  "message": "payment intents fetched",
  "response": [
    {
      "paymentIntentId": "mpi_123e4567-e89b-12d3-a456-426614174000",
      "merchantReference": "INV-3021",
      "amount": 85000,
      "currency": "NGN",
      "status": "pending",
      "accountNumber": "0123456789",
      "accountName": "Importa Merchant",
      "bankName": "PALMPAY",
      "description": "Order payment",
      "metadata": {},
      "expectedSenderBankName": "PALMPAY",
      "expectedSenderAccountNumber": "8889227300",
      "paidAmount": 0,
      "expiresAt": "2026-08-25T12:00:00.000Z",
      "createdAt": "2026-08-24T12:00:00.000Z",
      "updatedAt": "2026-08-24T12:00:00.000Z"
    }
  ]
}