Skip to main content

MerchantRiskIndicator

deliveryEmailAddressstring<email>nullable

For Electronic delivery, the email address to which the merchandise was delivered. Scheme specific rules: Visa: Field is required if available.

Possible values: <= 254 characters

deliveryTimeframestringnullable

Indicates the merchandise delivery timeframe.

  • 01: Electronic Delivery
  • 02: Same day shipping
  • 03: Overnight shipping
  • 04: Two-day or more shipping
Scheme specific rules: Visa: Field is required if available.

Possible values: [01, 02, 03, 04]

giftCardAmountstringnullable

For prepaid or gift card purchase, the purchase amount total of prepaid or gift card(s) in major units (for example, USD 123.45 is 123). Scheme specific rules: Visa: Field is required if available.

Possible values: Value must match regular expression ^\d{0,15}$

giftCardCountstringnullable

For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased. Scheme specific rules: Visa: Field is required if available.

Possible values: Value must match regular expression ^\d{2}$

giftCardCurrstring<currency>nullable

For prepaid or gift card purchase, ISO 4217 three-digit currency code of the gift card, other than those listed in Table A.5. Scheme specific rules: Visa: Field is required if available.

preOrderDatestring<yyyymmdd>nullable

For a pre-ordered purchase, the expected date that the merchandise will be available. Scheme specific rules: Visa: Field is required if available.

preOrderPurchaseIndstringnullable

Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

  • 01: Merchandise available
  • 02: Future availability
Scheme specific rules: Visa: Field is required if available.

Possible values: [01, 02]

reorderItemsIndstringnullable

Indicates whether the cardholder is reordering previously purchased merchandise.

  • 01: First time ordered
  • 02: Reordered
Scheme specific rules: Visa: Field is required if available.

Possible values: [01, 02]

shipIndicatorstringnullable

Indicates shipping method chosen for the transaction. Merchants must choose the Shipping Indicator code that most accurately describes the cardholder’s specific transaction, not their general business. If one or more items are included in the sale, use the Shipping Indicator code for the physical goods, or if all digital goods, use the Shipping Indicator code that describes the most expensive item.

  • 01: Ship to cardholder’s billing address
  • 02: Ship to another verified address on file with merchant
  • 03: Ship to address that is different than the cardholder’s billing address
  • 04: "Ship to Store" / Pick-up at local store (Store address shall be populated in shipping address fields)
  • 05: Digital goods (includes online services, electronic gift cards and redemption codes)
  • 06: Travel and Event tickets, not shipped
  • 07: Other (for example, Gaming, digital services not shipped, emedia subscriptions, etc.)
  • 08: Pick-up and go delivery
  • 09: Locker delivery (or other automated pick-up)
Scheme specific rules: Visa: Field is required if available.

Possible values: [01, 02, 03, 04, 05, 06, 07, 08, 09]

transCharstring[]nullable

Indicates to the ACS specific transactions identified by the Merchant.

  • 01: Cryptocurrency transaction
  • 02: NFT transaction

Possible values: [01, 02]

MerchantRiskIndicator
{
  "deliveryEmailAddress": "user@example.com",
  "deliveryTimeframe": "01",
  "giftCardAmount": "string",
  "giftCardCount": "string",
  "giftCardCurr": "string",
  "preOrderDate": "string",
  "preOrderPurchaseInd": "01",
  "reorderItemsInd": "01",
  "shipIndicator": "01",
  "transChar": [
    "01"
  ]
}