ChapaChapa Docs

Verify Payment

Verify the status of a transaction

Always verify the payment status on your server before fulfilling the order.

How to verify payments

Verification depends on the method used during initialization. From your callback (or server), send a GET request to the verify endpoint with the tx_ref you set when creating the payment.

Endpoint https://api.chapa.co/v1/transaction/verify/{tx_ref}
Method GET
Authorization Bearer CHAPA_SECRET_KEY

cURL
JavaScript
Python

Successful response

  • Returns transaction details with status (e.g., success) and references.

Failed response

  • Returns an error with status and message.

Refer to Error Codes for all possible responses.

Chapa Inline.js

JavaScript module for integrating Chapa's direct charges into your web application with a dynamic payment form

Webhooks

Listen to real-time payment events and receive notifications when transactions occur

On this page

How to verify payments
Successful response
Failed response