On this page
No Headings
Last updated: June 12, 2026
Important: NVP/SOAP is a legacy integration method. We accept new integrations and support existing integrations, but there are newer solutions. If you're starting an integration, we recommend our latest solutions.
Issues a credit to a card not referenced by the original transaction.
| Field | Description |
|---|---|
METHOD | (Required) Must be DoNonReferencedCredit. |
AMT | (Required) Total of order, including shipping, handling, and tax. Amount = NetAmount + ShippingAmount + TaxAmount Character length and limitations: Value is typically a positive number that cannot exceed nine (9) digits in SOAP request/response for USD, CLP, or JPY or the per transaction limit for the currency. It includes no currency symbol. Most currencies require two decimal places. The decimal separator must be a period ( .), and the optional thousands separator must be a comma (,). Some currencies do not allow decimals. For details, see the currency codes page. . |
NETAMT | (Optional) Total amount of all items in this transaction. Note: The only valid currencies are AUD, CAD, EUR, GBP, JPY, and USD. .), and the optional thousands separator must be a comma (,). Some currencies do not allow decimals. For details, see the currency codes page. |
TAXAMT | (Optional) Sum of tax for all items in this order. Note: The only valid currencies are AUD, CAD, EUR, GBP, JPY, and USD. .), and the optional thousands separator must be a comma (,). Some currencies do not allow decimals. For details, see the currency codes page. |
SHIPPINGAMT | (Optional) Total shipping costs in this transaction. Note: The only valid currencies are AUD, CAD, EUR, GBP, JPY, and USD. .), and the optional thousands separator must be a comma (,). Some currencies do not allow decimals. For details, see the currency codes page. |
NOTE | (Optional) Field used by merchant to record why this credit was issued to a buyer. It is similar to a "memo" field (freeform text or string field). |
CURRENCYCODE | (Required) Currency code (default is USD). Note: The only valid currencies are AUD, CAD, EUR, GBP, JPY, and USD. |
| Field | Description |
|---|---|
CREDITCARDTYPE | (Optional) Type of credit card. For UK, only Maestro, Mastercard, Discover, and Visa are allowable. For Canada, only Mastercard and Visa are allowable and Interac debit cards are not supported. Value is:
Note: If the credit card type is Maestro, you must set CURRENCYCODE to GBP. In addition, you must specify either STARTDATE or ISSUENUMBER. |
ACCT | (Required) Credit card number. Character length and limitations: Numeric characters only with no spaces or punctuation. The string must conform with modulo and length required by each credit card type. |
EXPDATE | Credit card expiration date. This field is required if you are using recurring payments with direct payments. Character length and limitations: 6 single-byte alphanumeric characters, including leading zero, in the format MMYYYY |
CVV2 | Card Verification Value, version 2. Your Merchant Account settings determine whether this field is required. To comply with credit card processing regulations, you must not store this value after a transaction has been completed. Character length and limitations: For Visa, Mastercard, and Discover, the value is exactly 3 digits. For American Express, the value is exactly 4 digits. |
STARTDATE | (Optional) Month and year that Maestro card was issued. Character length and limitations: Must be 6 digits, including leading zero, in the format MMYYYY |
ISSUENUMBER | (Optional) Issue number of Maestro card. Character length and limitations: 2 numeric digits maximum |
| Field | Description |
|---|---|
SALUTATION | (Optional) Buyer's salutation. Character length and limitations: 20 single-byte characters |
FIRSTNAME | (Optional) Buyer's first name. Character length and limitations: 64 double-byte characters |
MIDDLENAME | (Optional) Buyer's middle name. Character length and limitations: 64 double-byte characters |
LASTNAME | (Optional) Buyer's last name. Character length and limitations: 64 double-byte characters |
SUFFIX | (Optional) Buyer's suffix. Character length and limitations: 12 single-byte characters |
| Field | Description |
|---|---|
EMAIL | (Optional) Email address of buyer. Character length and limitations: 127 single-byte characters |
FIRSTNAME | (Required) Buyer's first name. Character length and limitations: 64 single-byte characters |
LASTNAME | (Required) Buyer's last name. Character length and limitations: 64 single-byte characters |
| Field | Description |
|---|---|
STREET | (Required) First street address. Character length and limitations: 100 single-byte characters |
STREET2 | (Optional) Second street address. Character length and limitations: 100 single-byte characters |
CITY | (Required) Name of city. Character length and limitations: 40 single-byte characters |
STATE | (Required) State or province. Character length and limitations: 40 single-byte characters |
COUNTRYCODE | (Required) Country code. Character length and limitations: 2 single-byte characters |
ZIP | (Required) U.S. ZIP code or other country-specific postal code. Character length and limitations: 20 single-byte characters |
SHIPTOPHONENUM | (Optional) Phone number. Character length and limitations: 20 single-byte characters |
| Field | Description |
|---|---|
TRANSACTIONID | Unique identifier of a transaction. Character length and limitations: 17 characters. Orders transactions have 19 characters. |
CURRENCYCODE | Currency code. Note: The only valid currencies are AUD, CAD, EUR, GBP, JPY and USD. |