---
title: US Ticketing Fields
slug: legacy-fraud-apis/us-ticketing-fields
createdAt: 2026-06-09T23:53:56.376Z
---

{
  "id": "TVAQnMGa0snZolivo-8Vr",
  "type": "api-oas-v2",
  "data": {
    "method": "POST",
    "url": "https://icnow01.accertify.net/icNowImport/{importerID}",
    "name": "US Ticketing Fields",
    "description": "",
    "contentType": "application/json",
    "request": {
      "pathParameters": [
        {
          "kind": "required",
          "name": "importerID",
          "type": "string",
          "description": ""
        }
      ],
      "headerParameters": [
        {
          "name": "accept",
          "type": "string",
          "kind": "optional",
          "description": "Generated from available response content types",
          "enum": [
            "application/json"
          ],
          "default": "application/json"
        }
      ],
      "queryParameters": [],
      "bodyDataParameters": [
        {
          "kind": "optional",
          "name": "transaction",
          "type": "object",
          "description": "<p>Core payment/transaction fields shared by all Fraud APIs. Fields required for all events. Fields to send when available; they materially improve scoring. Optional but useful context about session and account status. Account/loyalty profile attributes. Cart/session and payment context not tied to a single payment method. Line‑item details across product types. Structured addresses used across billing/shipping/venue/etc. Array of payment methods used (split or single tender). Order-level promotions/discounts. Ticketed event metadata and venue references.</p>",
          "schema": [
            {
              "name": "transactionID",
              "kind": "required",
              "type": "string",
              "description": "<p>[REQUIRED] Unique transaction identifier (e.g., order/booking number). Max length 40.</p>",
              "example": "ABC123456"
            },
            {
              "name": "transactionType",
              "kind": "required",
              "type": "string<preAuthorization | postAuthorization | update>",
              "description": "<p>[REQUIRED] Type of submission: occurs pre-auth, post-auth, or updates an existing transaction.</p>",
              "example": "preAuthorization",
              "enum": [
                "preAuthorization",
                "postAuthorization",
                "update"
              ]
            },
            {
              "name": "transactionDateTime",
              "kind": "required",
              "type": "string<date-time>",
              "description": "<p>[REQUIRED] RFC3339 timestamp of when the transaction occurred. Future dates not accepted.</p>",
              "example": "2022-03-11T17:07:24-07:00",
              "format": "date-time"
            },
            {
              "name": "accountID",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] Merchant's internal account identifier linked to the customer.</p>",
              "example": 12363454566
            },
            {
              "name": "isGuestCheckout",
              "kind": "optional",
              "type": "string<true | false>",
              "description": "<p>[OPTIONAL] Whether checkout happened without logging in to an account.</p>",
              "enum": [
                "true",
                "false"
              ]
            },
            {
              "name": "paymentAmount",
              "kind": "required",
              "type": "number<float>",
              "description": "<p>[REQUIRED] Total amount for the transaction in local currency (tax + shipping included).</p>",
              "example": 1082.91,
              "format": "float"
            },
            {
              "name": "taxAmount",
              "kind": "optional",
              "type": "number<float>",
              "description": "<p>[OPTIONAL] Tax amount in local currency.</p>",
              "example": 1.23,
              "format": "float"
            },
            {
              "name": "currencyCode",
              "kind": "required",
              "type": "string",
              "description": "<p>[REQUIRED] Three-letter ISO-4217 currency code for all monetary values (e.g., USD).</p>",
              "example": "USD"
            },
            {
              "name": "success",
              "kind": "required",
              "type": "string<true | false>",
              "description": "<p>[REQUIRED] Merchant outcome prior to Accertify recommendation (true = would accept; false = would deny).</p>",
              "enum": [
                "true",
                "false"
              ]
            },
            {
              "name": "failureCode",
              "kind": "optional",
              "type": "string<authFailed | other>",
              "description": "<p>[OPTIONAL] Failure reason code when applicable.</p>",
              "enum": [
                "authFailed",
                "other"
              ]
            },
            {
              "name": "firstName",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] Account holder's first name (required if accountID exists).</p>",
              "example": "Jane"
            },
            {
              "name": "middleName",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] Account holder's middle name.</p>",
              "example": "Marie"
            },
            {
              "name": "lastName",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] Account holder's last name (required if accountID exists).</p>",
              "example": "Doe"
            },
            {
              "name": "phoneNumber",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] Account holder's phone number (no country prefix in this field).</p>"
            },
            {
              "name": "purchaseType",
              "kind": "required",
              "type": "string<physicalItems | digitalItems | services | other>",
              "description": "<p>[REQUIRED] High-level purchase classification.</p>",
              "enum": [
                "physicalItems",
                "digitalItems",
                "services",
                "other"
              ]
            },
            {
              "name": "listingID",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] Third-party marketplace listing identifier where applicable.</p>",
              "example": "abcd1234"
            },
            {
              "name": "loyaltyNumber",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] Customer's loyalty ID if different from accountID.</p>",
              "example": "Id1234"
            },
            {
              "name": "eventSource",
              "kind": "required",
              "type": "string<agentPhone | agentStore | affiliate | kiosk | mobileApp | other | web>",
              "description": "<p>[REQUIRED] Where/how the event originated (web, mobile app, phone, and so forth).</p>",
              "enum": [
                "agentPhone",
                "agentStore",
                "affiliate",
                "kiosk",
                "mobileApp",
                "other",
                "web"
              ]
            },
            {
              "name": "ipAddress",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] End-user IP address. Maximum field length = 45 characters.</p>",
              "example": "192.168.41.17"
            },
            {
              "name": "userAgent",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] Browser/OS user agent captured by the site owner. Maximum field length = 250 characters.</p>",
              "example": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:72.0) Gecko/20100101 Firefox/72.0"
            },
            {
              "name": "devicePayload",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] From Accertify Device, the user's device data sent by our Collector script. You will take the devicePayload from the script and add additional server-side properties to it as described in our \"Device Payload via the Interceptas Platform\" section of our Accertify Data Collector Script Implementation document. Maximum field length = 150,000 characters.</p>",
              "example": "afklasdjlasdjl3l23j23423klj"
            },
            {
              "name": "deviceTransactionID",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] From Accertify Device, the Device Transaction ID from the Collector JS or SDK file captured by the site or application owner. Maximum field length = 100 characters.\n<strong>Notes</strong>:</p>\n<ul>\n<li>We recommend you send devicePayload instead of deviceTransactionID. We are leaving this here for backward compatibility.</li>\n<li>You do not have to put in logic to account for deviceTransactionID returning blank. This can happen if JavaScript is blocked or if it is an event taken over the phone.</li>\n</ul>",
              "example": "e1a1aade06e2557f34036eeb06173faf1fa05c64959383"
            },
            {
              "name": "ubaID",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] From Accertify UBA, the ID used to reference behavior data already captured by Accertify. Maximum field length = 100 characters.\nThis value is retrieved from:</p>\n<ul>\n<li>Browser from the JavaScript function getToken</li>\n<li>iOS/Android from the SDK?function getUbaId()</li>\n</ul>\n<p><strong>Note</strong>: You do not have to put in logic to account for ubaID returning blank. This can happen if JavaScript is blocked or if it is an event taken over the phone.</p>",
              "example": "3143e969395de649c48c1c9f3e363a3e7ae7"
            },
            {
              "name": "emailAddress",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] User's email associated with the account or transaction. Maximum field length = 100 characters.</p>",
              "example": "a@b.com"
            },
            {
              "name": "ubaEvents",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] From Accertify UBA, a payload of the most recent fields. This is used to make sure we have up to the second information.</p>",
              "example": "lasjdlkfdsljelkrrjwl3kl324j32k432"
            },
            {
              "name": "pageID",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] From Accertify UBA, the unique page ID defined from the Collector script.</p>",
              "example": "lk32j4lk324lkj324"
            },
            {
              "name": "username",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] User's username if your site allows logging in using username. Maximum field length = 100 characters.</p>",
              "example": "erlichb"
            },
            {
              "name": "authenticationMethod",
              "kind": "optional",
              "type": "string<appAuthenticator | appPush | FIDO | other | password | magicLink | SMS>",
              "description": "<p>[IMPERATIVE] How the user authenticated (password, MFA push, magic link, and so forth).</p>",
              "enum": [
                "appAuthenticator",
                "appPush",
                "FIDO",
                "other",
                "password",
                "magicLink",
                "SMS"
              ]
            },
            {
              "name": "latitude",
              "kind": "optional",
              "type": "number",
              "description": "<p>[OPTIONAL] The HTML 5 or GPS based latitude location of the user in decimal degrees format without letters. Maximum field length = 10 characters.</p>",
              "example": "Numbers with up to 8 decimals, 58.99993333"
            },
            {
              "name": "longitude",
              "kind": "optional",
              "type": "number",
              "description": "<p>[OPTIONAL] The HTML 5 or GPS based longitude location of the user in decimal degrees format without letters. Maximum field length = 10 characters.</p>",
              "example": "Numbers with up to 8 decimals, 58.99993333"
            },
            {
              "name": "hashedPassword",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] User’s password hashed using Accertify algorithm when required. Maximum field length = 100 characters.</p>",
              "example": "234j32llk234j3l2k4jl"
            },
            {
              "name": "accountStatus",
              "kind": "optional",
              "type": "string<active | dormant | suspended | terminated | trial | other>",
              "description": "<p>[OPTIONAL] Status of membership or account.</p>",
              "enum": [
                "active",
                "dormant",
                "suspended",
                "terminated",
                "trial",
                "other"
              ]
            },
            {
              "name": "brand",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] The brand submitting the event, for clients with multiple brands under one corporate entity. Maximum field length = 50 characters.</p>",
              "example": "Acme"
            },
            {
              "name": "sessionID",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] From Accertify UBA, the user's Session ID defined by you for the user's web browsing activity. Maximum field length = 250 characters.</p>",
              "example": "961b521892e68f6c4d1c8459dfb530466eed"
            },
            {
              "name": "ubaSessionID",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] From Accertify UBA, the user's Session ID defined by Accertify for the user's web browsing activity. Maximum field length = 50 characters.</p>",
              "example": "961b521892e68f6c4d1c8459dfb530466eed"
            },
            {
              "name": "account",
              "kind": "optional",
              "type": "object",
              "description": "<p>[OPTIONAL]</p>",
              "example": "",
              "schema": [
                {
                  "name": "isEnrolledInLoyaltyProgram",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether the purchaser is enrolled in a loyalty program.</p>",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "isMobileAppInstalled",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether the account has the mobile application installed somewhere, regardless if this event is from that mobile application.</p>",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "accountLocale",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Native language expressed in UTF-8 encoding.</p>",
                  "example": "en-US"
                },
                {
                  "name": "accountLevel",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Level of membership or account as defined by you.</p>",
                  "example": "Gold"
                },
                {
                  "name": "accountType",
                  "kind": "optional",
                  "type": "string<individual | business | family | other>",
                  "description": "<p>[OPTIONAL] Type of membership or account.</p>",
                  "enum": [
                    "individual",
                    "business",
                    "family",
                    "other"
                  ]
                },
                {
                  "name": "accountReferralCode",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Referral or promotion code tied to account creation.</p>",
                  "example": "john.smith@email.com"
                },
                {
                  "name": "accountRegistrationDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date and time the account was created formatted in yyyy-MM-dd'T'HH:mm</p><div></div> (RFC3339). This cannot be a future date.<p></p>",
                  "example": "2020-11-22T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "accountEmailUpdatedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date and time the member email was last updated formatted in yyyy-MM-dd'T'HH:mm</p><div></div> (RFC3339). This cannot be a future date.<p></p>",
                  "example": "2020-08-28T19:00:00-04:00",
                  "format": "date-time"
                },
                {
                  "name": "accountEmailVerifiedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date and time the member email was last verified formatted in yyyy-MM-dd'T'HH:mm</p><div></div> (RFC3339). This cannot be a future date.<p></p>",
                  "example": "2020-08-28T19:00:00-04:00",
                  "format": "date-time"
                },
                {
                  "name": "accountPasswordUpdatedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date and time the member password was last updated formatted in yyyy-MM-dd'T'HH:mm</p><div></div> (RFC3339). This cannot be a future date.<p></p>",
                  "example": "2020-02-22T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "dateOfBirth",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] User's date of birth formatted YYYY-MM-DD.</p>",
                  "example": "1974-01-03"
                },
                {
                  "name": "totalCreditCardsOnFile",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Count of cards on file. Maximum field length = 10 characters.</p>",
                  "example": 3
                },
                {
                  "name": "totalInactiveCreditCardsOnFile",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Count of inactive cards on file. Maximum field length = 10 characters.</p>",
                  "example": 1
                },
                {
                  "name": "totalPurchases",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Lifetime number of purchases. Maximum field length = 10 characters.</p>"
                },
                {
                  "name": "totalRefunds",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Lifetime number of refunds. Maximum field length = 10 characters.</p>"
                },
                {
                  "name": "totalOrdersAmount",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Lifetime total order amount in the currency specified by the transaction currencyCode field. Format = two decimals.</p>"
                },
                {
                  "name": "loyaltyProgramName",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Name of loyalty program governing points.</p>\n<p><strong>Note</strong>: This is different than the accountLevel of a single loyalty program.</p>",
                  "example": "Members Plus"
                },
                {
                  "name": "loyaltyNumberStartDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date and time the loyalty account was opened formatted yyyy-MMdd'T'HH:mm</p><div></div> (RFC3339). This cannot be a future date.<p></p>",
                  "example": "2020-02-22T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "loyaltyNumberLastUsedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date and time the loyalty account was last used formatted yyyy-MMdd'T'HH:mm</p><div></div> (RFC3339). This cannot be a future date.<p></p>",
                  "example": "2021-01-22T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "loyaltyLastUsedPoints",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Points used on the last redemption in decimal numeric format. Maximum field length = 20 characters.</p>",
                  "example": 123
                },
                {
                  "name": "loyaltyPointsBalance",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Current points balance. Maximum field length = 20 characters.</p>",
                  "example": 987654321
                },
                {
                  "name": "loyaltyLastEarnedPoints",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Points earned on the last earn event. Maximum field length = 20 characters.</p>",
                  "example": 1234
                },
                {
                  "name": "loyaltyLastEarnedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date and time of last earn event formatted yyyy-MMdd'T'HH:mm</p><div></div> (RFC3339). This cannot be a future date.<p></p>",
                  "example": "2020-02-22T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "loyaltyPromotionMessageType",
                  "kind": "optional",
                  "type": "string<postalMail | email | smsText | none>",
                  "description": "<p>[OPTIONAL] Preferred loyalty promo communications channel.</p>",
                  "enum": [
                    "postalMail",
                    "email",
                    "smsText",
                    "none"
                  ]
                }
              ]
            },
            {
              "name": "payment",
              "kind": "optional",
              "type": "object",
              "description": "<p>[OPTIONAL]</p>",
              "example": "",
              "schema": [
                {
                  "name": "cartID",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Unique identifier you assign for this session. Maximum field length = 50 characters.</p>",
                  "example": "Cart"
                },
                {
                  "name": "salesRepID",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Sales representative identifier when applicable. Maximum field length = 20 characters.</p>",
                  "example": "SR#46k90"
                },
                {
                  "name": "websiteURL",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Website that captured the transaction. Maximum length = 2048 characters.</p>",
                  "example": "www.google.com"
                },
                {
                  "name": "referralCode",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Affiliate or campaign code used to reach the site. Maximum field length = 50 characters.</p>",
                  "example": "CFB2020"
                },
                {
                  "name": "isGift",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Indicates the order is a gift.</p>",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "giftMessage",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Freeform gift message. Maximum field length = 100 characters.</p>",
                  "example": "Enjoy the gift"
                },
                {
                  "name": "deliveryFee",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Delivery fee amount in the currency specified by the transaction currencyCode field. Format = two decimals.</p>",
                  "example": 2
                },
                {
                  "name": "deliveryFeeType",
                  "kind": "optional",
                  "type": "string<free | consumerPaid | subscription | other>",
                  "description": "<p>[OPTIONAL] Type of delivery fee.</p>",
                  "enum": [
                    "free",
                    "consumerPaid",
                    "subscription",
                    "other"
                  ]
                },
                {
                  "name": "isPaymentInInstallments",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether the payment is split into installments.</p>",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "isPaymentRecurring",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether the payment is part of a recurring schedule (e.g., subscription).</p>",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "totalFailedTransactions",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Count of times the transaction has failed for any reason. Maximum field length = 10 characters.</p>",
                  "example": 99
                },
                {
                  "name": "isTravelPackagePurchased",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether a travel package was included in the purchase.</p>",
                  "enum": [
                    "true",
                    "false"
                  ]
                }
              ]
            },
            {
              "name": "items",
              "kind": "optional",
              "type": "array",
              "description": "<p>[OPTIONAL]</p>",
              "example": "",
              "itemType": "object",
              "customType": "object[]",
              "schema": [
                {
                  "name": "isUpsell",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Indicates if item was upsold.</p>",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "itemType",
                  "kind": "optional",
                  "type": "string<giftCard | parking | physicalGood | reservation | subscription | ticket | other>",
                  "description": "<p>[OPTIONAL] Nature of item.</p>",
                  "enum": [
                    "giftCard",
                    "parking",
                    "physicalGood",
                    "reservation",
                    "subscription",
                    "ticket",
                    "other"
                  ]
                },
                {
                  "name": "brandName",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Item's brand name. Maximum field length = 20 characters.</p>",
                  "example": "Apple"
                },
                {
                  "name": "category",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Item category. Maximum field length = 100 characters.</p>",
                  "example": "Computer"
                },
                {
                  "name": "description",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Short description. Maximum field length = 40 characters.</p>",
                  "example": "Macbook Pro"
                },
                {
                  "name": "itemID",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Item identifier, such as a SKU number, that you provide. Maximum field length = 20 characters.</p>",
                  "example": "SKU123"
                },
                {
                  "name": "price",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Item price. Format = two decimals.</p>",
                  "example": 9.99
                },
                {
                  "name": "faceValueAmount",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Original cost of the transacted item. For some items, such as tickets, this could be more or less than the value in the price field. Format = two decimals.</p>",
                  "example": 19.99
                },
                {
                  "name": "quantity",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Quantity (supports decimals). Maximum field length = 12 characters.</p>",
                  "example": 3
                },
                {
                  "name": "addressID",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Identifier you apply to addresses to differentiate orders with multiples. Maximum field length = 40 characters.</p>",
                  "example": "23kj423klj234j"
                },
                {
                  "name": "productCondition",
                  "kind": "optional",
                  "type": "string<new | openPackage | other | refurbished | used>",
                  "description": "<p>[OPTIONAL] Condition of the product.</p>",
                  "enum": [
                    "new",
                    "openPackage",
                    "other",
                    "refurbished",
                    "used"
                  ]
                },
                {
                  "name": "shippingCompany",
                  "kind": "optional",
                  "type": "string<dhl | fedex | ups | usps | other>",
                  "description": "<p>[OPTIONAL] Name of shipping company for merchant-to-consumer initial delivery.</p>",
                  "enum": [
                    "dhl",
                    "fedex",
                    "ups",
                    "usps",
                    "other"
                  ]
                },
                {
                  "name": "shippingMethod",
                  "kind": "optional",
                  "type": "string<digital | ground | international | other | nextDay | sameDay | storePickup | twoDay | threeDay>",
                  "description": "<p>[OPTIONAL] Shipping method.</p>",
                  "enum": [
                    "digital",
                    "ground",
                    "international",
                    "other",
                    "nextDay",
                    "sameDay",
                    "storePickup",
                    "twoDay",
                    "threeDay"
                  ]
                },
                {
                  "name": "shippingTrackingNumber",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Carrier tracking number. Maximum field length = 30 characters.</p>",
                  "example": "23l4fdswerea02"
                },
                {
                  "name": "isLargeItemDelivery",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether delivery is for a large item.</p>",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "promoCode",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Line‑level promo code if applied here. Maximum field length = 100 characters.</p>",
                  "example": "ABC12"
                },
                {
                  "name": "promoAmount",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Promotion or discount amount applied in the currency specified by the transaction currencyCode field. Format = two decimals.</p>",
                  "example": 5555
                },
                {
                  "name": "promoType",
                  "kind": "optional",
                  "type": "string<bogo | bundle | employeeDiscount | freeShipping | loyaltyDiscount | newMemberDiscount | percentage | quantityPromotion | other>",
                  "description": "<p>[OPTIONAL] Type of discount applied to this line item.</p>",
                  "enum": [
                    "bogo",
                    "bundle",
                    "employeeDiscount",
                    "freeShipping",
                    "loyaltyDiscount",
                    "newMemberDiscount",
                    "percentage",
                    "quantityPromotion",
                    "other"
                  ]
                },
                {
                  "name": "pickupLocation",
                  "kind": "optional",
                  "type": "string<curbside | dropBox | inStore | other>",
                  "description": "<p>[OPTIONAL] Type of pickup location when applicable.</p>",
                  "enum": [
                    "curbside",
                    "dropBox",
                    "inStore",
                    "other"
                  ]
                },
                {
                  "name": "pickupLocationDescription",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Freeform description of pickup location. Maximum field length = 100 characters.</p>",
                  "example": "At the main entrance"
                },
                {
                  "name": "pickupPersonFirstNamePrimary",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Primary pickup person's first name. Maximum field length = 40 characters.</p>",
                  "example": "Betty"
                },
                {
                  "name": "pickupPersonLastNamePrimary",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Primary pickup person's last name. Maximum field length = 40 characters.</p>",
                  "example": "Smith"
                },
                {
                  "name": "pickupPersonFirstNameAlternate",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Alternate pickup person's first name. Maximum field length = 40 characters.</p>",
                  "example": "Mary"
                },
                {
                  "name": "pickupPersonLastNameAlternate",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Alternate pickup person's last name. Maximum field length = 40 characters.</p>",
                  "example": "Jones"
                },
                {
                  "name": "pickupVerificationMethod",
                  "kind": "optional",
                  "type": "string<idCard | signature | other>",
                  "description": "<p>[OPTIONAL] Method used to verify pickup identity.</p>",
                  "enum": [
                    "idCard",
                    "signature",
                    "other"
                  ]
                },
                {
                  "name": "pickupDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date and time the item was picked up (send as an update) formatted in yyyy-MMdd'T'HH:mm</p><div></div>.<p></p>",
                  "example": "2021-03-02T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "pickupVerificationSignatureImage",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Base64 signature image captured on pickup. Maximum field length = 4000 characters.</p>"
                },
                {
                  "name": "pickupVerificationIDCardImage",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Base64 ID card image captured on pickup. Maximum field length = 4000 characters.</p>"
                }
              ]
            },
            {
              "name": "addresses",
              "kind": "optional",
              "type": "array",
              "description": "<p>[OPTIONAL]</p>",
              "example": "",
              "itemType": "object",
              "customType": "object[]",
              "schema": [
                {
                  "name": "addressID",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Merchant-defined identifier to distinguish multiple addresses in one order. Maximum field length = 20 characters.</p>",
                  "example": "23kj423klj234j"
                },
                {
                  "name": "addressType",
                  "kind": "optional",
                  "type": "string<account | billing | bopis | curbside | departure | destination | fulfillment | listing | lodging | pickup | return | shipping | venue | other>",
                  "description": "<p>[OPTIONAL] Context for the address (billing, shipping, venue, and so forth).</p>",
                  "enum": [
                    "account",
                    "billing",
                    "bopis",
                    "curbside",
                    "departure",
                    "destination",
                    "fulfillment",
                    "listing",
                    "lodging",
                    "pickup",
                    "return",
                    "shipping",
                    "venue",
                    "other"
                  ]
                },
                {
                  "name": "primaryFlag",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether this is the primary address of that type.</p>",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "isAddressOnFile",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether this address matches the address on file for that context.</p>",
                  "example": "Whether the shipping address is the same as the shipping address for this account.\n",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "firstName",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Address owner's first name. Maximum field length = 40 characters.</p>",
                  "example": "Jane"
                },
                {
                  "name": "middleName",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Address owner's middle name. Maximum field length = 20 characters.</p>",
                  "example": "Marie"
                },
                {
                  "name": "lastName",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Address owner's last name. Maximum field length = 40 characters.</p>",
                  "example": "Doe"
                },
                {
                  "name": "emailAddress",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Email associated with this user. Maximum field length = 100 characters.</p>",
                  "example": "jane.doe123@gmail.com"
                },
                {
                  "name": "phone",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Phone number (no country prefix here). Maximum field length = 25 characters. If phoneCountryCode is not sent, we require valid format.</p>",
                  "example": 2128387654
                },
                {
                  "name": "phoneCountryCode",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Country calling code for phone (omit '+').</p>",
                  "example": 123
                },
                {
                  "name": "address1",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Address line 1 for the account. Maximum field length = 40 characters.</p>",
                  "example": "123 Main Street"
                },
                {
                  "name": "address2",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Address line 2 for the account. Maximum field length = 40 characters.</p>",
                  "example": "Apartment 456"
                },
                {
                  "name": "city",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Address city. Maximum field length = 40 characters.</p>",
                  "example": "Itasca"
                },
                {
                  "name": "region",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] ISO 3166-2 state, province, or region code. Minimum field length = 1 character. Maximum field length = 3 characters.</p>",
                  "example": "IL"
                },
                {
                  "name": "postCode",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Address postal code. Maximum field length = 20 characters. (US ZIP+4 requires hyphen).</p>",
                  "example": "60143-0001"
                },
                {
                  "name": "country",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Two-letter ISO code for country formatted in ISO 3166-1.</p>",
                  "example": "US"
                },
                {
                  "name": "companyName",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Company name associated with the address. Maximum field length = 50 characters.</p>",
                  "example": "Accertify, Inc"
                },
                {
                  "name": "locationType",
                  "kind": "optional",
                  "type": "string<business | redirect | residence | siteToStore | other>",
                  "description": "<p>[OPTIONAL] Residence or business type.</p>",
                  "enum": [
                    "business",
                    "redirect",
                    "residence",
                    "siteToStore",
                    "other"
                  ]
                },
                {
                  "name": "addressCreatedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] When address was created formatted yyyy-MM-dd'T'HH:mm</p><div></div>.<p></p>",
                  "example": "2020-03-28T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "addressUpdatedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] When address was last updated formatted yyyy-MM-dd'T'HH:mm</p><div></div>.<p></p>",
                  "example": "2021-03-28T17:07:24-07:00",
                  "format": "date-time"
                }
              ]
            },
            {
              "name": "paymentMethods",
              "kind": "optional",
              "type": "array",
              "description": "<p>[OPTIONAL]</p>",
              "example": "",
              "itemType": "object",
              "customType": "object[]",
              "schema": [
                {
                  "name": "paymentType",
                  "kind": "required",
                  "type": "string<bankAccount | cash | check | creditCard | cryptoCurrency | digitalWallet | electronicFundTransfer | giftCard | invoice | loan | loyaltyPoints | moneyOrder | secCard | storeCredit | thirdParty | voucher>",
                  "description": "<p>[REQUIRED] User's tender type (ACH in bankAccount; EFT in electronicFundTransfer).</p>",
                  "enum": [
                    "bankAccount",
                    "cash",
                    "check",
                    "creditCard",
                    "cryptoCurrency",
                    "digitalWallet",
                    "electronicFundTransfer",
                    "giftCard",
                    "invoice",
                    "loan",
                    "loyaltyPoints",
                    "moneyOrder",
                    "secCard",
                    "storeCredit",
                    "thirdParty",
                    "voucher"
                  ]
                },
                {
                  "name": "paymentMethodID",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Unique identifier for the payment method (not a card number). Maximum field length = 100 characters.</p>",
                  "example": "2ljr9vxsdfey"
                },
                {
                  "name": "paymentMethodAmount",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Amount applied to this method (transaction currency). Format = two decimals.</p>\n<p><strong>Note</strong>: Payment amounts can be spread across several payment types in this array.</p>",
                  "example": 500
                },
                {
                  "name": "isPaymentStoredOnFile",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Indicates if method was stored on file.</p>",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "emailAddress",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Email associated with the payment. Maximum field length = 50 characters.</p>",
                  "example": "jane.doe123@gmail.com"
                },
                {
                  "name": "nameOnAccount",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Name on the account when you are sending payment. Maximum field length = 100 characters.</p>",
                  "example": "Jane Doe"
                },
                {
                  "name": "accountType",
                  "kind": "optional",
                  "type": "string<checking | saving | moneyMarket | other>",
                  "description": "<p>[OPTIONAL] Account type when paymentType=bankAccount.</p>",
                  "enum": [
                    "checking",
                    "saving",
                    "moneyMarket",
                    "other"
                  ]
                },
                {
                  "name": "cardNumber",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Primary account number for creditCard. Data must pass ISO/IEC 7812-1 LUHN validation. Minimum field length = 10 characters. Maximum field length = 19 characters.</p>",
                  "example": 5555555555554444
                },
                {
                  "name": "cardToken",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[IMPERATIVE] Tokenized card number for creditCard.</p>",
                  "example": "6f7%gf38hfUa"
                },
                {
                  "name": "expirationMonth",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[IMPERATIVE] Expiry month (MM) for cards/vouchers/points where applicable. Maximum field length = 2 characters.</p>",
                  "example": 11
                },
                {
                  "name": "expirationYear",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[IMPERATIVE] Expiry year (YYYY) for cards/vouchers/points where applicable. Maximum field length = 4 characters.</p>",
                  "example": 2026
                },
                {
                  "name": "expirationDay",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[IMPERATIVE] Expiry day (DD) for vouchers/points when used. Maximum field length = 10 characters.</p>",
                  "example": 12
                },
                {
                  "name": "nameOnCreditCard",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[IMPERATIVE] Cardholder name (creditCard/giftCard). Maximum field length = 100 characters.</p>",
                  "example": "Jane Doe"
                },
                {
                  "name": "cardBin",
                  "kind": "optional",
                  "type": "integer",
                  "description": "<p>[IMPERATIVE] Leading 6–11 digits of the credit card number (numeric only). Minimum field length = 6 digits. Maximum field length = 11 digits. For BIN lookups, Accertify will query the full/encrypted Payment Card Number (PAN).</p>",
                  "example": 345678
                },
                {
                  "name": "cardLastFour",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[IMPERATIVE] Last four digits (numeric only). Must be 4 characters.</p>",
                  "example": 4444
                },
                {
                  "name": "avsResult",
                  "kind": "optional",
                  "type": "string<matched | partialMatch | notMatched | notChecked | systemError | other>",
                  "description": "<p>[IMPERATIVE] Issuer AVS result.</p>",
                  "enum": [
                    "matched",
                    "partialMatch",
                    "notMatched",
                    "notChecked",
                    "systemError",
                    "other"
                  ]
                },
                {
                  "name": "cvvResult",
                  "kind": "optional",
                  "type": "string<matched | notMatched>",
                  "description": "<p>[IMPERATIVE] Issuer CVV result.</p>",
                  "enum": [
                    "matched",
                    "notMatched"
                  ]
                },
                {
                  "name": "cardAuthorizationCode",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Payment card authorization code when available. Maximum field length = 20 characters.</p>",
                  "example": 100
                },
                {
                  "name": "cardAuthorizationDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Payment card authorization date in formatted yyyy-MM-dd'T'HH:mm</p><div></div>.<p></p>",
                  "example": "2010-02-15T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "isPre-AuthorizationReject",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether pre-authorization rejected the payment.</p>",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "post-AuthorizationRejectReason",
                  "kind": "optional",
                  "type": "string<creditReject | fraudReject | otherReject>",
                  "description": "<p>[OPTIONAL] Reason for post-authorization reject.</p>",
                  "enum": [
                    "creditReject",
                    "fraudReject",
                    "otherReject"
                  ]
                },
                {
                  "name": "eciIndicator",
                  "kind": "optional",
                  "type": "string<successful | unsuccessfulOrNotAttempted | attemptedButNotCompleted | other>",
                  "description": "<p>[OPTIONAL] ECI status from card brand.</p>",
                  "enum": [
                    "successful",
                    "unsuccessfulOrNotAttempted",
                    "attemptedButNotCompleted",
                    "other"
                  ]
                },
                {
                  "name": "totalFailedAttempts",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Number of failed attempts on this method. Maximum field length = 100 characters.</p>",
                  "example": 88
                },
                {
                  "name": "paymentMethodCreatedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Payment method creation date formatted yyyy-MM-dd'T'HH:mm</p><div></div>.<p></p>",
                  "example": "2020-03-28T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "paymentMethodUpdatedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Payment method update date formatted yyyy-MM-dd'T'HH:mm</p><div></div>.<p></p>",
                  "example": "2021-03-28T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "giftCardNumber",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Gift card number or account for this payment method. Maximum field length = 100 characters.</p>\n<p><strong>Note</strong>: Shown hashed. We provide the Accertify Hashing Algorithm. If the value appears to be in plain text, we respond \"400 Bad Request\" with the appropriate errorResponse.</p>",
                  "example": "a789sdf8asdfasd89f789asd78"
                },
                {
                  "name": "giftCardLastFour",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Last four digits of gift card. Must be 4 characters.</p>",
                  "example": 1111
                },
                {
                  "name": "giftCardBIN",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] BIN number on the gift card or account for this payment method. Minimum field length = 6 characters.</p>",
                  "example": 4111
                },
                {
                  "name": "paymentMethodBalanceAmount",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Monetary amount left on the card or account at the time of the request. Format = two decimals.</p>",
                  "example": 4000
                },
                {
                  "name": "points",
                  "kind": "optional",
                  "type": "integer",
                  "description": "<p>[OPTIONAL] Number of points being redeemed. Maximum field length = 100 digits.\n<strong>Note</strong>: Numbers only. This could be miles, points, units, or however you refer to the points.</p>",
                  "example": 50000
                },
                {
                  "name": "loyaltyProgramName",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Name of the program governing the points or loyalty program. Maximum field length = 100 characters.</p>",
                  "example": "Acme Platinum"
                },
                {
                  "name": "walletType",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Type of wallet with which the user paid. Maximum field length = 100 characters.</p>",
                  "example": "Venmo, Google Pay, PayPal"
                },
                {
                  "name": "walletStatus",
                  "kind": "optional",
                  "type": "string<active | pending | inactive>",
                  "description": "<p>[OPTIONAL] Wallet account status.</p>",
                  "enum": [
                    "active",
                    "pending",
                    "inactive"
                  ]
                },
                {
                  "name": "isWalletProtectionEligible",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether the wallet is eligible for wallet protection.</p>",
                  "enum": [
                    "true",
                    "false"
                  ]
                }
              ]
            },
            {
              "name": "promotions",
              "kind": "optional",
              "type": "array",
              "description": "<p>[OPTIONAL]</p>",
              "example": "",
              "itemType": "object",
              "customType": "object[]",
              "schema": [
                {
                  "name": "promoCode",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Promotion or discount used. Maximum field length = 40 characters.</p>",
                  "example": "ABC12"
                },
                {
                  "name": "promoAmount",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Promotion or discount amount applied in the currency specified by the transaction currencyCode field. Format = two decimals.</p>",
                  "example": 5555
                },
                {
                  "name": "promoType",
                  "kind": "optional",
                  "type": "string<bogo | bundle | employeeDiscount | freeShipping | loyaltyDiscount | newMemberDiscount | percentage | quantityPromotion | other>",
                  "description": "<p>[OPTIONAL] The type of discount code used.</p>",
                  "enum": [
                    "bogo",
                    "bundle",
                    "employeeDiscount",
                    "freeShipping",
                    "loyaltyDiscount",
                    "newMemberDiscount",
                    "percentage",
                    "quantityPromotion",
                    "other"
                  ]
                }
              ]
            },
            {
              "name": "event",
              "kind": "optional",
              "type": "object",
              "description": "<p>[OPTIONAL] Fields associated with events.</p>",
              "example": "",
              "schema": [
                {
                  "name": "eventID",
                  "kind": "required",
                  "type": "string",
                  "description": "<p>[REQUIRED] Merchant's unique identifier for the event. Maximum field length = 30 characters.</p>",
                  "example": "234kl5jkl523jkl423jkl"
                },
                {
                  "name": "eventType",
                  "kind": "required",
                  "type": "string<activity | comedy | concert | sports | theater>",
                  "description": "<p>[REQUIRED] Nature of the event.</p>",
                  "enum": [
                    "activity",
                    "comedy",
                    "concert",
                    "sports",
                    "theater"
                  ]
                },
                {
                  "name": "eventName",
                  "kind": "required",
                  "type": "string",
                  "description": "<p>[REQUIRED] Display name of the event. Maximum field length = 30 characters.</p>",
                  "example": "Fleetwood Mac"
                },
                {
                  "name": "eventDateTime",
                  "kind": "required",
                  "type": "string<date-time>",
                  "description": "<p>[REQUIRED] Date and time the event starts formatted yyyy-MM-dd'T'HH:mm</p><div></div>.<p></p>",
                  "example": "2022-03-11T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "eventOnSaleDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date and time the event tickets went on sale formatted yyyy-MM-dd'T'HH:mm</p><div></div>.<p></p>",
                  "example": "2022-01-11T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "eventRisk",
                  "kind": "optional",
                  "type": "string<high | medium | low>",
                  "description": "<p>[OPTIONAL] Optional qualitative risk label for this event.</p>",
                  "enum": [
                    "high",
                    "medium",
                    "low"
                  ]
                },
                {
                  "name": "venueID",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[IMPERATIVE] Unique identifier assigned to the venue where the event takes place. Maximum field length = 20 characters.</p>",
                  "example": "223jklk234j3l4"
                },
                {
                  "name": "venueAddressID",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[IMPERATIVE] Unique identifier assigned to the venue address where the event takes place. Maximum field length = 10 characters.</p>",
                  "example": 32433242324
                },
                {
                  "name": "tickets",
                  "kind": "optional",
                  "type": "object",
                  "description": "<p>[OPTIONAL] Fields associated with the tickets for the event.</p>",
                  "modelRef": "#/definitions/tickets",
                  "customType": "tickets",
                  "schema": [
                    {
                      "name": "sectionNumber",
                      "kind": "optional",
                      "type": "string",
                      "description": "<p>[IMPERATIVE] Section number or letters for a series of rows. Maximum field length = 5 characters.</p>",
                      "example": 401
                    },
                    {
                      "name": "sectionName",
                      "kind": "optional",
                      "type": "string",
                      "description": "<p>[IMPERATIVE] Section name for a series of rows (use GA for general admission). Maximum field length = 40 characters.</p>",
                      "example": "GA"
                    },
                    {
                      "name": "row",
                      "kind": "optional",
                      "type": "string",
                      "description": "<p>[IMPERATIVE] Number or letter designation for a single row. Maximum field length = 5 characters.</p>",
                      "example": 24
                    },
                    {
                      "name": "rowName",
                      "kind": "optional",
                      "type": "string",
                      "description": "<p>[IMPERATIVE] Name for a given row. Maximum field length = 5 characters.</p>",
                      "example": "upper"
                    },
                    {
                      "name": "numberOfSeats",
                      "kind": "optional",
                      "type": "number",
                      "description": "<p>[IMPERATIVE] The quantity of seats purchased in the transaction. Maximum field length = 10 characters.</p>",
                      "example": 2
                    },
                    {
                      "name": "startSeat",
                      "kind": "optional",
                      "type": "string",
                      "description": "<p>[IMPERATIVE] First seat number in the contiguous block. Maximum field length = 5 characters.</p>",
                      "example": 2
                    },
                    {
                      "name": "endSeat",
                      "kind": "optional",
                      "type": "string",
                      "description": "<p>[IMPERATIVE] Last seat number in the contiguous block. Maximum field length = 5 characters.</p>",
                      "example": 3
                    }
                  ]
                }
              ]
            }
          ],
          "isExpanded": true
        }
      ],
      "formDataParameters": [],
      "oAuthParameters": [
        {
          "id": "oauth2",
          "name": "oauth2",
          "kind": "optional",
          "type": "oauth2"
        }
      ]
    },
    "responses": [
      {
        "statusCode": "200",
        "description": "Success response",
        "jsonExample": "",
        "isExpanded": true,
        "schema": [
          {
            "kind": "optional",
            "type": "object",
            "example": "{\"transaction-results\":{\"transaction-id\":\"23\",\"cross-reference\":\"f85b9ed2-fe5a-425a-9ff5-a9988e56110b\",\"rules-tripped\":\"5237260000001680431:obsrv_Transaction Total Amount Greater Than 500:500;\",\"total-score\":500,\"recommendation-code\":\"ACCEPT\",\"remarks\":\"\"},\"validation_response\":{\"warnings\":{\"ipAddress\":\"ipAddress is invalid\"},\"originalValues\":{\"ipAddress\":\"1\"},\"status\":\"true\"}}",
            "description": "Success response",
            "customType": "successResponse",
            "schema": [
              {
                "name": "transaction-results",
                "kind": "optional",
                "type": "object",
                "description": "A block indicating the results of your successful call.",
                "example": "",
                "schema": [
                  {
                    "name": "transaction-id",
                    "kind": "optional",
                    "type": "string",
                    "description": "<p>Transaction's unique identifier. Typically, this is your order number.</p>\n<p><strong>Note</strong>: This is the transactionID field.</p>"
                  },
                  {
                    "name": "cross-reference",
                    "kind": "optional",
                    "type": "string",
                    "description": "Unique identifier Accertify assigns to this transaction. It is a cross reference to the transactionID field."
                  },
                  {
                    "name": "rules-tripped",
                    "kind": "optional",
                    "type": "string",
                    "description": "<p>Identifier, description, and score of the rules that tripped on this transaction.</p>\n<p><strong>Example</strong>: 5237260000001628419</p><div></div> Between IP Postal Code and Billing Postal Code Greater Than 1000<div></div>\nWhere:<p></p>\n<ul>\n<li>Identifier: 5237260000001628419</li>\n<li>Description: apir_Distance Between IP Postal Code and Billing Postal Code Greater Than 1000</li>\n<li>Score: 500</li>\n</ul>"
                  },
                  {
                    "name": "total-score",
                    "kind": "optional",
                    "type": "integer",
                    "description": "The accumulated fraud score of this transaction."
                  },
                  {
                    "name": "recommendation-code",
                    "kind": "optional",
                    "type": "string<ACCEPT | REJECT | REVIEW | ACCEPT_POLICY | REJECT_POLICY | REVIEW_POLICY>",
                    "description": "<p>Our transaction recommendation.</p>\n<ul>\n<li>ACCEPT</li>\n<li>REJECT</li>\n<li>REVIEW</li>\n<li>ACCEPT_POLICY</li>\n<li>REJECT_POLICY</li>\n<li>REVIEW_POLICY</li>\n</ul>",
                    "enum": [
                      "ACCEPT",
                      "REJECT",
                      "REVIEW",
                      "ACCEPT_POLICY",
                      "REJECT_POLICY",
                      "REVIEW_POLICY"
                    ]
                  },
                  {
                    "name": "remarks",
                    "kind": "optional",
                    "type": "string",
                    "description": "<p>Details left by an analyst if they resolve the transaction.</p>\n<p><strong>Example</strong>: AT: 5/5/21 1:04</p><div></div> PM CDT<p></p>"
                  }
                ]
              },
              {
                "name": "validation_response",
                "kind": "optional",
                "type": "object",
                "description": "",
                "example": "",
                "schema": [
                  {
                    "name": "warnings",
                    "kind": "optional",
                    "type": "map",
                    "description": "Map of field names and warning messages that may impair fraud scoring if not resolved.",
                    "example": "",
                    "customType": "map<string, string>",
                    "schema": []
                  },
                  {
                    "name": "originalValues",
                    "kind": "optional",
                    "type": "map",
                    "description": "Map of field names and input values present when warnings or errors are reported.\n\nThe values here should be fixed to validate.\n",
                    "example": "",
                    "customType": "map<string, string>",
                    "schema": []
                  },
                  {
                    "name": "status",
                    "kind": "optional",
                    "type": "string<true | false>",
                    "description": "<p>Whether the validation has errors.</p>\n<p>Options are:</p>\n<ul>\n<li>true when there are no errors.</li>\n<li>false when there are errors.</li>\n</ul>",
                    "enum": [
                      "true",
                      "false"
                    ]
                  }
                ]
              }
            ],
            "modelRef": "#/definitions/successResponse",
            "isExpanded": true
          }
        ]
      },
      {
        "statusCode": "400",
        "description": "Error response",
        "jsonExample": "",
        "isExpanded": true,
        "schema": [
          {
            "kind": "optional",
            "type": "object",
            "example": "{\"validation_response\":{\"errors\":{\"Transaction ID\":\"A unique transaction ID is required (max length = 40)\",\"ipAddress\":\"ipAddress is required\"},\"warnings\":{},\"originalValues\":{\"transaction-id\":\"23\",\"ipAddress\":\"1\"},\"status\":\"false\"}}",
            "description": "Error response",
            "customType": "errorResponse",
            "schema": [
              {
                "name": "validation_response",
                "kind": "optional",
                "type": "object",
                "description": "",
                "example": "",
                "schema": [
                  {
                    "name": "errors",
                    "kind": "optional",
                    "type": "map",
                    "description": "Map of field names and error messages that have prevented processing of the transaction.",
                    "example": "",
                    "customType": "map<string, string>",
                    "schema": []
                  },
                  {
                    "name": "warnings",
                    "kind": "optional",
                    "type": "map",
                    "description": "Map of field names and warning messages that may impair fraud scoring if not resolved.",
                    "example": "",
                    "customType": "map<string, string>",
                    "schema": []
                  },
                  {
                    "name": "originalValues",
                    "kind": "optional",
                    "type": "map",
                    "description": "Map of field names and input values present when warnings or errors are reported.\n\nThe values here should be fixed to validate.\n",
                    "example": "",
                    "customType": "map<string, string>",
                    "schema": []
                  },
                  {
                    "name": "status",
                    "kind": "optional",
                    "type": "string<true | false>",
                    "description": "<p>Whether the validation has errors.</p>\n<p>Options are:</p>\n<ul>\n<li>true when there are no errors.</li>\n<li>false when there are errors.</li>\n</ul>",
                    "enum": [
                      "true",
                      "false"
                    ]
                  }
                ]
              }
            ],
            "modelRef": "#/definitions/errorResponse",
            "isExpanded": true
          }
        ]
      },
      {
        "statusCode": "500",
        "description": "",
        "jsonExample": "",
        "isExpanded": true
      }
    ],
    "examples": {
      "languages": [
        {
          "id": "example-0-curl",
          "language": "curl",
          "label": "cURL",
          "code": "curl --request POST \\\n     --url https://icnow01.accertify.net/icNowImport/{importerID} \\\n     --header 'accept: application/json' \\\n     --header 'content-type: application/json' \\\n     --data '{\n     \"transactionID\": \"ABC123456\",\n     \"transactionType\": \"preAuthorization\",\n     \"transactionDateTime\": \"2022-03-11T17:07:24-07:00\",\n     \"paymentAmount\": 1082.91,\n     \"currencyCode\": \"USD\",\n     \"success\": \"\",\n     \"purchaseType\": \"\",\n     \"eventSource\": \"\",\n     \"paymentMethods\": [\n     {\n     \"paymentType\": \"\"\n     }\n     ],\n     \"event\": {\n     \"eventID\": \"234kl5jkl523jkl423jkl\",\n     \"eventType\": \"\",\n     \"eventName\": \"Fleetwood Mac\",\n     \"eventDateTime\": \"2022-03-11T17:07:24-07:00\"\n     }\n     }'"
        },
        {
          "id": "example-1-javascript",
          "language": "javascript",
          "label": "javascript",
          "code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar raw = JSON.stringify({\n   \"transactionID\": \"ABC123456\",\n   \"transactionType\": \"preAuthorization\",\n   \"transactionDateTime\": \"2022-03-11T17:07:24-07:00\",\n   \"paymentAmount\": 1082.91,\n   \"currencyCode\": \"USD\",\n   \"success\": \"\",\n   \"purchaseType\": \"\",\n   \"eventSource\": \"\",\n   \"paymentMethods\": [\n      {\n         \"paymentType\": \"\"\n      }\n   ],\n   \"event\": {\n      \"eventID\": \"234kl5jkl523jkl423jkl\",\n      \"eventType\": \"\",\n      \"eventName\": \"Fleetwood Mac\",\n      \"eventDateTime\": \"2022-03-11T17:07:24-07:00\"\n   }\n});\n\nvar requestOptions = {\n   method: 'POST',\n   headers: myHeaders,\n   body: raw,\n   redirect: 'follow'\n};\n\nfetch(\"https://icnow01.accertify.net/icNowImport/{importerID}\", requestOptions)\n   .then(response => response.text())\n   .then(result => console.log(result))\n   .catch(error => console.log('error', error));"
        },
        {
          "id": "example-2-ruby",
          "language": "ruby",
          "label": "Ruby",
          "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://icnow01.accertify.net/icNowImport/{importerID}\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\nrequest.body = JSON.dump({\n   \"transactionID\": \"ABC123456\",\n   \"transactionType\": \"preAuthorization\",\n   \"transactionDateTime\": \"2022-03-11T17:07:24-07:00\",\n   \"paymentAmount\": 1082.91,\n   \"currencyCode\": \"USD\",\n   \"success\": \"\",\n   \"purchaseType\": \"\",\n   \"eventSource\": \"\",\n   \"paymentMethods\": [\n      {\n         \"paymentType\": \"\"\n      }\n   ],\n   \"event\": {\n      \"eventID\": \"234kl5jkl523jkl423jkl\",\n      \"eventType\": \"\",\n      \"eventName\": \"Fleetwood Mac\",\n      \"eventDateTime\": \"2022-03-11T17:07:24-07:00\"\n   }\n})\n\nresponse = https.request(request)\nputs response.read_body\n"
        },
        {
          "id": "example-3-python",
          "language": "python",
          "label": "Python",
          "code": "import requests\nimport json\n\nurl = \"https://icnow01.accertify.net/icNowImport/{importerID}\"\n\npayload = json.dumps({\n   \"transactionID\": \"ABC123456\",\n   \"transactionType\": \"preAuthorization\",\n   \"transactionDateTime\": \"2022-03-11T17:07:24-07:00\",\n   \"paymentAmount\": 1082.91,\n   \"currencyCode\": \"USD\",\n   \"success\": \"\",\n   \"purchaseType\": \"\",\n   \"eventSource\": \"\",\n   \"paymentMethods\": [\n      {\n         \"paymentType\": \"\"\n      }\n   ],\n   \"event\": {\n      \"eventID\": \"234kl5jkl523jkl423jkl\",\n      \"eventType\": \"\",\n      \"eventName\": \"Fleetwood Mac\",\n      \"eventDateTime\": \"2022-03-11T17:07:24-07:00\"\n   }\n})\nheaders = {\n   'accept': 'application/json',\n   'content-type': 'application/json'\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
        }
      ],
      "selectedLanguageId": "example-0-curl"
    },
    "results": {
      "languages": [
        {
          "id": "response-0-200",
          "language": "200",
          "code": "// Success response\n{\n  \"transaction-results\": {\n    \"transaction-id\": \"\",\n    \"cross-reference\": \"\",\n    \"rules-tripped\": \"\",\n    \"total-score\": 0,\n    \"recommendation-code\": \"\",\n    \"remarks\": \"\"\n  },\n  \"validation_response\": {\n    \"warnings\": \"\",\n    \"originalValues\": \"\",\n    \"status\": \"\"\n  }\n}"
        },
        {
          "id": "response-1-400",
          "language": "400",
          "code": "// Error response\n{\n  \"validation_response\": {\n    \"errors\": \"\",\n    \"warnings\": \"\",\n    \"originalValues\": \"\",\n    \"status\": \"\"\n  }\n}"
        },
        {
          "id": "response-2-500",
          "language": "500",
          "code": ""
        }
      ],
      "selectedLanguageId": "response-0-200"
    }
  },
  "children": [
    {
      "text": ""
    }
  ]
}