Developer's Guide

Gateway Developer Guide and Reference 07 January 2014 5
Content
Handling Credit Card Type Information . . . . . . . . . . . . . . . . . . . . . . . . . 60
Core Credit Card Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Submitting Account Verifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
When To Use Account Verifications . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Required Account Verification Parameters . . . . . . . . . . . . . . . . . . . . . . . 64
Example Account Verification String . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Submitting Authorization/Delayed Capture Transactions . . . . . . . . . . . . . . . . . . 65
When to Use Authorization/Delayed Capture Transactions . . . . . . . . . . . . . . . 65
Required Authorization Transaction Parameters . . . . . . . . . . . . . . . . . . . . 66
Submitting Balance Inquiry Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Processing Platforms Supporting Balance Inquiry Transactions . . . . . . . . . . . . 66
Required Balance Inquiry Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . 67
Example Balance Inquiry Transaction String . . . . . . . . . . . . . . . . . . . . . . 67
Submitting Card Present (SWIPE) Transactions. . . . . . . . . . . . . . . . . . . . . . . 67
Processing Platforms Supporting Card-Present Transactions. . . . . . . . . . . . . . 68
Card Present Transaction Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Submitting Credit (Refund) Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Required Credit Transaction Parameters . . . . . . . . . . . . . . . . . . . . . . . . 69
Submitting Inquiry Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
When To Use an Inquiry Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Required Parameters When Using the PNREF . . . . . . . . . . . . . . . . . . . . . 71
Inquiry Transaction Parameter String Using the PNREF . . . . . . . . . . . . . . . . 72
Required Parameters When Using the CUSTREF . . . . . . . . . . . . . . . . . . . 72
Inquiry Transaction Parameter String Using the CUSTREF . . . . . . . . . . . . . . . 73
Required Parameters When Using the Secure Token . . . . . . . . . . . . . . . . . . 73
Inquiry Parameter String Using the Secure Token. . . . . . . . . . . . . . . . . . . . 73
Submitting Partial Authorizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
When To Use Partial Authorizations . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Required Partial Authorization Parameters . . . . . . . . . . . . . . . . . . . . . . . 74
Example Partial Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Submitting Purchasing Card Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Submitting Reference Transactions (Tokenization) . . . . . . . . . . . . . . . . . . . . . 75
When To Use a Reference Transaction . . . . . . . . . . . . . . . . . . . . . . . . . 76
Transaction Types That Can Be Used As the Original Transaction . . . . . . . . . . . 76
Fields Copied From Reference Transactions . . . . . . . . . . . . . . . . . . . . . . 76
Example Reference Transaction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Data Upload - Storing Credit Card Data on the Gateway Server . . . . . . . . . . . . 78
Submitting Sale Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
When To Use a Sale Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79