Recharge API Callback URL Explained (with PHP Example)

Most recharges succeed or fail within seconds. A few stay pending while the operator confirms. Without a callback URL, someone on your team checks those by hand. With one, your system updates itself.

How the callback works

1. You send a recharge with a unique order id.
2. The response says Pending.
3. When the operator confirms, A1Topup calls your callback URL with the order id, status and operator id.
4. Your code updates the order and refunds the customer if it failed.

A simple PHP handler

<?php
$orderId = isset($_GET['txid'])   ? $_GET['txid']   : '';
$status  = isset($_GET['status']) ? $_GET['status'] : '';
$opid    = isset($_GET['opid'])   ? $_GET['opid']   : '';
// 1. find the order   2. update only if still pending
// 3. on Failure refund the wallet   4. reply 200
http_response_code(200); echo 'OK';

Rules that prevent double refunds

• Update an order only if its current status is pending
• Log every callback with the time and raw values
• Reply with HTTP 200 quickly; do heavy work after
• If no callback arrives, check the status API with the same order id

Conclusion

A callback URL is a few lines of code that saves hours of manual checking every week. Full details and samples are in the API documentation.