Checkout callback

Payment Callback

When a payment is successfully completed, StroWallet will notify your system by sending a request to the callback URL provided during checkout initialization.

Example Callback URL

Text

https://merchant.com/callback?reference=7690e2926565&status=paid

Callback Parameters

Parameter	Description
reference	Unique StroWallet payment reference
status	Payment status (paid, pending, failed)

Example Successful Callback

Text

https://merchant.com/callback?reference=7690e2926565&status=paid

After receiving the callback, merchants should verify the payment status using the Checkout Status API.

Verify Payment

Request:

Bash

curl --request GET \
--url 'https://strowallet.com/api/checkout/status/?public_key=YOUR_PUBLIC_KEY&reference=7690e2926565' \
--header 'accept: application/json'

Successful Response:

JSON

{
  "status": true,
  "message": "Payment status fetched successfully.",
  "data": {
    "reference": "7690e2926565",
    "amount": "101.00",
    "currency": "NGN",
    "payment_status": "paid"
  }
}

For security reasons, merchants should always verify the payment status using the Checkout Status API instead of relying solely on callback data.