Skip to main content
When a customer finishes paying, the widget hands your page a payment reference. Treat that as a message that “something happened”, not as proof of payment. Before you ship goods or unlock a service, always confirm the payment with Afara.
Anyone can run code in their own browser. Never mark an order as paid based only on what the browser tells your page. Confirm with Afara first.

​
Three ways to confirm a payment

1. Check the dashboard

Open Transactions in the merchant portal and search for the reference. This is the easiest option for small shops that handle orders by hand.

2. Let Afara notify you (recommended)

Afara sends your server a message the moment a payment is completed. This is reliable even if the customer closes their browser before the page finishes loading.

3. Ask Afara from your server

Your server asks Afara for the status of a reference, using the steps below.

​
Ask Afara for the status of a payment

Call this from your server, never from the browser. Use the reference you received from the widget.
Look at these fields in the response before you deliver the order:
This section is still being verified. The endpoint and fields above come from the Afara source code. We are confirming the exact request and response against the live system. See the API Reference for the full draft.

​
What the statuses mean