Payment Status
The Payment Status API allows you to retrieve the current status of a payment using the merchant reference. SplashPay first checks the local transaction record. If the payment is still pending, it automatically queries the payment provider to retrieve the latest status and updates the transaction before returning the response.Tip For real-time payment updates, configure Webhooks. The Status API is ideal for reconciliation, manual verification, and fallback scenarios.
Endpoint
Authentication
Every request must include your API credentials.Example Request
- cURL
- JavaScript
- Python
- PHP
Request Body
Example Response
Payment Statuses
Error Response
Best Practices
1
Use unique references
Generate a unique reference for every payment. This reference is used throughout the payment lifecycle.
2
Prefer Webhooks
Use webhooks to receive payment updates automatically. The Status API should primarily be used for reconciliation and manual verification.
3
Avoid excessive polling
If a payment is still
pending or processing, wait a few seconds before checking again.4
Store the provider reference
Save the
provider_reference returned by SplashPay for reconciliation with the payment provider.Related Guides
Mobile Money
Collect payments from Mobile Money wallets.
Card Payments
Accept Visa and Mastercard payments.
Dynamic TanQR
Accept payments using Dynamic TanQR.
Webhooks
Receive real-time payment notifications.
