Virtual terminal integration
This integration is designed to integrate Flex to the virtual payment terminal used in your call centers.
Overview
Integration steps
On the virtual terminal page
You need to create and host your own user interface for the virtual payment terminal using the HTTPS protocol.
1. Embed and invoke SenseJS
Flex needs to receive fingerprinting for the customer's session on the checkout page (e.g.: loading, device, timzone).
SenseJS is the dedicated JavaScript library for that. It needs to be invoked when the checkout page is loaded.
Implement SenseJS to your virtual terminal page.
On the server side
2. Authentication
All API requests are made over HTTPS. Requests without authentication will fail.
How to authenticate.
3. Vault credit card info on checkout
Once the credit card information is collected for Authorization, it needs to be vaulted with Flex for later use.
Vaulting can be made in parallel to the Auth call.
Incorporate /tokenize to the payment process.
4. On authorized payments: Transmit the transaction information
Flex will build your custom risk model based on your successful transactions. POST /transmit doesn't require an answer, so this 'fire and forget' call doesn't add latency to your transaction.
Queue /transmit after an approval.
5. On declined payments: Evaluate that transaction
Retrieve the tokenized credit card information and pass it along with POST /evaluate
Flex will evaluate that transaction and respond with an APPROVED
or DECLINED
status in real time.
Call /evaluate after a decline.
Depending on the response from /evaluate, the client-side application should redirect the user or display appropriate messages to inform them of the transaction status.
Build your integration
Your integration build will depend on the characteristics of your technical ecosystem.
Unsure what steps you can/need to perform? Let's schedule a call!
Updated 5 months ago