Transcription
Gateway Freedom Integration GuideCopyright Pay360 by Capita 2016This document contains the proprietary information of Pay360 by Capita and may not be reproduced in any form ordisclosed to any third party without the expressed written permission of a duly authorised representative of Pay360 byCapita.Registered in England No: 2081330. VAT Reg. No: 618184140Pay360 by Capita Gateway Freedom v 3.023rd March 2016
Table of Contents1Introduction . 52Basic setup . 53P O S T t h e Ma n d a t o r y P a r a m e t e r s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63.13.23.33.43.54merchant .6trans id.6amount .6callback .6digest .6Th e C a l l b a c k . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.74.8Referencing your Callback Page .7Using Two Static Callback Pages .7Using One, Dynamic, Callback Page .7SSL Callbacks .8Callback Parameters .8trans id. 8valid . 8auth code. 8cv2avs . 9message . 9resp code. 9amount . 9code . 9test status . 10hash . 10expiry . 10card no . 10customer. 10currency. 10card type. 10Mandating CV2.11Supply your own callback parameters .11Customer redirection: -redir and -jredir .115Mu l t i - C u r r e n c y T r a n s a c t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 26CV2 / AVS: Security Code and Address Checks . 47CV2 .12AVS: Address Verification System .13As individual parameters: . 13As one parameter in string format . 13As One Parameter in XML Format . 13Sending Shipping Address Details . 14Configuring Automatic CV2/AVS Transaction screening .14CV2 . 14House no. . 14Postcode . 14Strict/Non-Strict . 14Sending Order Details . 147.17.2Order Details in String Format .14Order Details in XML Format .158Sending Custom Parameters . 169Optional Parameters . 169.19.29.3backcallback .16amex.17auth code.17Page 2 of 44
9.49.59.69.7map flds .17usage type .17allowed ct .18banned ct.1810 Emails . 1810.110.210.310.410.510.6mail attach customer .19mail attach merchant .19mail html .20mail customer .20mail merchants .20mail subject .2111 Security . 2111.111.211.2.111.2.211.311.3.111.3.211.3.3What is MD5? .21Authentication from You to Pay360 by Capita (using the remote password) .22Creating Your Encrypted Digest Parameter . 22Ensuring Pay360 by Capita checks for Authentication . 22Authentication from Pay360 by Capita to You (using the digest key) .23Creating a GET Request hash . 23Creating a POST Request hash . 24Customising the md flds . 2412 Iframes . 251 3 U s i n g t h e P a y3 6 0 b y C a p i t a A P I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 rotocols .26XMLRPC . 26SOAP . 26Real-time Transactions.26Real-time Transaction Request Parameters. 26Real time Transaction Response Parameters .27Additional Response Parameters . 28Example XMLRPC Request .29Example XMLRPC Response .29Example SOAP Request .3014 Refund Transactions . 3014.114.214.2.114.2.214.2.314.2.4Refund Transaction Request Parameters .30Refund Transaction Response Parameters.31Example XMLRPC Refund Request . 31Example XMLRPC Refund Response . 31Example SOAP Refund Request . 31Example SOAP Refund Response . 3215 Placing Deferred Transactions . 3216 Releasing Deferred Transactions . 3316.1Release Request Parameters .3317 Cancelling Deferred Transactions . 3418 Performing Repeat Transactions . 3418.1Repeat Request Parameters .3419 Optional Parameters . 362 0 Tr a n s a c t i o n R e p o r t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 720.1Transaction Report Parameters .372 1 Te s t i n g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 821.121.221.3test status .38dups .38default cv2avs .382 2 P a y3 6 0 b y C a p i t a C u s t o m H o s t e d P a ym e n t P a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 9Page 3 of 44
22.122.222.322.422.5Customising Your Template .39Uploading Your Template .40Referencing Your Template.40Customising the err template.40Customising Payment Page Error Messages .412 3 P r e ve n t i n g F r a u d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 123.123.23D Secure .41SecGuard .412 4 G o i n g L i ve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 124.124.224.324.424.5Have you gone live with the bank? .41Are you still using a test account? .42Are you still in test mode? .42Are you still using “dups false”?.42Have you enabled 3
merchant trans_id amount callback digest 3.1 merchant This is your Pay360 by Capita username (usually six letters followed by two numbers) Example abcdef01 3.2 trans_id A unique transaction identif
