Gateway Hosted Integration Guide

Copyright Pay360 by Capita 2016 This document contains the proprietary information of Pay360 by Capita and may not be reproduced in any form or disclosed to any third party without the expressed written permission of a duly authorised representative of Pay360 by Capita. Registered in England No: 2081330. VAT Reg. No: 618184140 Pay360 by Capita Gateway Hosted v 3.0 23rd March 2016

Page 2 of 34

Table of Contents

1 In t roduct ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 Basic Concept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

3 POST The Mandatory Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.1 merchant .............................................................................................................................................................5 3.2 trans_id................................................................................................................................................................5 3.3 amount ................................................................................................................................................................5 3.4 callback ...............................................................................................................................................................5 3.5 digest ...................................................................................................................................................................5

4 The Payment Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

4.1 Adding Your Logo ................................................................................................................................................6

5 The Cal lback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

5.1 Referencing your Callback Page .........................................................................................................................7 5.2 Using Two Static Callback Pages ........................................................................................................................7 5.3 Using One, Dynamic, Callback Page ..................................................................................................................7 5.4 SSL Callbacks .....................................................................................................................................................8 5.5 Callback Parameters ...........................................................................................................................................8 5.5.1 trans_id............................................................................................................................................................. 8 5.5.2 valid .................................................................................................................................................................. 8 5.5.3 auth_code ......................................................................................................................................................... 8 5.5.4 cv2avs .............................................................................................................................................................. 9 5.5.5 message ........................................................................................................................................................... 9 5.5.6 resp_code ......................................................................................................................................................... 9 5.5.7 amount ............................................................................................................................................................. 9 5.5.8 code ................................................................................................................................................................. 9 5.5.9 test_status ...................................................................................................................................................... 10 5.5.10 hash ............................................................................................................................................................... 10 5.5.11 expiry .............................................................................................................................................................. 10 5.5.12 card_no .......................................................................................................................................................... 10 5.5.13 customer ......................................................................................................................................................... 10 5.5.14 currency.......................................................................................................................................................... 10 5.5.15 card_type ........................................................................................................................................................ 10 5.6 Mandating CV2 .................................................................................................................................................. 11 5.7 Supply your own callback parameters ............................................................................................................... 11 5.8 Customer redirection: -redir and -jredir .............................................................................................................. 11

6 Mult i -Cur rency Transact ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

7 Deferred Transact ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

7.1.1 deferred=true .................................................................................................................................................. 13 7.1.2 deferred=reuse ............................................................................................................................................... 13

8 CV2 / AVS: Secur i ty Code and Address Checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

8.1 CV2 ................................................................................................................................................................... 14 8.2 AVS: Address Verification System .................................................................................................................... 14 8.2.1 As individual parameters: ............................................................................................................................... 15 8.2.2 As one parameter in string format .................................................................................................................. 15 8.2.3 As One Parameter in XML Format ................................................................................................................. 15 8.2.4 Sending Shipping Address Details ................................................................................................................. 16 8.3 Configuring Automatic CV2/AVS Transaction screening ................................................................................... 16 8.3.1 CV2 ................................................................................................................................................................ 16 8.3.2 House no. ....................................................................................................................................................... 16 8.3.3 Postcode ........................................................................................................................................................ 16 8.3.4 Strict/Non-Strict .............................................................................................................................................. 16

9 Sending Order Deta i ls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

9.1 Order Details in String Format ........................................................................................................................... 16 9.2 Order Details in XML Format ........................