Integration Testing

Quick Find

Go straight to the section you need.

1.0 Gateway Integration →

1.1 Introduction

1.2 Terminology

1.3 Integration Methods

1.4 Integration Libraries

1.5 Security and Compliance

1.6 Prerequisites

1.7 Integration Details

1.8 Authentication

1.9 Supported Actions

2.0 New Transactions →

2.1 Request Fields

2.2 Response Fields

3.0 Management Requests →

3.1 Request Fields

3.2 Response Fields

4.0 AVS/CV2 Checking →

4.1 Background

4.2 Benefits and Limitations

4.3 Request Fields

4.4 Response Fields

5.0 3-D Secure Authentication →

5.1 Background

5.2 Benefits and Limitations

5.3 Hosted Implementation

5.4 Direct Implementation

5.5 Request Fields

5.6 Response Fields

5.7 Advanced Features

11 Receipts and Notifications →

11.1 Background

11.2 Customer Email Receipts

11.3 Request Fields

11.4 Response Fields

17 Advanced Data →

17.1 Customer Request Fields

17.2 Merchant Request Fields

17.3 Supplier Request Fields

17.4 Delivery Request Fields

17.5 Receiver Request Fields

17.6 Shipping Request Fields

17.7 Device Information Fields


19 Gateway Wallet → 

19.1 Background

19.2 Benefits and Limitation

19.3 Hosted

19.4 Direct Implentation

19.5 Request Fields

19.6 Response Fields


26 Digital Wallet Transactions →

26.1 Background

26.2 Benefits and Limitations

26.3 Configuration

26.4 Hosted Implementation

26.5 Direct Implementation

26.6 Request Fields

26.7 Response Fields

26.8 Digital Wallet Tokens


A-1 Response Codes

A-1.1 Authorisation Response Codes

A-1.2 Gateway Response Codes

A-2 AVS / CV2 Check Response Codes

A-3 Secure Authentication Data

A-4 3-D Secure Enrolment/Authentication Only

A-9 Duplicate Transaction Checking

A-10 Capture Delay

A-11 Card Identification

A-12 Integration Testing

12.1 Test Amounts

12.2 Test Cards

12.3 3-D Secure Testing


A-13 Sample Signature Calculation

A-14 Transaction Life cycle

A-14.1 Authorise, Capture and Settlement

A-14.2 Transaction States

A-15 Transaction types

A-15.1 E-commerce (ECOM)

A-15.2 Mail Order/Telephone Order (MOTO)

A-15.3 Continuous Authority (CA)


A-16 Payment Tokenisation


A-16.2 REFUND_SALE requests

A-16.3 CANCEL or CAPTURE requests

A-16.4 QUERY requests

A-16.5 SALE or REFUND Referred Authorisation requests


A-18 PSD2 SCA Compliance

A-18.1 Obtaining Strong Customer Authentication

A-18.2 SCA Soft-Declines

A-18.3 Exemptions to Strong Customer Authentication

A-18.4 SCA Using 3-D Secure


A-19 Hosted Payment Page Options

A-20 Integration Libraries

A-20.1 Gateway Integration Library

A-20.2 Hosted Payment Page Library

A-20.3 Hosted Payment Fields Library


A-21 Example HTTP Requests

A-21.1 Hosted Integration

A-21.2 Direct Integration

A-21.3 Batch Integration


A-22 Example Integration Code

A-22.1 Hosted Integration

A-22.2 Direct Integration

A-22.3 Batch Integration


A-23 Example Library Code

A-23.1 Gateway Integration Library

A-23.2 Hosted Payment Page Library

A-23.3 Hosted Payment Fields Library

A-12 Integration Testing

You will be provided with unique test Merchant Account IDs during the onboarding process. Refer to section 1.6 for more information. 

Test Merchant Accounts are not connected to our Simulator and not to an actual Acquirer. The Simulator will emulate the function of an Acquirer and provide simulated responses and authorisation codes.

A-12.1 Test Amounts

When testing the transaction amount can be used to trigger different authorisation and settlement outcomes as follows:

Any other amount will return a responseCode of 66311 (Invalid Test Amount)

The settlement outcome only applies to transactions which reach settlement due to being successfully authorised and captured and not cancelled. The amount captured is used when determining the settlement outcome rather than the amount authorised.

The range 5000 to 9999 can be used to test manual authorisations. If the transaction does not contain an authorisationCode request field, then the Simulator will return a responseCode of 1 (CARD REFERRED). If it does, then it will return a responseCode of 0 (SUCCESS), with an amount between 50000 and 7499 being accepted at settlement and an amount of 7500 to 9999 being rejected. 

The range 20000 to 29999 can be used to test SCA soft declines. If the transaction is eligible1 to request SCA then the Simulator will return a responseCode of 65 (SCA REQUIRED). If not, then it will return a responseCode of 0 (SUCCESS) for the range 20000 to 24999 or 5 (DO NOT HONOR) for the range 25000 to 29999. Successful transactions will be approved at settlement. 


