Standard payment flow

How it works


Redirect integration allows running payments using the prebuilt payment flow.


3454

To accept payments in your application or website via redirect, use:

  • POST /purchases/ request to create the Purchase and receive the checkout_url.

  • Redirect the customer to the checkout_url to enter their card details for processing.

  • After the payment is processed, the system will redirect the customer back to your website (take note of success_redirect, failure_redirect).


You have three options to check payment status:

  1. Use the success_callback parameter of the Purchase object.

  2. Use GET /purchases/<purchase_id>/ request.

  3. Set up a Webhook using your account's Developers section or Webhook API to listen to purchase.paid, or purchase.payment_failure event on your server.

If you are using a CMS or e-Commerce platform


If you're using an eCommerce CMS like Shopify, WooCommerce or Prestashop!, we've got Plugins for those.


Pre-authorisation


Setting the skip_capture flag to true allows you to separate the authentication and payment execution steps, allowing you to reserve funds on the customer's card account for some time.


This flag can also enable pre authorisation capability, allowing you to save the card without a financial transaction, if possible.


📘

Note

Pre-authorisation capability is only available for card payments. Contact your Revio account manager to learn more and how to activate this service for your business.


Saving payment details for 1-click purchases


If the customer agrees to store his chosen method for future purchases, there will be an option to pay with a single click next time. To enable this, create a Client object for each client and provide the client_id parameter value in your Purchase creation requests.


To create a Purchase or a BillingTemplate, you must specify the Brand ID and API key. You can find both in the Developers section of your account.


📘

Note

Only applicable for Card, Debit Order, LinkPay (Stitch) and [email protected] payment methods.


No website, no problem


If you don't have a website or don't want to deal with any code, that's fine too. We've got you covered:


  • Easily send your customers a link for them to make a payment
  • Request payment from clients with electronic invoices

3454

Set due=strict when creating Invoices via the Revio API. Doing so won't allow your customer to make a payment after the due date.


👍

Pro tip

Whitelist the available payment methods that your customer can use by setting the available payment methods using the payment_method_whitelist field when creating purchases or invoices.