{"id":510,"date":"2021-07-30T14:21:42","date_gmt":"2021-07-30T14:21:42","guid":{"rendered":"https:\/\/payb.co.uk\/integration-guide\/?p=510"},"modified":"2021-07-30T14:21:42","modified_gmt":"2021-07-30T14:21:42","slug":"crossreferencetransaction","status":"publish","type":"post","link":"https:\/\/payb.co.uk\/integration-guide\/direct-integration\/crossreferencetransaction\/","title":{"rendered":"CrossReferenceTransaction"},"content":{"rendered":"

Introduction<\/span><\/h3>\n

Cross reference transactions are primarily used so that the merchant can run subsequent transactions against previous transactions without having to store the credit card details from the original transaction. These transactions may be subsequent sales (used for recurring billing), full or partial collection of funds (if the initial transaction was a pre-authorisation), or full or partial refunds (if the initial transaction was a sale or a collection)<\/p>\n

<\/a> Request<\/span><\/h3>\n

Below are the details for the request message to initiate a cross reference transaction.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

Tag\/Attribute<\/span> Name<\/span><\/span><\/p>\n<\/td>\n

\n

Data<\/span><\/span><\/p>\n

Type<\/span><\/span><\/p>\n<\/td>\n

\n

Max<\/span><\/span><\/p>\n

Length<\/span><\/span><\/p>\n<\/td>\n

\n

Mandatory<\/span><\/span><\/p>\n

(Default)<\/span><\/span><\/p>\n<\/td>\n

\n

Comments<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

PaymentMessage<\/b><\/span><\/span><\/p>\n<\/td>\n

\n

Yes<\/b><\/span><\/span><\/p>\n<\/td>\n

<\/td>\n<\/tr>\n
<\/td>\n\n

MerchantAuthentication<\/b><\/span><\/span><\/p>\n<\/td>\n

\n

Yes<\/b><\/span><\/span><\/p>\n<\/td>\n

<\/td>\n<\/tr>\n
<\/td>\n\n

MerchantID<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

15<\/span><\/span><\/p>\n<\/td>\n

\n

Yes<\/span><\/span><\/p>\n<\/td>\n

\n

The gateway account<\/span> merchant ID issued (not to be<\/span> confused with the MMS<\/span> username)<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Password<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

15<\/span><\/span><\/p>\n<\/td>\n

\n

Yes<\/span><\/span><\/p>\n<\/td>\n

\n

The<\/span> gateway<\/span> account<\/span><\/span><\/p>\n

password<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

TransactionDetails<\/b><\/span><\/span><\/p>\n<\/td>\n

\n

Yes<\/b><\/span><\/span><\/p>\n<\/td>\n

<\/td>\n<\/tr>\n
<\/td>\n\n

Amount<\/span> (attribute)<\/span><\/span><\/p>\n<\/td>\n

\n

N<\/span><\/span><\/p>\n<\/td>\n

\n

15<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (False)<\/span><\/span><\/p>\n<\/td>\n

\n

The<\/span> transaction<\/span> amount<\/span> in<\/span> minor<\/span> currency \u2013<\/span> e.g.<\/span> for<\/span><\/span><\/p>\n

\u00a310.00,<\/span> it<\/span> must be<\/span> submitted<\/span> as<\/span> 1000. Mandatory for all<\/span> TransactionTypes except VOID.<\/span> Zero (0) is only supported<\/span> where<\/span> the<\/span> TransactionType is<\/span><\/span><\/p>\n

PREAUTH.<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

CurrencyCode<\/span> (attribute)<\/span><\/span><\/p>\n<\/td>\n

\n

N<\/span><\/span><\/p>\n<\/td>\n

\n

3<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (False)<\/span><\/span><\/p>\n<\/td>\n

\n

ISO<\/span> 4217<\/span> e.g.<\/span> GBP:<\/span> 826.<\/span><\/span><\/p>\n

Mandatory<\/span> for all<\/span><\/span><\/p>\n

TransactionTypes except<\/span> VOID<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

OrderID<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

Yes<\/span><\/span><\/p>\n<\/td>\n

\n

A merchant side ID for the<\/span> order \u2013 primarily used to for<\/span> determining duplicate<\/span> transactions. Pulled forward<\/span> from the previous transaction<\/span> if<\/span> not<\/span> set<\/span> &<\/span> NewTransaction<\/span> is<\/span> false<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

OrderDescription<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

256<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

A description for the order.<\/span> Pulled forward from the<\/span> previous transaction if not set<\/span> & NewTransaction<\/span> is<\/span> false<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

MessageDetails<\/b><\/span><\/span><\/p>\n<\/td>\n

<\/td>\n<\/td>\n<\/tr>\n
<\/td>\n\n

TransactionType<\/span> (attribute)<\/span><\/span><\/p>\n<\/td>\n

\n

–<\/span><\/span><\/p>\n<\/td>\n

\n

–<\/span><\/span><\/p>\n<\/td>\n

\n

Yes<\/span><\/span><\/p>\n<\/td>\n

\n

Must be either COLLECTION,<\/span> REFUND,<\/span> PREAUTH,<\/span> SALE,<\/span> VOID<\/span> or<\/span> RETRY<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n<\/colgroup>\n\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

\n<\/td>\n

\n

NewTransaction<\/span> (attribute)<\/span><\/span><\/p>\n<\/td>\n

\n

B<\/span><\/span><\/p>\n<\/td>\n

\n

–<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (True)<\/span><\/span><\/p>\n<\/td>\n

\n

Instructs<\/span> the<\/span> gateway<\/span> to<\/span> treat<\/span><\/span><\/p>\n

this transaction as a new<\/span> transaction<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

CrossReference<\/span> (attribute)<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

25<\/span><\/span><\/p>\n<\/td>\n

\n

Yes<\/span><\/span><\/p>\n<\/td>\n

\n

The<\/span> cross<\/span> reference for<\/span> the<\/span><\/span><\/p>\n

previous<\/span> transaction<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

LineItemDetails<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

No<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

SalesTaxAmount<\/span> (attribute)<\/span><\/span><\/p>\n<\/td>\n

\n

N<\/span><\/span><\/p>\n<\/td>\n

\n

15<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

The sales tax amount in minor<\/span> currency \u2013 e.g. for \u00a310.00, it<\/span> must be submitted<\/span> as<\/span> 1000<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

SalesTaxDescription<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span> description<\/span> of<\/span> the<\/span> sales<\/span> tax<\/span><\/span><\/p>\n

(e.g.<\/span> \u201cVAT<\/span> (20%)\u201d<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

LineItems<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

No<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

\n<\/td>\n

\n

LineItem<\/strong><\/span> (multiple)<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

No<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

Quantity<\/span> (attribute)<\/span><\/span><\/p>\n<\/td>\n

\n

N<\/span><\/span><\/p>\n<\/td>\n

\n

15<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

The<\/span> quantity<\/span> of<\/span> a<\/span> single line<\/span><\/span><\/p>\n

item<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

Amount<\/span> (attribute)<\/span><\/span><\/p>\n<\/td>\n

\n

N<\/span><\/span><\/p>\n<\/td>\n

\n

15<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

The amount of a single line<\/span> item in minor currency \u2013 e.g.<\/span> for \u00a310.00, it must be<\/span> submitted<\/span> as<\/span> 1000<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

Description<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

100<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

The<\/span> description<\/span> of<\/span> a<\/span> single<\/span> line<\/span><\/span><\/p>\n

item<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

TransactionControl<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

No<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

EchoCardType<\/span><\/span><\/p>\n<\/td>\n

\n

B<\/span><\/span><\/p>\n<\/td>\n

\n

–<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (False)<\/span><\/span><\/p>\n<\/td>\n

\n

Instructs the gateway to<\/span> include the card type of the<\/span> transaction in the message<\/span> response<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

EchoAVSCheckResult<\/span><\/span><\/p>\n<\/td>\n

\n

B<\/span><\/span><\/p>\n<\/td>\n

\n

–<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (False)<\/span><\/span><\/p>\n<\/td>\n

\n

Instructs the gateway to<\/span> include the AVS results for the<\/span> transaction in the message<\/span> response<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

EchoCV2CheckResult<\/span><\/span><\/p>\n<\/td>\n

\n

B<\/span><\/span><\/p>\n<\/td>\n

\n

–<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (False)<\/span><\/span><\/p>\n<\/td>\n

\n

Instructs the gateway to<\/span> include the CV2 results for the<\/span> transaction in the message<\/span> response<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

EchoAmountReceived<\/span><\/span><\/p>\n<\/td>\n

\n

B<\/span><\/span><\/p>\n<\/td>\n

\n

–<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (False)<\/span><\/span><\/p>\n<\/td>\n

\n

Instructs the gateway to<\/span> include the amount that was<\/span> passed to it in the message<\/span> response<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

EchoExternalData<\/span><\/span><\/p>\n<\/td>\n

\n

B<\/span><\/span><\/p>\n<\/td>\n

\n

–<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (False)<\/span><\/span><\/p>\n<\/td>\n

\n

Instructs the gateway to<\/span> include the transaction<\/span> identifiers of the bank\u2019s<\/span> external<\/span> system<\/span> in<\/span> the<\/span><\/span><\/p>\n

message<\/span> response<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

DuplicateDelay<\/span><\/span><\/p>\n<\/td>\n

\n

N<\/span><\/span><\/p>\n<\/td>\n

\n

3<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (60)<\/span><\/span><\/p>\n<\/td>\n

\n

Sets the amount of time (in<\/span> seconds) that any orders to<\/span> the same gateway account<\/span> with the same OrderID and<\/span> CardNumber should be<\/span> rejected<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n\n\n\n\n\n\n\n\n
\n

\n<\/td>\n

\n

AVSOverridePolicy<\/span><\/span><\/p>\n<\/td>\n

\n

–<\/span><\/span><\/p>\n<\/td>\n

\n

4<\/span><\/span><\/p>\n<\/td>\n

\n

No (As<\/span> set<\/span> in<\/span><\/span><\/p>\n

MMS)<\/span><\/span><\/p>\n<\/td>\n

\n

Sets an override AVS checking<\/span> policy<\/span> for<\/span> this<\/span> transaction.<\/span> (See<\/span> Appendix<\/span> 3<\/span> for<\/span> details)<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

CV2OverridePolicy<\/span><\/span><\/p>\n<\/td>\n

\n

–<\/span><\/span><\/p>\n<\/td>\n

\n

2<\/span><\/span><\/p>\n<\/td>\n

\n

No (As<\/span> set<\/span> in<\/span><\/span><\/p>\n

MMS)<\/span><\/span><\/p>\n<\/td>\n

\n

Sets an override CV2 checking<\/span> policy<\/span> for<\/span> this<\/span> transaction.<\/span> (See<\/span> Appendix<\/span> 3<\/span> for<\/span> details)<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

ThreeDSecureOverridePolicy<\/span><\/span><\/p>\n<\/td>\n

\n

B<\/span><\/span><\/p>\n<\/td>\n

\n

–<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (False)<\/span><\/span><\/p>\n<\/td>\n

\n

Sets an override for 3D<\/span> Secure checking for this<\/span> transaction<\/span><\/span><\/p>\n

FALSE = Do not perform 3D<\/span> Secure enrolment<\/span> check<\/span><\/span><\/p>\n

TRUE = Perform 3D Secure<\/span> enrolment<\/span> check<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

OverrideCardDetails<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

No<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

CardName<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

100<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

The name on the customer\u2019s<\/span> card.<\/span> Only<\/span> submit<\/span> to<\/span> override<\/span> the<\/span> value<\/span> for<\/span> the<\/span> previous<\/span><\/span><\/p>\n

transaction<\/span> (submit<\/span> \u201cblank\u201d<\/span> to<\/span> not use the value from the<\/span> previous<\/span> transaction)<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

CardNumber<\/span><\/span><\/p>\n<\/td>\n

\n

N<\/span><\/span><\/p>\n<\/td>\n

\n

20<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

The<\/span> customer\u2019s<\/span> card<\/span> number.<\/span> Only submit to override the<\/span> value for the previous<\/span> transaction<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

ExpiryDate<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

No<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

Month<\/span><\/span><\/p>\n<\/td>\n

\n

N<\/span><\/span><\/p>\n<\/td>\n

\n

2<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

The month of the expiry date<\/span> in 2 digit numeric format \u2013 e.g.<\/span> for<\/span> July,<\/span> must<\/span> be submitted<\/span> as<\/span><\/span><\/p>\n

07. Only submit to override<\/span> the value for the previous<\/span> transaction (submit -1 to not<\/span> use the value from the<\/span> previous<\/span> transaction)<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

Year<\/span><\/span><\/p>\n<\/td>\n

\n

N<\/span><\/span><\/p>\n<\/td>\n

\n

2<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

The year of the expiry date in<\/span> 2 digit numeric format \u2013 e.g.<\/span> for 2007, must be submitted<\/span> as<\/span> 07.<\/span> Only<\/span> submit<\/span> to<\/span> override<\/span> the value for the previous<\/span> transaction (submit -1 to not<\/span> use the value from the<\/span> previous<\/span> transaction)<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n\n\n\n\n\n\n\n\n\n\n
\n

\n<\/td>\n

\n

CV2<\/span><\/span><\/p>\n<\/td>\n

\n

N<\/span><\/span><\/p>\n<\/td>\n

\n

4<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

The security number (also<\/span> called CVV or CVV2) printed on<\/span> the customer\u2019s card \u2013 usually<\/span> the last 3 or 4 digits printed on<\/span> the<\/span> signature<\/span> strip. Only<\/span> submit to override the value<\/span> for the previous transaction<\/span> (submit -1 to not use the value<\/span> from<\/span> the<\/span> previous<\/span> transaction)<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

IssueNumber<\/span><\/span><\/p>\n<\/td>\n

\n

N<\/span><\/span><\/p>\n<\/td>\n

\n

2<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

The<\/span> issue<\/span> number<\/span> printed<\/span> on<\/span><\/span><\/p>\n

the customer\u2019s card. Only<\/span> submit to override the value for<\/span> the<\/span> previous<\/span> transaction<\/span> (submit<\/span><\/span><\/p>\n

-1<\/span> to<\/span> not<\/span> use<\/span> the<\/span> value<\/span> from<\/span> the<\/span> previous<\/span> transaction)<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

CustomerDetails<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

No<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

\n<\/td>\n

\n

BillingAddress<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

No<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

Address1<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

100<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

Customer\u2019s<\/span> billing<\/span> address<\/span> line<\/span><\/span><\/p>\n

1. Only pulled forward from<\/span> previous transaction if NONE of<\/span> the<\/span> address<\/span> fields<\/span> have<\/span> been<\/span> set<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

Address2<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

Customer\u2019s<\/span> billing<\/span> address<\/span> line<\/span><\/span><\/p>\n

2. Only pulled forward from<\/span> previous transaction if NONE of<\/span> the<\/span> address<\/span> fields<\/span> have<\/span> been<\/span> set<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

Address3<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

Customer\u2019s<\/span> billing<\/span> address<\/span> line<\/span><\/span><\/p>\n

3. Only pulled forward from<\/span> previous transaction if NONE of<\/span> the<\/span> address<\/span> fields<\/span> have<\/span> been<\/span> set<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

Address4<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

Customer\u2019s<\/span> billing<\/span> address<\/span> line<\/span><\/span><\/p>\n

4. Only pulled forward from<\/span> previous transaction if NONE of<\/span> the<\/span> address<\/span> fields<\/span> have<\/span> been<\/span> set<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

City<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

Customer\u2019s billing address city.<\/span> Only pulled forward from<\/span> previous transaction if NONE of<\/span> the<\/span> address<\/span> fields<\/span> have<\/span> been<\/span> set<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

State<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

Customer\u2019s<\/span> billing<\/span> address<\/span> state.<\/span> Only pulled forward from<\/span> previous transaction if NONE of<\/span> the<\/span> address<\/span> fields<\/span> have<\/span> been<\/span> set<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n<\/colgroup>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

\n<\/td>\n

\n

PostCode<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

Customer\u2019s billing address post<\/span> code. Only pulled forward from<\/span> previous transaction if NONE of<\/span> the<\/span> address<\/span> fields<\/span> have<\/span> been<\/span> set<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

CountryCode<\/span><\/span><\/p>\n<\/td>\n

\n

N<\/span><\/span><\/p>\n<\/td>\n

\n

3<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

ISO 3166-1 e.g. United<\/span> Kingdom: 826. Only pulled<\/span> forward from previous<\/span> transaction if NONE of the<\/span> address<\/span> fields<\/span> have<\/span> been<\/span> set<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

EmailAddress<\/span><\/span><\/p>\n<\/td>\n

\n

E<\/span><\/span><\/p>\n<\/td>\n

\n

100<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

The email address of the<\/span> customer \u2013 NOTE: anything<\/span> passed in here is validated as<\/span> an email address, so anything<\/span> passed in must be a valid<\/span> email address. Pulled forward<\/span> from previous transaction if<\/span> not<\/span> set<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

PhoneNumber<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

30<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span> (See<\/span><\/span><\/p>\n

comment)<\/span><\/span><\/p>\n<\/td>\n

\n

The customer\u2019s phone<\/span> number. Pulled forward from<\/span> previous<\/span> transaction<\/span> if<\/span> not<\/span> set<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

CustomerIPAddress<\/span><\/span><\/p>\n<\/td>\n

\n

I<\/span><\/span><\/p>\n<\/td>\n

\n

15<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

The IP address of the customer<\/span> (NOT the<\/span> IP<\/span> address<\/span> of<\/span> the<\/span><\/span><\/p>\n

merchant\u2019s<\/span> website).<\/span> This<\/span> is<\/span><\/span><\/p>\n

used<\/span> to<\/span> determine the<\/span><\/span><\/p>\n

customer\u2019s<\/span> country<\/span> of<\/span> origin.<\/span><\/span><\/p>\n

The<\/span> format<\/span> is<\/span> xxx.xxx.xxx.xxx<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

DateOfBirth<\/span><\/span><\/p>\n<\/td>\n

\n

D<\/span><\/span><\/p>\n<\/td>\n

\n

10<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

The<\/span> date<\/span> of<\/span> birth<\/span> of<\/span> the<\/span> customer. Must be in<\/span> the<\/span> format<\/span> YYYY-MM-<\/span><\/span><\/p>\n

DD<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

PrimaryAccountDetails<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

No<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

Name<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

100<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

The name of the primary<\/span> account<\/span> holder<\/span> (used<\/span> for<\/span> MCC<\/span> 6012<\/span> accounts<\/span> only)<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

AccountNumber<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

The account number of the<\/span> primary account holder (used<\/span> for<\/span> MCC<\/span> 6012<\/span> accounts<\/span> only)<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

DateOfBirth<\/span><\/span><\/p>\n<\/td>\n

\n

D<\/span><\/span><\/p>\n<\/td>\n

\n

10<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

The date of birth of the<\/span> primary<\/span> account<\/span> holder<\/span> (used<\/span> for<\/span> MCC<\/span> 6012<\/span><\/span><\/p>\n

accounts<\/span> only)<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

AddressDetails<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

No<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

PostCode<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

The post code of the primary<\/span> account<\/span> holder<\/span> (used<\/span> for<\/span> MCC<\/span> 6012<\/span> accounts<\/span> only)<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

ShippingDetails<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

No<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

\n<\/td>\n

\n

ShippingAddress<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

No<\/strong><\/span><\/span><\/p>\n<\/td>\n

\n

\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

Address1<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

100<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

Shipping<\/span> recipient\u2019s<\/span> address<\/span><\/span><\/p>\n

line 1<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

Address2<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

Shipping<\/span> recipient\u2019s address<\/span><\/span><\/p>\n

line 2<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n\n\n\n
\n

\n<\/td>\n

\n

Address3<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

Shipping<\/span> recipient\u2019s<\/span> address<\/span><\/span><\/p>\n

line 3<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

Address4<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

Shipping<\/span> recipient\u2019s<\/span> address<\/span><\/span><\/p>\n

line 4<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

City<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

Shipping<\/span> recipient\u2019s<\/span> address<\/span><\/span><\/p>\n

city<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

State<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

Shipping<\/span> recipient\u2019s<\/span> address<\/span><\/span><\/p>\n

state<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n\n\n\n\n
\n

\n<\/td>\n

\n

PostCode<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

50<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

Shipping<\/span> recipient\u2019s<\/span> address<\/span><\/span><\/p>\n

post code<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

CountryCode<\/span><\/span><\/p>\n<\/td>\n

\n

N<\/span><\/span><\/p>\n<\/td>\n

\n

3<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

ISO<\/span> 3166-1<\/span> e.g.<\/span> United<\/span><\/span><\/p>\n

Kingdom:<\/span> 826<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

Name<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

100<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

Shipping<\/span> recipient\u2019s<\/span> name<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

EmailAddress<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

100<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

The email address of the<\/span> shipping recipient \u2013 NOTE:<\/span> anything passed in here is<\/span> validated as an email address,<\/span> so anything passed in must be<\/span> a valid<\/span> email<\/span> address<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

\n<\/td>\n

\n

PhoneNumber<\/span><\/span><\/p>\n<\/td>\n

\n

A<\/span><\/span><\/p>\n<\/td>\n

\n

30<\/span><\/span><\/p>\n<\/td>\n

\n

No<\/span><\/span><\/p>\n<\/td>\n

\n

Shipping<\/span> recipient\u2019s<\/span> phone<\/span><\/span><\/p>\n

number<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

<\/a> Things<\/span> to<\/span> Note<\/span><\/h3>\n