Getting Started
Introduction – Getting Started
Overview
Choosing an Integration Method
Getting Started Checklist
Direct Integration
Introduction – direct integration
Intended Audience – Direct Integration
Simplifying the Integration Process – Direct Integration
Important_Notes
Gateway URLs
Gateway Messages
Notation Explained
CardDetailsTransaction
Introduction
Request
Response
Response
Cross-Reference Transaction
CrossReferenceTransaction
Three-D-Secure Authentication
ThreeDSecureAuthentication
PayByLinkQuery
PayByLinkQuery
TransactionQuery
TransactionQuery
Get CardType
Get CardType
Get GatewayEntryPoints
Get Gateway Entry Points
Payment Gateway High Availability
Introduction – Direct Integration
Gateway Entry Points
Gateway Entry Point Metric
Gateway Entry Point Selection Methods
Entry Point State Awareness
Appendix 1: Gateway Response StatusCodes
Appendix 1: Gateway Response StatusCodes
Appendix 2: Message Schema Diagrams
CardDetailsTransaction – Request–PaymentMessage
Response – CardDetailsTransactionResponse
CrossReferenceTransaction
Request –PaymentMessage
Response – CrossReferenceTransaction
ThreeDSecureAuthentication
Request –ThreeDSecureMessage
Response –ThreeDSecureAuthentication
GetCardType
Request –GetCardTypeMessage
Response –GetCardTypeResponse
GetGatewayEntryPoints
Request – GetGatewayEntryPointsMessage
Response – GetGatewayEntryPointsResponse
Appendix 3: Example Messages
CardDetailsTransaction Request –CardDetailsTransaction
Response– CardDetailsTransactionResponse (Notrequiring3DSecure authentication)
Response–CardDetailsTransactionResponse (Requiring3DSecure authentication)
Cross Reference Transaction
Request –CrossReferenceTransaction
Response – CrossReferenceTransactionResponse
ThreeDSecure Authentication
Request –ThreeDSecureAuthentication
Response – ThreeDSecureAuthenticationResponse
Get Card Type
Request –GetCardType
Response –GetCardTypeResponse
Get Gateway Entry Points
Request –GetGatewayEntryPoints
Response – GetGatewayEntryPointsResponse
Appendix 4: Override Policy Codes & Explanations
OverrideAVSPolicy Codes
Character 1 Codes
Character 2 Codes
Character 3 Codes Explanation
Character 4 Codes
Examples
Questions
OverrideCV2Policy Codes
Direct Integration Guide Character 1 Codes
Character 2 Codes
Examples
Direct Integration Questions
Appendix 5: List of Card Types
Appendix 5: List of Card Types
Appendix 6: The 3D Secure System
The 3D Secure System Explained
API Transaction Flow – Including 3D Secure Authentication
API Transaction Flow – Including 3D Secure Authentication
API Transaction Flow – 3D Secure Disabled or Card Not Enrolled
API Transaction Flow – 3D Secure Disabled or Card Not Enrolled
API Transaction Flow – 3D Secure Disabled
API Transaction Flow – 3D Secure Disabled
ACS Simulator 4 possible conditions
Appendix 7: Country (ISO 3166-1) Codes
Appendix 7: Country (ISO 3166-1) Codes
Appendix 8: Currency (ISO 4217) Codes
Appendix 8: Currency (ISO 4217) Codes – Payb
Hosted Payment Form
Introduction – Hosted Payment form
Intended Audience – Hosted Payment Form
Simplifying the Integration Process
Important Notes
Gateway URLs
Hashing Explained
Simple Hashing Example
Notation Explained
Notation Explained
Data Types
Result Delivery Methods
Result Delivery Methods
POST
SERVER
SERVER_PULL
Required Input Variables
Required Input Variables
Incoming Hash Digest
Incoming Hash Digest | Hash Data
Result Delivery Methods – Implementation
POST Result Delivery Method
Output Variables
Outgoing Hash Digest
Request Variables Pushed To Merchants ServerResultURL
Request Hash Digest Pushed To Merchants ServerResultURL
Expected Response From Merchant’s ServerResultURL
SERVER Output Variables
SERVER Output Hash Digest
SERVER_PULL Result Delivery Method
SERVER_PULL Output Variables
SERVER_PULL Output Hash Digest
SERVER_PULL Request Variables
Transaction Result PULL Response
SERVER_PULL Transaction Result Variables
SERVER Result Delivery Method
Appendix 1: Gateway Response Status Codes
Appendix 1: Gateway Response Status Codes
Appendix 2: Transaction Data Flow
SERVER Result Delivery Method
Appendix 2: Transaction Data Flow
All Result Delivery Methods
POST Result Delivery Method
POST Transaction Flow – Including 3D Secure Authentication
POST Transaction Flow – 3D Secure Card Not Enrolled
POST Transaction Flow – 3D Secure Disabled (MMS Settings)
SERVER Transaction Flow – Including 3D Secure Authentication
SERVER Transaction Flow – 3D Secure Card Not Enrolled
SERVER Transaction Flow – 3D Secure Disabled (MMS Settings)
SERVER_PULL Result Delivery Method
SERVER_PULL Transaction Flow – Including 3D Secure Authentication
SERVER_PULL Transaction Flow – 3D Secure Card Not Enrolled
SERVER_PULL Transaction Flow – 3D Secure Disabled (MMS Settings)
Appendix 3: Example HPF Messages
POST Result Delivery Method – Request
SERVER Result Delivery Method – Request
SERVER Result Delivery Method – Reply to Gateway Response
SERVER_PULL Result Delivery Method – Request
Hosted Payment Form – Response
Appendix 4: Transaction Result Status Codes
Appendix 4: Transaction Result Status Codes
Appendix 5: Override Policy Codes & Explanations
Override AVS Policy Codes
Hosted Payment Form Character 1 Codes
Character 2 Codes
Character 3 Codes
Character 4 Codes
Examples
Questions
Override CV2 Policy Codes
Character 1 Codes
Character 2 Codes
Examples
Hosted Payment Form Questions
Appendix 6: Country (ISO 3166-1) Codes
Appendix 6: Country (ISO 3166-1) Codes
Appendix 7: Currency (ISO 4217) Codes
Appendix 7: Currency ISO 4217 Codes (2)
Transparent Redirect
Introduction – transparent redirect
Intended Audience – Transparent Redirect
Simplifying the Integration Process – Transparent Redirection
Important Notes
Gateway URLs
Hashing Explained
Simple Hashing Example
Notation Explained
Data Types
"Initial Request"
Input Variables
Incoming Hash Digest
3D Secure "Authentication Required"
Output Variables
Outgoing Hash Digest
3D Secure "Post Authentication"
Input Variables
Incoming Hash Digest | Hash Codes
"Payment Complete"
Output Variables
Outgoing Hash Digest
Appendix 1: Gateway Response Status Codes
Appendix 1: Gateway Response Status Codes | Payb
Appendix 2: Transaction Data Flow
Appendix 2: Transaction Data Flow
Transparent Redirect Data Transaction Flow – Including 3D Secure Authentication
Transparent Redirect Transaction Flow – 3D Secure Card Not Enrolled
Transparent Redirect Transaction Flow – 3D Secure Disabled (MMS Setting)
ACS Simulator – Integration Guide
Appendix 3: Example Transparent Redirect Messages
Initial Request
3D Secure Authentication Required – Response
3D Secure Post Authentication – Response
3D Secure Post Authentication – Request
Transaction Complete – Response
Appendix 4: Transaction Result Status Codes
Appendix 4: Transaction Result Status Codes
Appendix 5: Override Policy Codes & Explanations
OverrideAVSPolicy Codes
Character 1 Codes
Character 2 Codes
Character 3 Codes Payb
Character 4 Codes
Examples
Questions
OverrideCV2Policy Codes
Character 1 Codes
Character 2 Codes
Examples
Questions
Appendix 6: Country (ISO 3166-1) Codes
Appendix 6: Country (ISO 3166-1) Codes
Appendix 7: Currency (ISO 4217) Codes
Appendix 7: Currency (ISO 4217) Codes
Digital Wallet Integration
Introduction – digital wallet integration
Using Digital Wallets with the ai Gateway
APM specific data elements and values
The transaction details
1.1 Merchant Responsibilities
1.2 Accepted Wallet Types
1.3 Sample Wallet Transaction
Plugins
Woocommerce
1. Introduction
2. Installation Instructions
3. Plugin Configuration
4. Setting Plugin Live
Shopify
1. Installing the Payment Gateway for Shopify
MMS
Registration and Logging In
1. Registration
2. Logging in
MMS Navigation
1. MMS Navigation
Account Admin
1. Account Settings
Request –ThreeDSecureMessage
This describes the root ThreeDSecureMessage node of the ThreeDSecureAuthentication request message
Next Post
Response – CrossReferenceTransaction
Previous Post
Response –ThreeDSecureAuthentication
Menu
