Skip to main content

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


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.

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.