4D Payments SDK 2016 .NET Edition
4D Payments SDK 2016 .NET Edition
Questions / Feedback?

FDMSRcLevel2 Type

Specifies Level 2 (purchasing card) information.

Remarks

This type specifies Level 2 (purchasing card) information.

Fields

CustomerReferenceNumber
String

The reference number or order number to be reported as part of the Purchase Card data.

If TaxAmount is specified this field is required.

The value may be up to 17 characters in length.

DestinationCountryCode
String

This field represents the country code of the location the items in this purchase are being delivered to.

This value is the ISO 3166 three digit numeric identifier.

DestinationPostalCode
String

This field contains the postal or zip code of the location the item(s) in this purchase are being delivered to.

This field is required for American Express purchase card transactions. This is the same as the ShipFromPostalCode when the customer takes possession of the items at the merchant location.

The value may be up to 9 characters.

DiscountAmount
String

This field contains the discount amount for the purchase.

This field is required for Visa, MasterCard, and American Express purchase card transactions when a discount has been applied.

This amount is to be presented with an implied decimal point. For example, US $10.00 must be represented as 1000, and $0.10 is likewise simply 10. The positioning of any implied decimal point is dictated by the CurrencyCode. The default currency code is for the United States.

The maximum number of digits allowed is 12 regardless of the position of the implied decimal point. This field may not contain a negative number.

DutyAmount
String

This field contains the duty amount for this purchase.

This field is required for Visa, MasterCard, and American Express purchase card transactions when a duty amount has been applied.

This amount is to be presented with an implied decimal point. For example, US $10.00 must be represented as 1000, and $0.10 is likewise simply 10. The positioning of any implied decimal point is dictated by the CurrencyCode. The default currency code is for the United States.

The maximum number of digits allowed is 12 regardless of the position of the implied decimal point. This field may not contain a negative number.

FreightAmount
String

This field contains the amount for freight included in this purchase.

This field is required for Visa, MasterCard, and American Express purchase card transactions when a freight amount has been applied.

This amount is to be presented with an implied decimal point. For example, US $10.00 must be represented as 1000, and $0.10 is likewise simply 10. The positioning of any implied decimal point is dictated by the CurrencyCode. The default currency code is for the United States.

The maximum number of digits allowed is 12 regardless of the position of the implied decimal point. This field may not contain a negative number.

MerchantTaxId
String

This field should contain the Tax Id collected by the merchant for this transaction.

This field is required for MasterCard purchase card transactions.

The value may be up to 15 characters in length.

ProductDescription
String

This field should contain a description of an item purchased with this card.

This field is required for American Express purchase card transactions and not applicable to other card types.

The value may be up to 40 characters in length.

PurchaseIdentifier
String

This field represents the data used by the merchant or customer to identify the purchase. This can be a SKU, code, or reference number.

This field is required for Visa, MasterCard, and American Express purchase card transactions.

The value may be up to 25 characters in length.

ShipFromPostalCode
String

The postal or zip code the item(s) in this purchase are to be shipped from.

The value may be up to 9 characters.

TaxAmount
String

This field contains the portion of the transaction amount that represents the tax.

This field is required when TaxIndicator is set to 2 (tiProvided).

For Visa this is the amount of state or provincial tax included in the TransactionAmount. The tax amount must be within 0.1 % and 22% of the pre-tax transaction amount.

For MasterCard the total amount of sales tax on the total purchase must be between 0.1% and 30 % of the total pre-tax transaction amount; zeros indicate that the card acceptor is capable of transmitting the tax amount and the tax amount is zero.

This amount is to be presented with an implied decimal point. For example, US $10.00 must be represented as 1000, and $0.10 is likewise simply 10. The positioning of any implied decimal point is dictated by the CurrencyCode. The default currency code is for the United States.

The maximum number of digits allowed is 12 regardless of the position of the implied decimal point. This field may not contain a negative number.

TaxIndicator
TTaxIndicators

This field indicates the taxable status of the transaction. Possible values are:

0 (tiUnspecified - default) Unspecified - no value is sent in the request
1 (tiNotProvided) No tax information provided
2 (tiProvided) Tax amount is provided
3 (tiExempt) Purchase item is tax exempt or non-taxable

Constructors

[VB.NET]
Public FDMSRcLevel2()

[C#]
public FDMSRcLevel2();



 
 
Copyright (c) 2020 4D Payments Inc. - All rights reserved.
4D Payments SDK 2016 .NET Edition - Version 16.0 [Build 7502]