OI Payments Docs
API ReferencePayments

List By Reference

GET
/api/v1/payments

Authorization

AppApiKey AppApiSecret
X-Api-Key<token>

Per-app API key. Sent together with the X-Api-Secret header. The key's mode (TEST or LIVE) selects the data partition — it is never taken from the request body.

In: header

X-Api-Secret<token>

Per-app API secret that pairs with X-Api-Key. Both headers are required on every app-facing call.

In: header

Query Parameters

customerReference*string

Response Body

*/*

curl -X GET "https://example.com/api/v1/payments?customerReference=string"
{
  "data": [
    {
      "id": 0,
      "reference": "string",
      "status": "string",
      "applicationId": 0,
      "mode": "string",
      "amountMinor": 0,
      "currency": "string",
      "gateway": "string",
      "gatewayTxnId": "string",
      "checkoutUrl": "string",
      "redirectUrl": "string",
      "invoiceId": 0,
      "metadata": {},
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "meta": {
    "success": true,
    "message": "string",
    "errorCode": "RESOURCE_NOT_FOUND",
    "timestamp": "2019-08-24T14:15:22Z"
  },
  "pagination": {
    "page": 0,
    "size": 0,
    "totalElements": 0,
    "totalPages": 0
  }
}