A-12.2 Test Cards

The test accounts will only accept card numbers that are designated for test purposes. These test cards cannot be used on production accounts. 

To test AVS and CV2 verification then the associated CVV and billing addresses are provided for each card. If a different value is used, then the Simulator will mark the responses as ‘not matched’. 

Unless stated otherwise an expiry date sometime in the near future should be used.


A-12.2.1 Visa Credit 

Card Number
Flat 6, Primrose Rise, 347 Lavender Road, Northampton, NN17 8YG
Card Number
76 Roseby Avenue, Manchester, M63X 7TH
Card Number
23 Rogerham, Mansions, 4578 Ermine Street,Borehamwood, WD54 8TH

A-12.2.2 Visa Debit

Card Number
Unit 5, Pickwick Walk, 120 Uxbridge Road, Hatch End, Middlesex, HA6 7HJ
Card Number
Mews 57, Ladybird Drive, Denmark 65890

A-12.2.3 Electron

Card Number
5-6 Ross Avenue ,Birmingham, B67 8UJ

A-12.2.4 Mastercard Credit

Card Number
25 The Larches, Narborough, Leicester, LE10 2RT
Card Number
Pear Tree Cottage, The Green, Milton, Keynes, MK11 7UY
Card Number
34a Rubbery Close, Cloisters Run, Rugby, CV21 8JT
Card Number
4-7 The Hay Market, Grantham, NG32 4HG

A-12.2.5 Mastercard Debit

Card Number
5573 4712 3456 7898
Merevale Avenue, Leicester, LE10 2BU

A-12.2.6 UK Maestro

6759 0150 5012 3445 002
The Parkway ,5258 Larches Approach, Hull, North Humberside, HU10 5OP
6759 0168 0000 0120 097
The Manor, Wolvey Road, Middlesex, TW7 9FF

A-12.2.7 JCB

Card Number
2 Middle Wallop, Merideth-in-the-Wolds, Lincolnshire, LN2 8HG

A-12.2.8 American Express

Card Number
The Hunts Way, Southampton, SO18 1GW

A-12.2.9 Diners Club

Card Number
Address 1
1 Diners Club do not support the Address Verification Service (AVS). For testing purposes, we advise that a separate
Merchant Account is used with AVS is turned off.

A-12.3 3-D Secure Testing

Your test accounts are connected to our 3-D Secure Product Integration Testing (PIT) system rather than to the production 3-D Secure servers. 

You can use any of the test cards provided in section A-12.2 with this PIT system and can test various enrolment and authentication scenarios as follows. 


A-12.3.10 3-D Secure version 1

For 3-D Secure v1 all the standard test card numbers will show as enrolled except for:

Card Number
Unenrolled card
Card Number
Unknown enrolment status
Card Number
Error due timeout communicating with the Directory Server
Card Number
Error due to corrupt response from the Directory Server

The desired authentication status (threeDSAuthenticated) can be selected on the challenge dialog shown by the PIT Access Control Server.

A-12.3.11 3-D Secure version 2

For 3-D Secure v2 all the standard test cards will show as enrolled, and the authentication status returned by the Directory Server (for frictionless flow simulation) can be selected using the value of the card expiry month as follows: 

Card Expiry Month
01 - Jan
Auth Status
Simulation (Frictionless)
Fully authenticated
Card Expiry Month
02 - February
Auth Status
Simulation (Frictionless)
Not authenticated
Card Expiry Month
03 - March
Auth Status
Simulation (Frictionless)
Unknown authentication status
Card Expiry Month
04 - April
Auth Status
Simulation (Frictionless)
Attempted authentication
Card Expiry Month
05 - May
Auth Status
Simulation (Frictionless)
Decoupled authentication
Card Expiry Month
06 - June
Auth Status
Simulation (Frictionless)
Transaction rejected (do not attempt to send for authorisation)
Card Expiry Month
07 – July
Auth Status
Simulation (Frictionless)
Unknown error performing 3-D Secure checks
Card Expiry Month
08 - August
Auth Status
Simulation (Frictionless)
Error due to timeout communicating with the Directory Server
Card Expiry Month
09 – September
Auth Status
Simulation (Frictionless)
Error due to corrupt response from the Directory Server.
Card Expiry Month
10 – October
Auth Status
Simulation (Frictionless)
Information only
Card Expiry Month
11 – November
Auth Status
Simulation (Frictionless)
Unknown authentication due to Cardholder not enrolled (error 13)
Card Expiry Month
12 - December
Auth Status
Simulation (Frictionless)
Frictionless not possible, challenge Cardholder

An expiry month of 12 will simulate the non frictionless flow and desired authentication status (threeDSAuthenticated) can be selected on the challenge dialog shown by the PIT Access Control Server. 

When using an expiry month from the above table please use a suitable expiry year to ensure the date is sometime in the near future.

