Developer's Guide

Gateway Developer Guide and Reference 07 January 2014 75
Submitting Credit Card Transactions
Submitting Purchasing Card Transactions
6
Approval&AUTHCODE=11111&HOSTCODE=E&PROCAVS=U&TRANSTIME=2010-04-21
11:30:45&AMT=80.00&ORIGAMT=100.00&BALAMT=0&ACCT=1111&EXPDATE=0119&IAVS=X
RESPMSG is Partial Approval, AMT is now the actual amount approved, ORIGAMT is
the original requested amount, and BALAMT is the balance on the card.
Since the amount charged is greater than the amount available on the card, the response
sets the balance amount (BALAMT) to zero. If BALAMT is zero, check if there is a balance
due by comparing the original amount to the amount charged (ORIGAMT-AMT).
4. You can choose to perform one of the following tasks:
– Accept the $80.00 and request an alternate payment from the buyer for the additional
$20.00.
– Reject the partial authorization by sending the card issuer an authorization reversal
(void) for $80.
Submitting Purchasing Card Transactions
A purchasing card (also referred to as a commercial card, corporate card, procurement card or
business card) is a credit card that an employer requests to be issued. A purchasing card is
usually reserved for business-related charges. The card issuer provides specialized reporting
for this card type so the employer can monitor the use of the card. There is no method for
determining whether a card is a purchase card or a commercial card based on the card number.
To obtain the best bank interchange rates for commercial cards, pass specific additional
transaction information. Purchasing card support and parameters vary from processor to
processor. See “Submitting Purchasing Card Level 2 and 3 Transactions” on page 163.
NOTE: The PayPal processor does not support purchasing card transactions.
Submitting Reference Transactions (Tokenization)
To recharge a credit card when you are not storing the credit card information in your local
database, you can perform a reference transaction. A reference transaction takes the existing
credit card information that is on file and reuses it. (Securely storing data for future reference
is also known as tokenization.)
The PNREF returned in the original transaction is valid for use in reference transactions for 12
months. You can also use the PNREF account verification returns in a reference transaction.
When To Use a Reference Transaction
Say that Joe Smith purchases a holiday gift from your website store and requests that you send
it by UPS ground service. That evening, Joe becomes concerned that the item might not arrive
in time for the holiday. So Joe calls you to upgrade shipping to second-day air. You obtain
Joe’s approval for charging an extra $10 for the upgrade. In this situation, you can create a