VGS Universal Checkout & Payment Orchestration Integration Demo

Before running the application, make sure, that you have access to your Payment Orchestration Instance & API and all prerequisites are met, gateways and rules are set and you have access credentials to authenticate.

This demo contains 4 flows:

• Default flow: Checkout create financial_instruments in Payment Orchestration application
• Saved Cards flow: Allow usage of pre-saved financial_instruments
• Transfer flow: Checkout complete payment flow, create financial_instruments and make a transfer
• 3DS flow: example how client application can works with VGS 3DS API

This demo is built with:

• VGS Payment Orchestration API
• VGS Universal Checkout JS library

How to run

Prerequisites

1. Clone the repo git clone git@github.com:vgs-samples/payment-orchestration-demo.git.
2. Create .env file in the root project folder.
3. Fill in the file with the necessary configuration variables shown below.
4. If Inbound routes where not created yet by VGS Support - create Inbound routes from . yaml files. You can find them in ./routes folder.

.env file - content description

CUSTOMER_VAULT_ID=
PAYMENT_ORCH_CLIENT_ID=
PAYMENT_ORCH_CLIENT_SECRET=

• CUSTOMER_VAULT_ID - Your vault id for storing cards data
• PAYMENT_ORCH_CLIENT_ID, PAYMENT_ORCH_CLIENT_SECRET - Payment Orchestration documentation
• PAYMENT_ORCH_APP_DOMAIN - Domain of Payment Orchestration application without https or http

How to run locally

1. python -m venv venv
2. . ./venv/bin/activate
3. export FLASK_APP=app
4. pip install -r ./requirements.txt
5. flask run
6. Open http://localhost:5000 in browser

How to run with Docker

1. docker-compose up --build
2. Open http://localhost:5000 in browser

How to use

Create financial instruments

Fill and submit the Universal Checkout form with a test payment card. Please note that a test payment card depends on the gateway you use and can be different if you want to try a successful transaction flow.

cardholder: Any Name
cc: 4111 1111 1111 1111
exp.date: 02/23
cvc: 123

3DS flow

Example shows how to work with VGS 3DS API Before start, make shure, that you create one of the possible 3DS Provider: Adyen, PAAY.co, 3dsecure.io

For more details on how to build your payments flow, check this guide out.

How 3DS works