Integration Guide

Table Of Contents
Contents
6 April 2012 PayPal Payments Pro Integration Guide
URL Decoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Appendix B Implementing 3-D Secure Transactions (UK Only) . . . . .87
Introduction to 3-D Secure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Integration Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Cardinal Commerce Registration and Installation . . . . . . . . . . . . . . . . . . . . . . 88
Transaction Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
URL to Handle Issuer’s Response. . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Transaction Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
3-D Secure Fields for Direct Payment Transaction Requests . . . . . . . . . . . . . . 92
Website Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Example 1: Successful 3-D Secure Authentication . . . . . . . . . . . . . . . . . . . 94
Example 2: 3-D Secure with Unsuccessful Authentication . . . . . . . . . . . . . . . 94
Example 3: Card Issuer Not Using 3-D Secure . . . . . . . . . . . . . . . . . . . . . 95
Example 4: Merchant Not Using 3-D Secure . . . . . . . . . . . . . . . . . . . . . . 95
Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
cmpi_lookup API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
cmpi_lookup Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
cmpi_lookup Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Issuer Authentication Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Issuer Authentication Request. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Issuer Authentication Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
cmpi_authenticate API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
cmpi_authenticate Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
cmpi_authenticate Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98