Integrated Payments - connecting your till to your terminal

Integrated payments - connecting your EPOS till to your card terminal - enables your business to process payments faster and increase your profits.

There are many benefits to an integrated solution for almost all business types, most importantly, the removal of human error, giving you accurate reporting from all tills and terminals.

At Swipen, we offer Integrated Payments free of charge and you can use our Pay at Table or Pay at Counter software, or both if it suits your business:

Pay at Table

A software design with restaurants in mind:

Split the bill at the table

Automatic table closing

Integrated gratuity & reporting

Turn tables faster

More efficient payment

Pay at Counter

Suitable for most businesses, offering:

Faster payments

Shorter queues

Better conversion

Greater profits

COVID secure

Discover which terminal type is best for your business









Retail & Shops

Take your payments to the next level

E-Commerce Payment Solutions

With the arrival of Covid-19 into all our lives, online only payments are looking to have a bright future that’s here to stay.

At Swipen, we want to bust the myth that taking payments online is complicated, and help you
adapt to this changing world.

We offer two types of E-Commerce payment solution either directly integrated with your website or a hosted payment page.

Directly Integrated

Integrated into your own website

Completely customisable

Branded to your business

Customers stay on your website

150 currencies supported

Shopping carts

No long-term contract

Alternative payment methods, including: Alipay, Apple Pay, Google Pay, WeChatPay

Hosted Payment Page

Easy to set up

Take payments in minutes

Swipen branded

Data processed by Swipen

150 currencies supported

Shopping carts

No long-term contract

Alternative payment methods, including: Alipay, Apple Pay, Google Pay, WeChatPay

Take your payments to the next level

Virtual Terminal - Taking Payments over the Phone

Many businesses find it useful to take payments over the phone, whether you’re a travel agent
needing to take deposits, a mobile tradesperson, travelling salesperson, you have a call centre, or you don’t have a website to take payments online.

Swipen’s Virtual Terminal allows you to take card payments over the phone quickly and securely.

Our solution is a web portal that can be used on a desktop, tablet or mobile device.

Virtual Terminal Key Features

More secure than a card terminal - Completing the payment over the phone with full customer details reduces the risk of chargebacks or fraud.

Pay By Link - Send a payment link to complete the purchase or pay a balance. This is also a useful feature for customers who prefer to not give their details over the phone.

Capture Customer Details - The Virtual Terminal allows you to capture all the customer details you will need for your CRM or Booking Systems reducing the need for double inputting.

Control Permissions - Restrict user access to only certain functionality so you can control what your staff can process and see.

Take Payments anywhere - The Virtual Terminal is compatible to all devices and allows you to take payments from anywhere - office, home or on the move in a safe and secure way.

Ideal for call centres, travel agents, travelling salespeople, mobile tradespeople, restaurants for pre-bookings and parties, hotels for rooms and events, or any business that doesn’t have a website that customers can pay through.

Take your payments to the next level

Web & App Solutions - Order and Pay-at-Table Platform

With COVID regulations in force across the country, restaurants and pubs are adjusting the way they work to reduce the spread of this virus.

Swipen are also adapting to these changing times, and working with our expert partners, we can now offer order and pay-at-table platforms, allowing you to benefit from cashless and cardless payment options.

Our solutions can be either Web or App based and we provide the choice between
a ‘Simple Solution’ and a ‘Bespoke Solution’, depending on the size of your business

Bespoke Solution

The best option for individual pubs and restaurants, small chains, or if location offers a different menu:

Use your own branding

At table QR code or WiFi login

Bespoke rates and fees

Links to your EPOS till *

*Depending on the EPOS company

Simple Solution

Ideal for larger chains where every location requires exactly the same functionality and offers the same menu:

Custom built to fit your business

Customers can access the way you want

Links to both your till and kitchen

No training required

Working with Pizza Hut

Swipen have helped create a bespoke value-for money solution for Pizza Hut, and we could do the same for you.

Get in contact to find out more.

Take your payments to the next level

Tip Per Tap -Contactless Tipping System

With the dawn of cashless and touchless checkouts along with app ordering systems and pay online methods, many restaurants, bars, cafés and hotels are finding that their waiting staff are no longer able to receive cash or card tips.

Swipen has the perfect solution: the new ‘Tip Per Tap’ Contactless Tipping System

Directly Integrated

A dedicated terminal is placed in a prominent location in your restaurant.

The terminal is set to ‘donation’ and the debit amount is set at a specific figure. e.g. £2

Your happy customers simply tap their card, phone or watch against the terminal to leave a £2 tip.

They can tap multiple times to leave a larger amount

Works automatically without the need for a member of staff to supervise.

End-of-day report is separate, making it quicker and easier to share the total tips received between staff members.

How about a little Tip Per Tap

Read our blog all about our new Tip Per Tap Contactless Tipping System.

Get in contact to find out more.

Take your payments to the next level