Developer's Guide

Performing Direct Payment Credit Card Transactions
Submitting Sale Transactions
4
30 Website Payments Pro Developer’s Guide
When to Use a Sale Transaction
A Sale transaction is best suited to businesses that provide immediate fulfilment for their
products or services. Electronic goods merchants, for example, who fulfil orders immediately
can use Sale transactions. If your business does not provide immediate fulfilment, then credit
card association rules recommend that you use the Authorisation and Delayed Capture model.
For details, see “Submitting Authorisation/Delayed Capture Transactions” on page 31. If you
need to recharge a credit card and you are not storing the credit card information in your local
database, you can perform a new reference transaction based on a Sale transaction. For details,
see “Recharging to the Same Credit Card (Reference Transactions)” on page 37.
Additional Parameters for Sale Transactions
To perform a Sale transaction, you are required to pass the following parameters:
ACCT
AMT
EXPDATE
Typical Sale Transaction Parameter String
The following is a typical PARMLIST string passed in a Sale transaction.
EXAMPLE 4.1 Typical Sale transaction parameter string
"TRXTYPE=S&TENDER=C&USER=SuperMerchant&PWD=SuperUserPassword&PARTNER=PayPal
UK&ACCT=5105105105105100&EXPDATE=1209&AMT=99.06&COMMENT1=Reservation&FIRSTN
AME=John&LASTNAME=Jones&STREET=123 Main St.&CITY=San
Jose&STATE=CA&ZIP=123451234&COUNTRY=US&CVV2=123&CLIENTIP=0.0.0.0"
Note that, besides the required parameters that you pass in a Sale transaction, this string
includes other typical parameters. PayPal recommends that you include the account holder’s
FIRSTNAME and LASTNAME. PayPal also recommends including CLIENTIP to help detect
possible fraud. The COMMENT1 field helps to track transaction information. The customer’s
postal address (STREET) and ZIP (postcode) should be passed to use the Address Verification
Service (AVS). CVV2 is needed for card security code validation. For details on AVS and card
security code, see the following sections:
z “Using Address Verification Service” on page 39
z “Card Security Code Validation” on page 40
The following is a typical set of Response parameters. See Chapter 8, “Responses to
Transaction Requests,” for details on response parameters.
EXAMPLE 4.2 Typical response parameters
RESULT=0&PNREF=EFIP0D391C30&RESPMSG=Approved&AVSADDR=N&AVSZIP=Y&CVV2MATCH=X
&PPREF=7XX11903GL026951F&CORRELATIONID=3a5df0066697a