How It Works
- Your customer clicks “Pay” in your app or website.
- Paywint opens its secure checkout page.
- The customer chooses a payment method and completes the process.
- When the payment finishes, Paywint redirects the customer back to the page you chose (your “Callback URL”).
-
Paywint adds two small pieces of information to the web address when sending them back:
id
: the unique Paywint payment numberstatus
: the result of the payment (success
,failed
, orrejected
)
Example Redirects
After a payment, Paywint might send the customer back to your site like this:id
and status
at the end of the web address. You can use these values to decide what message to show your customer.
What the Status Means
Status | What it means for the payment | What you might show your customer |
---|---|---|
success | The payment went through. | “Payment successful! Thank you for your order.” |
failed | The payment did not go through. | “Something went wrong. Please try again.” |
Some payment methods may first show processing
. This means the final result will come later. In those cases, your system should wait for confirmation (via webhook or checking the payment details in Paywint).
Where to Set the Callback URL
You decide the page where customers should land after payment. This is called your Callback URL.-
Sandbox (testing):
Go to Sandbox Dashboard → URLs and enter your page link,
e.g.
https://sandbox.yourapp.com/checkout/result
. -
Production (live):
Go to Production Dashboard → URLs and enter your live page link,
e.g.
https://yourapp.com/checkout/result
.
Why This Matters
- Redirects let your customers come back to your app smoothly after paying.
- You can immediately show them a confirmation screen (success, failure, or rejection).
- To be 100% sure of the final result, your system should also check Paywint’s webhook or fetch the payment details.
Quick Setup
- In your Paywint Dashboard, set your Payment Callback URL (the page where customers should land after payment).
- Make sure this page can read the
status
andid
from the web address. - Show your customer the right message based on the result.