Verify a transaction by reference. Kyshi checks the stored transaction and, when needed, re-queries the payment provider.

-H "x-api-key: your_secret_key"

GET {{host}}/v1/transactions/verify/{reference}

Path Parameters

Field	Data Type	Required	Description
reference	string	Yes	Transaction reference returned during initialization or supplied by you.

{
  "status": true,
  "message": "Success",
  "code": 200,
  "data": {
    "id": "f6cbda33-1a40-4f2e-a211-fd87bd86cc4a",
    "reference": "ORDER-10001",
    "status": "SUCCESS",
    "type": "CR",
    "currency": "NGN",
    "amount": 1000,
    "feeBearer": "MERCHANT",
    "feeBreakdown": {
      "totalFees": 10,
      "processorFee": 0,
      "vat": 0,
      "allInclusiveKyshiFee": 10
    },
    "customer": {
      "email": "[email protected]",
      "firstName": "Ada",
      "lastName": "Okafor"
    },
    "createdAt": "2026-05-20T10:20:00.000Z"
  }
}

Statuses

Transaction status can be PENDING, SUCCESS, IN_REVIEW, FAILED, or COLLECTED.