Developer's Guide

Contents
4 Website Payments Pro Developer’s Guide
Chapter 4 Performing Direct Payment Credit Card Transactions . . .21
How Direct Payment Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
About Direct Payment Credit Card Processing . . . . . . . . . . . . . . . . . . . . . . . 22
Considerations Regarding Your Website Integration . . . . . . . . . . . . . . . . . . 23
Parameters Used in Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Additional Parameters by Transaction Type . . . . . . . . . . . . . . . . . . . . . . . . . 29
Submitting Sale Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
When to Use a Sale Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Additional Parameters for Sale Transactions . . . . . . . . . . . . . . . . . . . . . . 30
Typical Sale Transaction Parameter String . . . . . . . . . . . . . . . . . . . . . . . 30
Submitting Authorisation/Delayed Capture Transactions . . . . . . . . . . . . . . . . . . 31
Required Authorisation Transaction Parameters . . . . . . . . . . . . . . . . . . . . 31
Typical Authorisation Transaction Parameter String . . . . . . . . . . . . . . . . . . . 31
Required Delayed Capture Transaction Parameters . . . . . . . . . . . . . . . . . . 32
Delayed Capture Transaction: Capturing Transactions for Lower Amounts . . . . . . . 33
Delayed Capture Transaction: Capturing Transactions for Higher Amounts . . . . . . 34
Delayed Capture Transaction: Error Handling and Retransmittal . . . . . . . . . . . . 35
Submitting Credit Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Required Credit Transaction Parameters . . . . . . . . . . . . . . . . . . . . . . . . 35
Credit Transaction Parameter Strings . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Submitting Void Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
When to Use a Void Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Required Void Transaction Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 36
Example Void Transaction Parameter String . . . . . . . . . . . . . . . . . . . . . . 37
Recharging to the Same Credit Card (Reference Transactions). . . . . . . . . . . . . . . 37
When to Use a Reference Transaction . . . . . . . . . . . . . . . . . . . . . . . . . 37
Transaction Types that Can Be Used as the Original Transaction . . . . . . . . . . . 38
Fields Copied from Reference Transactions. . . . . . . . . . . . . . . . . . . . . . . 38
Example Reference Transaction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Using Address Verification Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Example AVS Request Parameter String . . . . . . . . . . . . . . . . . . . . . . . . 40
Example AVS Response. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Card Security Code Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
American Express Card Security Code Enhancements . . . . . . . . . . . . . . . . . 41
Example CVV2 Request Parameter String . . . . . . . . . . . . . . . . . . . . . . . 42
Example CVV2 Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42