This guide provides the technical detail you need to integrate your platform with Opayo Direct.
On this page:
Integration
We have made Direct Payment requests as simple and secure as possible for you and your customers. You don’t need to store any card details. We hold them all securely for you so you can interact with your customer how you know best.
The following pages detail how we take and process a payment with Opayo Direct:
- The customer orders from your site
- Your server registers the payment with Opayo
- Opayo replies to your registration POST
- Opayo submits 3D Secure Authentication
- You redirect your customer to their Issuing Bank
- 3D-Authentication and your site called back
- Your site POSTs the 3D Secure results to Opayo
- Opayo servers request card authorisation
- Opayo replies to your POST
- Opayo sends Settlement Batch Files
Payments Overview
Your customer's payment experience starts on your website. When they are ready for checkout you:
- Collect your customer’s:
- Name
- Billing address
- Delivery address
- Contact details (phone number and, or email address, etc.)
- Optionally, you can offer a pathway to sign up for quicker purchases in future.
- Total the basket value including taxes and shipping, etc.
- Present a summary of the transaction to your customer. Ask them to agree and continue with their payment.
- Store the transaction and customer data in your database for reuse later.
- Use your payments page secured with your SSL certificate to collect your customer’s:
- Cardholder Name as printed on the card
- Card Type (Visa, MasterCard, American Express, etc.)
- Card Number (removing spaces or other separators entered to save your customer the work)
- Expiry Date
- Card Verification Value (CVV or CV2). This is either the 3 digits on the signature strip, or for American Express (AMEX) cards, the 4 numbers printed on the front.
- Cardholder’s Billing Address, including their Postcode (if not already stored in your database).
- When ready, ask your customer to confirm the transaction and to submit their payment.
- Send the form data to your server to validate. Example rules are:
- All required fields are competed.
- Expiry dates are not in the past.
- The card number is the correct number of figures.
- Have your server prepare and send an HTTPS POST to the Opayo gateway containing:
- VendorTxCode, which should be stored alongside the order details in your database.
- The correctly formatted and validated data from your form.
- Receive notice that the payment is processed and confirm the transaction’s success with your customer.
The payment should reach your account the next day.
Manage Your Transactions
Using Opayo Direct, you can manage:
- 3D Secure transactions
- Deferred transactions
- Repeat transactions
- Authenticate and Authorise transactions
- Storing a Credential on File
- Refund and Void transactions
- Declined payments
- SCA Exceptions
Related Pages