Skip to main content
When someone makes a payment using Paywint Checkout, they are taken to Paywint’s secure checkout page. After the payment attempt is finished—whether it succeeds or fails—Paywint automatically redirects the customer back to your website. It’s how your site knows the result of the payment so you can show the appropriate message.

​
How It Works

  1. Your customer clicks “Pay” in your app or website.
  2. Paywint opens its secure checkout page.
  3. The customer chooses a payment method and completes the process.
  4. When the payment finishes, Paywint redirects the customer back to the page you chose (your Redirect URL”).
  5. Paywint adds two small pieces of information to the web address when sending them back:
    • id: the unique Paywint payment number
    • status: the result of the payment (success, failed, or rejected)
That’s it—the customer is now back on your site, and you know what happened with their payment.

​
Example Redirects

After a payment, Paywint might send the customer back to your site like this: 
https://yourapp.com/checkout/result?status=success&id=pay_9f3a2c
https://yourapp.com/checkout/result?status=failed&id=pay_9f3a2c
Notice the extra 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

StatusWhat it means for the paymentWhat you might show your customer
successThe payment went through.“Payment successful! Thank you for your order.”
failedThe payment did not go through.“Something went wrong. Please try again.”
Some payment methods may initially display a processing status. This means the final result will be available later. In such cases, your system should wait for confirmation—either through a webhook or by checking the payment details in Paywint.

​
Where to Setup

You decide the page where customers should land after payment. This is called your Redirect URL.

​
Sandbox

Use the Sandbox environment to test your redirect behavior before moving to production.
  1. Create a Sandbox Account:
    Sign up for a Sandbox Account to start testing your integration.
  2. Get API Key:
    Go to the Developer Panel → API Key section to generate your Sandbox API key.
  3. Configure Redirect URLs:
    In the Developer Panel → Redirect/Webhook section, you’ll find fields to enter your test endpoints:
    • Payment Redirect URL:
      The endpoint to which redirects happen when a specific payment action completes.
      Example: https://example.com/Redirect/payment

​
Production

Once your Sandbox testing is complete, you can move to the Production environment. Before enabling your Production setup, please contact our support team to ensure your API and redirect configurations are properly activated.
  1. Create a Production Account:
    Sign up for a Production Account.
  2. Enable Production Access:
    Contact our support team to request activation of your Production API and redirect setup.
  3. Get API Key:
    Go to the Developer Panel → API Keys section to obtain your Production API key.
  4. Set Your Redirect URL:
    In the Developer Panel → Redirect/Webhook section, enter your live redirect endpoint.
    Example: https://yourapp.com/checkout/payment
  5. Support Contacts:
    If you need assistance during setup:

​
Why This Matters

  • Redirects allow customers to return to your app smoothly after completing a payment.
  • You can immediately display a confirmation page showing whether the payment was successful, failed, or rejected.
  • To ensure complete accuracy, your system should also verify the final result through Paywint’s webhook or by retrieving the payment details.

​
Quick Setup

  1. In Developer Panel → Redirect/Webhook, set your Payment Redirect URL (the page where customers should land after payment).
  2. Make sure this page can read the status and id from the web address.
  3. Show your customer the right message based on the result.
That’s all—your customers always end up back in your app, and you can guide them to their next step.