Accept online payments

SwitchPay provides a powerful API and client libraries provides access to variety of payment options with a single integration.

Check our Demo Checkout Page to see what SwitchPay is capable of doing.

Visit checkout page using Safari browser and Apple Pay enabled for your operating system to experience Apple Pay payment flow.

Following diagram depicts from a high level the SwitchPay’s payment flow. General steps are common regardles of selected payment option or PSP however specifics may vary.

SwitchPay High Level Payment Flow

Each payment would include following steps:

  1. Creating a payment using Payments API.

  2. Rendering the checkout view using SwitchPay JS SDK. The SwitchPay JS SDK will collect payment information and create a Payment Method object that should be used to confirm the Payment.

  3. Confirming the payment using the identifier of a payment method provided via the SwitchPay JS callback.

  4. Checking the status property of the confirmed Payment to verify whether it doesn’t require additional action.

  5. In case of additional action is required following the redirect to the URL provided in details.

  6. If no actions were required or whenever user returned from the external page payment is being concluded and depending on the result success or failed message can be shown to the buyer.

Handling redirection

SwitchPay may request redirecting buyer to an external page in one of following scenarios:

  1. When 3D Secure authentication is required.

  2. When PSP requires buyer to confirm a transaction on PSP’s side.

In any case you’d need to provide a return_url when confirming the payment. User will be redirected back to that URL after finalising tasks on the external page. Depending on the PSP and use case when returned back additional information like payment status may be attached to the return URL in query string.

Redirection will be required in case of 3D Secure authentication or payment options requiring confirmation on an external page like PayPal.

It’s up to the client to properly handle buyer redirection to and from extrenal web page. SwitchPay JS does not perform redirects.

Select a guide

Select a guide that matches your use case to learn how to use SwitchPay to accept online payments.

Credit Card payments

Select a guide below to learn how to process credit card payments with SwitchPay.

Accept a credit card payment
Learn how to add SwitchPay UI elements you your website and accept one-time credit card payments.
Setup a recurring payment
Learn how to save a credit card and use it for recurring payments.
3D Secure Card Authentication
Learn how 3D Secure card authentication is supported by SwitchPay API.

Wallet payments

Select a guide below to learn how to process wallet payments with SwitchPay.

Accept an Apple Pay payment
Learn how to add Apple Pay button to your website and accept accept one-time Apple Pay payments.
Accept a Google Pay payment
Learn how to add Google Pay button to your website and accept accept one-time Google Pay payments.
Accept a PayPal payment
Learn how to add Google Pay button to your website and accept accept one-time Google Pay payments.
Place a hold on PayPal account
Learn how to place a hold on customer’s PayPal account.

SEPA Direct Debit payments

Select a guide below to learn how to process SEPA direct debit payment with SwitchPay.

Accept a SEPA Direct Debit payment
Learn how to allow SEPA Direct Debit payments on your website.
Save IBAN for future payments
Learn how to save IBAN and use it for future SEPA Direct Debit payments.
Setup a recurring payment
Learn how to allow subscription payments with SEPA Direct Debit.

Payment reversals

Refund a payment
Learn how to refund a payment.
Handle payment disputes
Learn how to get notified and handle disputed payments.
Bank statements
Learn how to set static and dynamic bank statement descriptors.
Create Top Up
Learn how to transfer additional funds to an onboarded merchant.