Skip to main content

Validate Payment

This endpoint is used to validate a payment transaction and provides the transaction status, such as success, failed, or other outcomes.

Endpoint​

POST Payments/ValidatePayment

Headers​

Authorization: Bearer

To authorize this API request, you need to include your token as a bearer token. This is done by setting the Authorization header in your request. The header should have the format:

Authorization: "Bearer token"

The token property is gotten from the response data when you fetch payment meta

Request Body Parameters​

  • otp (String): One time password (OTP) sent to the payer. Could be via email or SMS. If the checkout flow is 3DS (in which case the OTP is provided at the payer's bank checkout), input 0000.

  • entryType (Integer): The type of entry for the validation process. See reference.

  • transactionId (String): The unique identifier for the transaction.

  • providerReference (String): The reference provided by the payment provider. Example: "EZP8833691220250110111140".

Request
  {
    "otp": "0000",
    "entryType": 0,
    "transactionId": "492uu387927",
    "providerReference": "EZP8309872720250310223618"
  }
Response (200) - Success
  {
    "responseCode": "00",
    "responseMessage": "Transaction successful. Approved by financial institution.",
  }