2009

Recurring Payments and Reference Transactions API Operations
DoReferenceTransaction API
136 08 April 2009 Name-Value Pair API Developer Guide
Ship To Address Fields
Payment Details Type Fields
Field Description
SHIPTONAME Person’s name associated with this address. This field is required for
shipping addresses but is optional for credit card billing addresses.
Character length and limitations: 32 single-byte characters.
SHIPTOSTREET First street address. This field is required if the shipping address is used.
Character length and limitations: 100 single-byte characters.
SHIPTOSTREET2 (Optional) Second street address.
Character length and limitations: 100 single-byte characters.
SHIPTOCITY Name of city. This field is required if the shipping address is used.
Character length and limitations: 40 single-byte characters.
SHIPTOSTATE State or province. This field is required if the shipping address is used.
Character length and limitations: 40 single-byte characters.
SHIPTOZIP U.S. ZIP code or other country-specific postal code. This field is required if
a U.S. shipping address is used and may be required for other countries.
Character length and limitations: 20 single-byte characters.
SHIPTOCOUNTRYCODE Country code. This field is required if the shipping address is used.
Character limit: 2 single-byte characters.
SHIPTOPHONENUM (Optional) Phone number.
Character length and limit: 20 single-byte characters.
Field Description
AMT (Required) The total cost of the transaction to the customer. If shipping cost and tax
charges are known, include them in this value; if not, this value should be the current
sub-total of the order.
If the transaction includes one or more one-time purchases, this field must be equal to
the sum of the purchases.
Set this field to 0 if the transaction does not include a one-time purchase; for example,
when you set up a billing agreement for a recurring payment that is not immediately
charged.
Limitations: Must not exceed $10,000 USD in any currency. No currency symbol.
Must have two decimal places, decimal separator must be a period (.), and the
optional thousands separator must be a comma (,).
CURRENCYCODE (Optional) A three-character currency code. Default: USD.
ITEMAMT (Optional) Sum of cost of all items in this order.
Limitations: Must not exceed $10,000 USD in any currency. No currency symbol.
Must have two decimal places, decimal separator must be a period (.), and the
optional thousands separator must be a comma (,).
NOTE: ITEMAMT is required if you specify L_AMTn.