---
title: transaction payment processing
slug: montse/_WrT-transaction-payment-processing
createdAt: 2026-06-05T16:14:33.541Z
---

{
  "id": "4ccqJWL9TQIi2d-AkwTQs",
  "type": "api-oas-v2",
  "data": {
    "method": "POST",
    "url": "https://api.accertify.net//rtd01.eu.accertify.net/icNowImport/{importerID}",
    "name": "transaction payment processing",
    "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",
          "example": "{\"transactionID\":\"ABC123456\",\"transactionType\":\"postAuthorization\",\"transactionDateTime\":\"2022-03-11T17:07:24-07:00\",\"eventSource\":\"web\",\"accountID\":\"12363454566\",\"isGuestCheckout\":\"false\",\"paymentAmount\":1082.91,\"taxAmount\":1.23,\"currencyCode\":\"USD\",\"success\":\"false\",\"ipAddress\":\"10.12.12.123\",\"userAgent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:72.0) Gecko/20100101 Firefox/72.0\",\"deviceTransactionID\":\"e1a1aade06e2557f34036eeb06173faf1fa05c64959383\",\"devicePayload\":\"afklasdjlasdjl3l23j23423klj\",\"ubaID\":\"3143e969395de649c48c1c9f3e363a3e7ae7\",\"sessionID\":\"5A9CE2800C3CFF97993208AB5B3D63C0\",\"emailAddress\":\"a@b.com\",\"username\":\"erlichb\",\"authenticationMethod\":\"magicLink\",\"failureCode\":\"authFailed\",\"brand\":\"acme\",\"phoneNumber\":\"3125555555\",\"latitude\":33.836,\"longitude\":-117.914,\"hashedPassword\":\"234j32llk234j3l2k4jl\",\"accountStatus\":\"dormant\",\"firstName\":\"Jane\",\"middleName\":\"Marie\",\"lastName\":\"Doe\",\"purchaseType\":\"physicalItems\",\"listingID\":\"abcd1234\",\"loyaltyNumber\":\"Id1234\",\"account\":{\"isEnrolledInLoyaltyProgram\":\"true\",\"isMobileAppInstalled\":\"true\",\"accountLocale\":\"en-US\",\"accountLevel\":\"Gold\",\"accountType\":\"family\",\"accountReferralCode\":\"john.doe123@email.com\",\"accountRegistrationDateTime\":\"2020-11-22T17:07:24-07:00\",\"accountEmailUpdatedDateTime\":\"2020-08-28T19:00:00-04:00\",\"accountEmailVerifiedDateTime\":\"2020-08-28T19:00:00-04:00\",\"accountPasswordUpdatedDateTime\":\"2021-08-28T19:00:00-04:00\",\"dateOfBirth\":\"1985-11-15\",\"totalCreditCardsOnFile\":\"5\",\"totalInactiveCreditCardsOnFile\":\"1\",\"totalPurchases\":\"123456\",\"totalRefunds\":\"1235\",\"totalOrdersAmount\":\"123456789\",\"loyaltyProgramName\":\"Members Plus\",\"loyaltyNumberStartDateTime\":\"2020-11-22T17:07:24-07:00\",\"loyaltyNumberLastUsedDateTime\":\"2020-02-22T17:07:24-07:00\",\"loyaltyLastUsedPoints\":\"123\",\"loyaltyPointsBalance\":\"987654321\",\"loyaltyLastEarnedPoints\":\"1234\",\"loyaltyLastEarnedDateTime\":\"2021-01-22T17:07:24-07:00\",\"loyaltyPromotionMessageType\":\"email\"},\"payment\":{\"cartID\":\"Cart #123\",\"salesRepID\":\"SR#46k90\",\"websiteURL\":\"yahoo.com\",\"referralCode\":\"API 210315\",\"isGift\":\"true\",\"giftMessage\":\"Enjoy the gift\",\"deliveryFee\":2,\"deliveryFeeType\":\"consumerPaid\",\"isPaymentInInstallments\":\"false\",\"isPaymentRecurring\":\"false\",\"totalFailedTransactions\":\"99\",\"isTravelPackagePurchased\":\"false\"},\"addresses\":[{\"addressID\":\"23l4jk23klj23\",\"addressType\":\"shipping\",\"primaryFlag\":\"true\",\"isAddressOnFile\":\"false\",\"firstName\":\"Jane\",\"middleName\":\"Marie\",\"lastName\":\"Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"phone\":\"3125555555\",\"phoneCountryCode\":\"001\",\"address1\":\"1863 Main Street\",\"address2\":\"Apt 7\",\"city\":\"Anaheim\",\"region\":\"CA\",\"postCode\":\"92802\",\"country\":\"US\",\"companyName\":\"Accertify, Inc\",\"locationType\":\"business\",\"addressCreatedDateTime\":\"2020-03-28T17:07:24-07:00\",\"addressUpdatedDateTime\":\"2021-03-28T17:07:24-07:00\"},{\"addressID\":\"23l4jk23klj23\",\"addressType\":\"billing\",\"primaryFlag\":\"true\",\"isAddressOnFile\":\"false\",\"firstName\":\"Jane\",\"middleName\":\"Marie\",\"lastName\":\"Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"phone\":\"3125555555\",\"phoneCountryCode\":\"001\",\"address1\":\"1776 W. Washington Street\",\"city\":\"Anaheim\",\"region\":\"CA\",\"postCode\":\"92802\",\"country\":\"US\",\"companyName\":\"Cool Stuff!\",\"locationType\":\"residence\",\"addressCreatedDateTime\":\"2020-03-28T17:07:24-07:00\",\"addressUpdatedDateTime\":\"2021-03-28T17:07:24-07:00\"}],\"paymentMethods\":[{\"paymentType\":\"creditCard\",\"paymentMethodID\":\"2ljr9vxsdfew\",\"paymentMethodAmount\":399,\"isPaymentStoredOnFile\":\"true\",\"cardNumber\":\"\",\"cardToken\":\"6f7%gf38hfUa\",\"expirationMonth\":\"11\",\"expirationYear\":\"2020\",\"nameOnCreditCard\":\"Jane Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"cardBin\":345678,\"cardLastFour\":\"1111\",\"avsResult\":\"matched\",\"cvvResult\":\"matched\",\"cardAuthorizationCode\":\"12345\",\"cardAuthorizationDateTime\":\"2020-11-22T17:07:24-07:00\",\"isPre-AuthorizationReject\":\"false\",\"post-AuthorizationRejectReason\":\"creditReject\",\"eciIndicator\":\"unsuccessfulOrNotAttempted\",\"totalFailedAttempts\":88,\"paymentMethodCreatedDateTime\":\"2020-03-28T17:07:24-07:00\",\"paymentMethodUpdatedDateTime\":\"2020-03-28T17:07:24-07:00\"},{\"paymentType\":\"digitalWallet\",\"paymentMethodID\":\"2ljr9vxsdfey\",\"paymentMethodAmount\":150,\"isPaymentStoredOnFile\":\"true\",\"nameOnAccount\":\"Jane Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"walletType\":\"Applepay\",\"walletStatus\":\"active\",\"isWalletProtectionEligible\":\"true\",\"paymentMethodBalanceAmount\":4000,\"totalFailedAttempts\":88},{\"paymentType\":\"giftCard\",\"paymentMethodID\":\"2ljr9vxsdfex\",\"paymentMethodAmount\":350,\"nameOnAccount\":\"Jane Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"giftCardNumber\":\"a789sdf8asdfasd89f789asd78\",\"giftCardLastFour\":\"1111\",\"giftCardBIN\":\"4111\",\"expirationMonth\":\"11\",\"expirationYear\":\"2026\",\"paymentMethodBalanceAmount\":4000},{\"paymentType\":\"voucher\",\"paymentMethodID\":\"2ljr9vxsdfez\",\"paymentMethodAmount\":500,\"nameOnAccount\":\"Jane Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"expirationDay\":\"12\",\"expirationMonth\":\"11\",\"expirationYear\":\"2026\",\"paymentMethodBalanceAmount\":4000},{\"paymentType\":\"loyaltyPoints\",\"paymentMethodID\":\"2ljr9vxsdfeu\",\"paymentMethodAmount\":500,\"nameOnAccount\":\"Jane Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"points\":50000,\"expirationDay\":\"12\",\"expirationMonth\":\"11\",\"expirationYear\":\"2026\",\"loyaltyProgramName\":\"Acme Platinum\",\"paymentMethodBalanceAmount\":4000},{\"paymentType\":\"bankAccount\",\"paymentMethodID\":\"18881118929\",\"paymentMethodAmount\":500,\"isPaymentStoredOnFile\":\"true\",\"nameOnAccount\":\"Jane Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"accountType\":\"checking\"}],\"promotions\":[{\"promoCode\":\"ABC12\",\"promoAmount\":5555,\"promoType\":\"employeeDiscount\"},{\"promoCode\":\"ABC1234\",\"promoAmount\":50,\"promoType\":\"freeShipping\"}],\"items\":[{\"isUpsell\":\"false\",\"itemType\":\"physicalGood\",\"brandName\":\"Apple\",\"description\":\"Macbook Pro\",\"category\":\"Computers\",\"itemID\":\"af877wernnasnfes\",\"price\":1199.99,\"faceValueAmount\":1599.99,\"quantity\":2,\"addressID\":\"2lkj34jldsoufsous82df\",\"productCondition\":\"new\",\"shippingCompany\":\"ups\",\"shippingMethod\":\"ground\",\"shippingTrackingNumber\":\"23l4fdswerea02\",\"isLargeItemDelivery\":\"true\",\"promoCode\":\"ABC12\",\"promoAmount\":5555,\"promoType\":\"employeeDiscount\",\"pickupLocation\":\"curbside\",\"pickupLocationDescription\":\"At main entrance\",\"pickupPersonFirstNamePrimary\":\"Betty\",\"pickupPersonLastNamePrimary\":\"Smith\",\"pickupPersonFirstNameAlternate\":\"Mary\",\"pickupPersonLastNameAlternate\":\"Jones\",\"pickupVerificationMethod\":\"idCard\",\"pickupDateTime\":\"2022-03-11T17:07:24-07:00\",\"pickupVerificationSignatureImage\":\"*** Base 64 encoding ***\",\"pickupVerificationIDCardImage\":\"***Base 64 encoding ***\"}]}",
          "description": "The inputs to process a transaction.",
          "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": "postAuthorization",
              "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 (optional).</p>",
              "example": "12363454566"
            },
            {
              "name": "isGuestCheckout",
              "kind": "optional",
              "type": "string<true | false>",
              "description": "<p>[OPTIONAL] Whether checkout happened without logging in to an account.</p>",
              "example": "false",
              "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>",
              "example": "false",
              "enum": [
                "true",
                "false"
              ]
            },
            {
              "name": "failureCode",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] Failure reason code when applicable (e.g., authFailed, other).</p>",
              "example": "authFailed"
            },
            {
              "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>",
              "example": "3125555555"
            },
            {
              "name": "purchaseType",
              "kind": "required",
              "type": "string<physicalItems | digitalItems | services | other>",
              "description": "<p>[REQUIRED] High‑level purchase classification.</p>",
              "example": "physicalItems",
              "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, etc.).</p>",
              "example": "web",
              "enum": [
                "agentPhone",
                "agentStore",
                "affiliate",
                "kiosk",
                "mobileApp",
                "other",
                "web"
              ]
            },
            {
              "name": "ipAddress",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] End‑user IP address. Max length 45.</p>",
              "example": "10.12.12.123"
            },
            {
              "name": "userAgent",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] Browser/OS user agent captured by the site owner. Max length 250.</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] Accertify Device payload from JS/SDK (recommended over deviceTransactionID).</p>",
              "example": "afklasdjlasdjl3l23j23423klj"
            },
            {
              "name": "deviceTransactionID",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] Accertify Device transaction identifier from JS/SDK.</p>",
              "example": "e1a1aade06e2557f34036eeb06173faf1fa05c64959383"
            },
            {
              "name": "ubaID",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] Accertify UBA token linking to captured behavioral data.</p>",
              "example": "3143e969395de649c48c1c9f3e363a3e7ae7"
            },
            {
              "name": "emailAddress",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] User’s email associated with the account/transaction.</p>",
              "example": "a@b.com"
            },
            {
              "name": "ubaEvents",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] Recent UBA payload for up‑to‑the‑second behavior.</p>",
              "example": "lasjdlkfdsljelkrrjwl3kl324j32k432"
            },
            {
              "name": "pageID",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] Unique page identifier from the Collector script.</p>",
              "example": "lk32j4lk324lkj324"
            },
            {
              "name": "username",
              "kind": "optional",
              "type": "string",
              "description": "<p>[IMPERATIVE] Site username when login via username is supported.</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, etc.).</p>",
              "example": "magicLink",
              "enum": [
                "appAuthenticator",
                "appPush",
                "FIDO",
                "other",
                "password",
                "magicLink",
                "SMS"
              ]
            },
            {
              "name": "latitude",
              "kind": "optional",
              "type": "number",
              "description": "<p>[OPTIONAL] HTML5/GPS latitude (decimal degrees).</p>",
              "example": 33.836
            },
            {
              "name": "longitude",
              "kind": "optional",
              "type": "number",
              "description": "<p>[OPTIONAL] HTML5/GPS longitude (decimal degrees).</p>",
              "example": -117.914
            },
            {
              "name": "hashedPassword",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] User’s password hashed using Accertify algorithm when required.</p>",
              "example": "234j32llk234j3l2k4jl"
            },
            {
              "name": "accountStatus",
              "kind": "optional",
              "type": "string<active | dormant | suspended | terminated | trial | other>",
              "description": "<p>[OPTIONAL] Account state as maintained by the merchant.</p>",
              "example": "dormant",
              "enum": [
                "active",
                "dormant",
                "suspended",
                "terminated",
                "trial",
                "other"
              ]
            },
            {
              "name": "brand",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] Brand submitting the event (for multi‑brand orgs).</p>",
              "example": "acme"
            },
            {
              "name": "sessionID",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] Merchant session identifier for browsing session.</p>",
              "example": "5A9CE2800C3CFF97993208AB5B3D63C0"
            },
            {
              "name": "ubaSessionID",
              "kind": "optional",
              "type": "string",
              "description": "<p>[OPTIONAL] Accertify‑defined UBA session identifier.</p>",
              "example": "961b521892e68f6c4d1c8459dfb530466eed"
            },
            {
              "name": "account",
              "kind": "optional",
              "type": "object",
              "description": "<p>[OPTIONAL]</p>",
              "example": "{\"isEnrolledInLoyaltyProgram\":\"true\",\"isMobileAppInstalled\":\"true\",\"accountLocale\":\"en-US\",\"accountLevel\":\"Gold\",\"accountType\":\"family\",\"accountReferralCode\":\"john.doe123@email.com\",\"accountRegistrationDateTime\":\"2020-11-22T17:07:24-07:00\",\"accountEmailUpdatedDateTime\":\"2020-08-28T19:00:00-04:00\",\"accountEmailVerifiedDateTime\":\"2020-08-28T19:00:00-04:00\",\"accountPasswordUpdatedDateTime\":\"2021-08-28T19:00:00-04:00\",\"dateOfBirth\":\"1985-11-15\",\"totalCreditCardsOnFile\":\"5\",\"totalInactiveCreditCardsOnFile\":\"1\",\"totalPurchases\":\"123456\",\"totalRefunds\":\"1235\",\"totalOrdersAmount\":\"123456789\",\"loyaltyProgramName\":\"Members Plus\",\"loyaltyNumberStartDateTime\":\"2020-11-22T17:07:24-07:00\",\"loyaltyNumberLastUsedDateTime\":\"2020-02-22T17:07:24-07:00\",\"loyaltyLastUsedPoints\":\"123\",\"loyaltyPointsBalance\":\"987654321\",\"loyaltyLastEarnedPoints\":\"1234\",\"loyaltyLastEarnedDateTime\":\"2021-01-22T17:07:24-07:00\",\"loyaltyPromotionMessageType\":\"email\"}",
              "schema": [
                {
                  "name": "isEnrolledInLoyaltyProgram",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether the purchaser is enrolled in a loyalty program.</p>",
                  "example": "true",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "isMobileAppInstalled",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether the merchant’s mobile app is installed on any device.</p>",
                  "example": "true",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "accountLocale",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Preferred locale (e.g., en-US).</p>",
                  "example": "en-US"
                },
                {
                  "name": "accountLevel",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Membership/account level (e.g., Gold).</p>",
                  "example": "Gold"
                },
                {
                  "name": "accountType",
                  "kind": "optional",
                  "type": "string<individual | business | family | other>",
                  "description": "<p>[OPTIONAL] Type of account.</p>",
                  "example": "family",
                  "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.doe123@email.com"
                },
                {
                  "name": "accountRegistrationDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date/time the account was created (RFC3339).</p>",
                  "example": "2020-11-22T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "accountEmailUpdatedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date/time when account email was last updated.</p>",
                  "example": "2020-08-28T19:00:00-04:00",
                  "format": "date-time"
                },
                {
                  "name": "accountEmailVerifiedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date/time when account email was last verified.</p>",
                  "example": "2020-08-28T19:00:00-04:00",
                  "format": "date-time"
                },
                {
                  "name": "accountPasswordUpdatedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date/time when account password was last updated.</p>",
                  "example": "2021-08-28T19:00:00-04:00",
                  "format": "date-time"
                },
                {
                  "name": "dateOfBirth",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] DOB in YYYY‑MM‑DD format.</p>",
                  "example": "1985-11-15"
                },
                {
                  "name": "totalCreditCardsOnFile",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Count of cards on file.</p>",
                  "example": "5"
                },
                {
                  "name": "totalInactiveCreditCardsOnFile",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Count of inactive cards on file.</p>",
                  "example": "1"
                },
                {
                  "name": "totalPurchases",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Lifetime number of purchases.</p>",
                  "example": "123456"
                },
                {
                  "name": "totalRefunds",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Lifetime number of refunds.</p>",
                  "example": "1235"
                },
                {
                  "name": "totalOrdersAmount",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Lifetime total order amount (in transaction currency).</p>",
                  "example": "123456789"
                },
                {
                  "name": "loyaltyProgramName",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Name of loyalty program governing points/miles.</p>",
                  "example": "Members Plus"
                },
                {
                  "name": "loyaltyNumberStartDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date/time the loyalty account was opened.</p>",
                  "example": "2020-11-22T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "loyaltyNumberLastUsedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date/time the loyalty account was last used.</p>",
                  "example": "2020-02-22T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "loyaltyLastUsedPoints",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Points used on the last redemption.</p>",
                  "example": "123"
                },
                {
                  "name": "loyaltyPointsBalance",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Current points balance.</p>",
                  "example": "987654321"
                },
                {
                  "name": "loyaltyLastEarnedPoints",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Points earned on the last earn event.</p>",
                  "example": "1234"
                },
                {
                  "name": "loyaltyLastEarnedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Date/time of last earn event.</p>",
                  "example": "2021-01-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>",
                  "example": "email",
                  "enum": [
                    "postalMail",
                    "email",
                    "smsText",
                    "none"
                  ]
                }
              ]
            },
            {
              "name": "payment",
              "kind": "optional",
              "type": "object",
              "description": "<p>[OPTIONAL]</p>",
              "example": "{\"cartID\":\"Cart #123\",\"salesRepID\":\"SR#46k90\",\"websiteURL\":\"yahoo.com\",\"referralCode\":\"API 210315\",\"isGift\":\"true\",\"giftMessage\":\"Enjoy the gift\",\"deliveryFee\":2,\"deliveryFeeType\":\"consumerPaid\",\"isPaymentInInstallments\":\"false\",\"isPaymentRecurring\":\"false\",\"totalFailedTransactions\":\"99\",\"isTravelPackagePurchased\":\"false\"}",
              "schema": [
                {
                  "name": "cartID",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Merchant session/cart identifier for this purchase.</p>",
                  "example": "Cart #123"
                },
                {
                  "name": "salesRepID",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Sales representative identifier when applicable.</p>",
                  "example": "SR#46k90"
                },
                {
                  "name": "websiteURL",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Website that captured the transaction (max 2048 chars).</p>",
                  "example": "yahoo.com"
                },
                {
                  "name": "referralCode",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Affiliate or campaign code used to reach the site.</p>",
                  "example": "API 210315"
                },
                {
                  "name": "isGift",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Indicates the order is a gift.</p>",
                  "example": "true",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "giftMessage",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Freeform gift message.</p>",
                  "example": "Enjoy the gift"
                },
                {
                  "name": "deliveryFee",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Delivery fee amount.</p>",
                  "example": 2
                },
                {
                  "name": "deliveryFeeType",
                  "kind": "optional",
                  "type": "string<free | consumerPaid | subscription | other>",
                  "description": "<p>[OPTIONAL] Type/sponsor of delivery fee.</p>",
                  "example": "consumerPaid",
                  "enum": [
                    "free",
                    "consumerPaid",
                    "subscription",
                    "other"
                  ]
                },
                {
                  "name": "isPaymentInInstallments",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether the payment is split into installments.</p>",
                  "example": "false",
                  "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>",
                  "example": "false",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "totalFailedTransactions",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Count of failed transaction attempts for this order/session.</p>",
                  "example": "99"
                },
                {
                  "name": "isTravelPackagePurchased",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether a travel package was included in the purchase.</p>",
                  "example": "false",
                  "enum": [
                    "true",
                    "false"
                  ]
                }
              ]
            },
            {
              "name": "items",
              "kind": "optional",
              "type": "array",
              "description": "<p>[OPTIONAL]</p>",
              "example": "[{\"isUpsell\":\"false\",\"itemType\":\"physicalGood\",\"brandName\":\"Apple\",\"description\":\"Macbook Pro\",\"category\":\"Computers\",\"itemID\":\"af877wernnasnfes\",\"price\":1199.99,\"faceValueAmount\":1599.99,\"quantity\":2,\"addressID\":\"2lkj34jldsoufsous82df\",\"productCondition\":\"new\",\"shippingCompany\":\"ups\",\"shippingMethod\":\"ground\",\"shippingTrackingNumber\":\"23l4fdswerea02\",\"isLargeItemDelivery\":\"true\",\"promoCode\":\"ABC12\",\"promoAmount\":5555,\"promoType\":\"employeeDiscount\",\"pickupLocation\":\"curbside\",\"pickupLocationDescription\":\"At main entrance\",\"pickupPersonFirstNamePrimary\":\"Betty\",\"pickupPersonLastNamePrimary\":\"Smith\",\"pickupPersonFirstNameAlternate\":\"Mary\",\"pickupPersonLastNameAlternate\":\"Jones\",\"pickupVerificationMethod\":\"idCard\",\"pickupDateTime\":\"2022-03-11T17:07:24-07:00\",\"pickupVerificationSignatureImage\":\"*** Base 64 encoding ***\",\"pickupVerificationIDCardImage\":\"***Base 64 encoding ***\"}]",
              "itemType": "object",
              "customType": "object[]",
              "schema": [
                {
                  "name": "isUpsell",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Indicates if item was upsold.</p>",
                  "example": "false",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "itemType",
                  "kind": "optional",
                  "type": "string<giftCard | parking | physicalGood | reservation | subscription | ticket | other>",
                  "description": "<p>[OPTIONAL] Nature of item.</p>",
                  "example": "physicalGood",
                  "enum": [
                    "giftCard",
                    "parking",
                    "physicalGood",
                    "reservation",
                    "subscription",
                    "ticket",
                    "other"
                  ]
                },
                {
                  "name": "brandName",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Item’s brand name.</p>",
                  "example": "Apple"
                },
                {
                  "name": "category",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Item category.</p>",
                  "example": "Computers"
                },
                {
                  "name": "description",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Short description.</p>",
                  "example": "Macbook Pro"
                },
                {
                  "name": "itemID",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Merchant SKU/identifier.</p>",
                  "example": "af877wernnasnfes"
                },
                {
                  "name": "price",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Item price (two decimals).</p>",
                  "example": 1199.99
                },
                {
                  "name": "faceValueAmount",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Original/face value amount where it differs from price.</p>",
                  "example": 1599.99
                },
                {
                  "name": "quantity",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Quantity (supports decimals).</p>",
                  "example": 2
                },
                {
                  "name": "addressID",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Link to an entry in addresses[] for delivery/pickup context.</p>",
                  "example": "2lkj34jldsoufsous82df"
                },
                {
                  "name": "productCondition",
                  "kind": "optional",
                  "type": "string<new | openPackage | other | refurbished | used>",
                  "description": "<p>[OPTIONAL] Condition of the product.</p>",
                  "example": "new",
                  "enum": [
                    "new",
                    "openPackage",
                    "other",
                    "refurbished",
                    "used"
                  ]
                },
                {
                  "name": "shippingCompany",
                  "kind": "optional",
                  "type": "string<dhl | fedex | ups | usps | other>",
                  "description": "<p>[OPTIONAL] Carrier for merchant‑to‑consumer delivery.</p>",
                  "example": "ups",
                  "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>",
                  "example": "ground",
                  "enum": [
                    "digital",
                    "ground",
                    "international",
                    "other",
                    "nextDay",
                    "sameDay",
                    "storePickup",
                    "twoDay",
                    "threeDay"
                  ]
                },
                {
                  "name": "shippingTrackingNumber",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Carrier tracking number.</p>",
                  "example": "23l4fdswerea02"
                },
                {
                  "name": "isLargeItemDelivery",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Whether delivery is for a large item.</p>",
                  "example": "true",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "promoCode",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Line‑level promo code if applied here.</p>",
                  "example": "ABC12"
                },
                {
                  "name": "promoAmount",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Line‑level discount amount (transaction currency).</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>",
                  "example": "employeeDiscount",
                  "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>",
                  "example": "curbside",
                  "enum": [
                    "curbside",
                    "dropBox",
                    "inStore",
                    "other"
                  ]
                },
                {
                  "name": "pickupLocationDescription",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Freeform description of pickup location.</p>",
                  "example": "At main entrance"
                },
                {
                  "name": "pickupPersonFirstNamePrimary",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Primary pickup person’s first name.</p>",
                  "example": "Betty"
                },
                {
                  "name": "pickupPersonLastNamePrimary",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Primary pickup person’s last name.</p>",
                  "example": "Smith"
                },
                {
                  "name": "pickupPersonFirstNameAlternate",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Alternate pickup person’s first name.</p>",
                  "example": "Mary"
                },
                {
                  "name": "pickupPersonLastNameAlternate",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Alternate pickup person’s last name.</p>",
                  "example": "Jones"
                },
                {
                  "name": "pickupVerificationMethod",
                  "kind": "optional",
                  "type": "string<idCard | signature | other>",
                  "description": "<p>[OPTIONAL] Method used to verify pickup identity.</p>",
                  "example": "idCard",
                  "enum": [
                    "idCard",
                    "signature",
                    "other"
                  ]
                },
                {
                  "name": "pickupDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] When the item was picked up (send as update post‑pickup).</p>",
                  "example": "2022-03-11T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "pickupVerificationSignatureImage",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Base64 signature image captured on pickup.</p>",
                  "example": "*** Base 64 encoding ***"
                },
                {
                  "name": "pickupVerificationIDCardImage",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Base64 ID card image captured on pickup.</p>",
                  "example": "***Base 64 encoding ***"
                }
              ]
            },
            {
              "name": "addresses",
              "kind": "optional",
              "type": "array",
              "description": "<p>[OPTIONAL]</p>",
              "example": "[{\"addressID\":\"23l4jk23klj23\",\"addressType\":\"shipping\",\"primaryFlag\":\"true\",\"isAddressOnFile\":\"false\",\"firstName\":\"Jane\",\"middleName\":\"Marie\",\"lastName\":\"Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"phone\":\"3125555555\",\"phoneCountryCode\":\"001\",\"address1\":\"1863 Main Street\",\"address2\":\"Apt 7\",\"city\":\"Anaheim\",\"region\":\"CA\",\"postCode\":\"92802\",\"country\":\"US\",\"companyName\":\"Accertify, Inc\",\"locationType\":\"business\",\"addressCreatedDateTime\":\"2020-03-28T17:07:24-07:00\",\"addressUpdatedDateTime\":\"2021-03-28T17:07:24-07:00\"},{\"addressID\":\"23l4jk23klj23\",\"addressType\":\"billing\",\"primaryFlag\":\"true\",\"isAddressOnFile\":\"false\",\"firstName\":\"Jane\",\"middleName\":\"Marie\",\"lastName\":\"Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"phone\":\"3125555555\",\"phoneCountryCode\":\"001\",\"address1\":\"1776 W. Washington Street\",\"city\":\"Anaheim\",\"region\":\"CA\",\"postCode\":\"92802\",\"country\":\"US\",\"companyName\":\"Cool Stuff!\",\"locationType\":\"residence\",\"addressCreatedDateTime\":\"2020-03-28T17:07:24-07:00\",\"addressUpdatedDateTime\":\"2021-03-28T17:07:24-07:00\"}]",
              "itemType": "object",
              "customType": "object[]",
              "schema": [
                {
                  "name": "addressID",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Merchant-defined identifier to distinguish multiple addresses in one order.</p>",
                  "example": "23l4jk23klj23"
                },
                {
                  "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, etc.).</p>",
                  "example": "shipping",
                  "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>",
                  "example": "true",
                  "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": "false",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "firstName",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Address owner’s first name.</p>",
                  "example": "Jane"
                },
                {
                  "name": "middleName",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Address owner’s middle name.</p>",
                  "example": "Marie"
                },
                {
                  "name": "lastName",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Address owner’s last name.</p>",
                  "example": "Doe"
                },
                {
                  "name": "emailAddress",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Email associated with this address/contact.</p>",
                  "example": "jane.doe123@gmail.com"
                },
                {
                  "name": "phone",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Phone number (no country prefix here).</p>",
                  "example": "3125555555"
                },
                {
                  "name": "phoneCountryCode",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Country calling code for phone (omit \"+\").</p>",
                  "example": "001"
                },
                {
                  "name": "address1",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Address line 1.</p>",
                  "example": "1863 Main Street"
                },
                {
                  "name": "address2",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Address line 2.</p>",
                  "example": "Apt 7"
                },
                {
                  "name": "city",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] City / locality.</p>",
                  "example": "Anaheim"
                },
                {
                  "name": "region",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] ISO 3166-2 state/province/region (US/CA require state/province).</p>",
                  "example": "CA"
                },
                {
                  "name": "postCode",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Postal code (US ZIP+4 requires hyphen).</p>",
                  "example": "92802"
                },
                {
                  "name": "country",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Two‑letter ISO 3166‑1 country code.</p>",
                  "example": "US"
                },
                {
                  "name": "companyName",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Company associated with the address, if any.</p>",
                  "example": "Accertify, Inc"
                },
                {
                  "name": "locationType",
                  "kind": "optional",
                  "type": "string<business | redirect | residence | siteToStore | other>",
                  "description": "<p>[OPTIONAL] Residence or business type; other site‑to‑store options.</p>",
                  "example": "business",
                  "enum": [
                    "business",
                    "redirect",
                    "residence",
                    "siteToStore",
                    "other"
                  ]
                },
                {
                  "name": "addressCreatedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] When address was created.</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.</p>",
                  "example": "2021-03-28T17:07:24-07:00",
                  "format": "date-time"
                }
              ]
            },
            {
              "name": "paymentMethods",
              "kind": "optional",
              "type": "array",
              "description": "<p>[OPTIONAL]</p>",
              "example": "[{\"paymentType\":\"creditCard\",\"paymentMethodID\":\"2ljr9vxsdfew\",\"paymentMethodAmount\":399,\"isPaymentStoredOnFile\":\"true\",\"cardNumber\":\"\",\"cardToken\":\"6f7%gf38hfUa\",\"expirationMonth\":\"11\",\"expirationYear\":\"2020\",\"nameOnCreditCard\":\"Jane Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"cardBin\":345678,\"cardLastFour\":\"1111\",\"avsResult\":\"matched\",\"cvvResult\":\"matched\",\"cardAuthorizationCode\":\"12345\",\"cardAuthorizationDateTime\":\"2020-11-22T17:07:24-07:00\",\"isPre-AuthorizationReject\":\"false\",\"post-AuthorizationRejectReason\":\"creditReject\",\"eciIndicator\":\"unsuccessfulOrNotAttempted\",\"totalFailedAttempts\":88,\"paymentMethodCreatedDateTime\":\"2020-03-28T17:07:24-07:00\",\"paymentMethodUpdatedDateTime\":\"2020-03-28T17:07:24-07:00\"},{\"paymentType\":\"digitalWallet\",\"paymentMethodID\":\"2ljr9vxsdfey\",\"paymentMethodAmount\":150,\"isPaymentStoredOnFile\":\"true\",\"nameOnAccount\":\"Jane Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"walletType\":\"Applepay\",\"walletStatus\":\"active\",\"isWalletProtectionEligible\":\"true\",\"paymentMethodBalanceAmount\":4000,\"totalFailedAttempts\":88},{\"paymentType\":\"giftCard\",\"paymentMethodID\":\"2ljr9vxsdfex\",\"paymentMethodAmount\":350,\"nameOnAccount\":\"Jane Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"giftCardNumber\":\"a789sdf8asdfasd89f789asd78\",\"giftCardLastFour\":\"1111\",\"giftCardBIN\":\"4111\",\"expirationMonth\":\"11\",\"expirationYear\":\"2026\",\"paymentMethodBalanceAmount\":4000},{\"paymentType\":\"voucher\",\"paymentMethodID\":\"2ljr9vxsdfez\",\"paymentMethodAmount\":500,\"nameOnAccount\":\"Jane Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"expirationDay\":\"12\",\"expirationMonth\":\"11\",\"expirationYear\":\"2026\",\"paymentMethodBalanceAmount\":4000},{\"paymentType\":\"loyaltyPoints\",\"paymentMethodID\":\"2ljr9vxsdfeu\",\"paymentMethodAmount\":500,\"nameOnAccount\":\"Jane Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"points\":50000,\"expirationDay\":\"12\",\"expirationMonth\":\"11\",\"expirationYear\":\"2026\",\"loyaltyProgramName\":\"Acme Platinum\",\"paymentMethodBalanceAmount\":4000},{\"paymentType\":\"bankAccount\",\"paymentMethodID\":\"18881118929\",\"paymentMethodAmount\":500,\"isPaymentStoredOnFile\":\"true\",\"nameOnAccount\":\"Jane Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"accountType\":\"checking\"}]",
              "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] Tender type (ACH in bankAccount; EFT in electronicFundTransfer).</p>",
                  "example": "creditCard",
                  "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 PAN).</p>",
                  "example": "2ljr9vxsdfew"
                },
                {
                  "name": "paymentMethodAmount",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Amount applied to this method (transaction currency).</p>",
                  "example": 399
                },
                {
                  "name": "isPaymentStoredOnFile",
                  "kind": "optional",
                  "type": "string<true | false>",
                  "description": "<p>[OPTIONAL] Indicates if method was stored on file.</p>",
                  "example": "true",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "emailAddress",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Email associated with the payment.</p>",
                  "example": "jane.doe123@gmail.com"
                },
                {
                  "name": "nameOnAccount",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Name on the account/wallet/loyalty program.</p>",
                  "example": "Jane Doe"
                },
                {
                  "name": "accountType",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Account type when paymentType=bankAccount (checking/saving/moneyMarket/other).</p>"
                },
                {
                  "name": "cardNumber",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Primary account number for creditCard. Must pass Luhn if sent.</p>",
                  "example": ""
                },
                {
                  "name": "cardToken",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Tokenized card number for creditCard.</p>",
                  "example": "6f7%gf38hfUa"
                },
                {
                  "name": "expirationMonth",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Expiry month (MM) for cards/vouchers/points where applicable.</p>",
                  "example": "11"
                },
                {
                  "name": "expirationYear",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Expiry year (YYYY) for cards/vouchers/points where applicable.</p>",
                  "example": "2020"
                },
                {
                  "name": "expirationDay",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Expiry day (DD) for vouchers/points when used.</p>",
                  "example": 12
                },
                {
                  "name": "nameOnCreditCard",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Cardholder name (creditCard/giftCard).</p>",
                  "example": "Jane Doe"
                },
                {
                  "name": "cardBin",
                  "kind": "optional",
                  "type": "integer",
                  "description": "<p>[OPTIONAL] Leading 6–11 digits of the credit card number (numeric only).</p>",
                  "example": 345678
                },
                {
                  "name": "cardLastFour",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Last four digits (numeric only).</p>",
                  "example": "1111"
                },
                {
                  "name": "avsResult",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Issuer AVS result (matched/partialMatch/notMatched/notChecked/systemError/other).</p>",
                  "example": "matched"
                },
                {
                  "name": "cvvResult",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Issuer CVV result (matched/notMatched).</p>",
                  "example": "matched"
                },
                {
                  "name": "cardAuthorizationCode",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Payment card authorization code when available.</p>",
                  "example": "12345"
                },
                {
                  "name": "cardAuthorizationDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] Authorization date/time.</p>",
                  "example": "2020-11-22T17: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>",
                  "example": "false",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                {
                  "name": "post-AuthorizationRejectReason",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Reason for post‑authorization reject (creditReject/fraudReject/otherReject).</p>",
                  "example": "creditReject"
                },
                {
                  "name": "eciIndicator",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] ECI status from card brand (successful/unsuccessfulOrNotAttempted/attemptedButNotCompleted/other).</p>",
                  "example": "unsuccessfulOrNotAttempted"
                },
                {
                  "name": "totalFailedAttempts",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Number of failed attempts on this method.</p>",
                  "example": 88
                },
                {
                  "name": "paymentMethodCreatedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] When the payment method was created.</p>",
                  "example": "2020-03-28T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "paymentMethodUpdatedDateTime",
                  "kind": "optional",
                  "type": "string<date-time>",
                  "description": "<p>[OPTIONAL] When the payment method was last updated.</p>",
                  "example": "2020-03-28T17:07:24-07:00",
                  "format": "date-time"
                },
                {
                  "name": "giftCardNumber",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Gift card number (must be hashed per Accertify algorithm).</p>",
                  "example": "a789sdf8asdfasd89f789asd78"
                },
                {
                  "name": "giftCardLastFour",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Last four digits of gift card.</p>",
                  "example": 1111
                },
                {
                  "name": "giftCardBIN",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Gift card BIN.</p>",
                  "example": 4111
                },
                {
                  "name": "paymentMethodBalanceAmount",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Balance amount remaining at time of request.</p>",
                  "example": 4000
                },
                {
                  "name": "points",
                  "kind": "optional",
                  "type": "integer",
                  "description": "<p>[OPTIONAL] Number of loyalty points/miles redeemed.</p>",
                  "example": 50000
                },
                {
                  "name": "loyaltyProgramName",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Name of the loyalty program used for redemption.</p>",
                  "example": "Acme Platinum"
                },
                {
                  "name": "walletType",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Wallet provider (e.g., Apple Pay, Google Pay, PayPal).</p>",
                  "example": "Venmo, Google Pay, PayPal"
                },
                {
                  "name": "walletStatus",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Wallet account status (active/pending/inactive).</p>"
                },
                {
                  "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": "[{\"promoCode\":\"ABC12\",\"promoAmount\":5555,\"promoType\":\"employeeDiscount\"},{\"promoCode\":\"ABC1234\",\"promoAmount\":50,\"promoType\":\"freeShipping\"}]",
              "itemType": "object",
              "customType": "object[]",
              "schema": [
                {
                  "name": "promoCode",
                  "kind": "optional",
                  "type": "string",
                  "description": "<p>[OPTIONAL] Promotion or discount code at order level.</p>",
                  "example": "ABC12"
                },
                {
                  "name": "promoAmount",
                  "kind": "optional",
                  "type": "number",
                  "description": "<p>[OPTIONAL] Discount amount (transaction currency).</p>",
                  "example": 5555
                },
                {
                  "name": "promoType",
                  "kind": "optional",
                  "type": "string<bogo | bundle | employeeDiscount | freeShipping | loyaltyDiscount | newMemberDiscount | percentage | quantityPromotion | other>",
                  "description": "<p>[OPTIONAL] Order‑level promotion type.</p>",
                  "example": "employeeDiscount",
                  "enum": [
                    "bogo",
                    "bundle",
                    "employeeDiscount",
                    "freeShipping",
                    "loyaltyDiscount",
                    "newMemberDiscount",
                    "percentage",
                    "quantityPromotion",
                    "other"
                  ]
                }
              ]
            }
          ],
          "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": "<p>Unexpected error. This could be an authentication error, invalid JSON payload, bad credentials, or another system error.</p>",
        "jsonExample": "",
        "isExpanded": true
      }
    ],
    "examples": {
      "languages": [
        {
          "id": "example-0-curl",
          "language": "curl",
          "label": "cURL",
          "code": "curl --request POST \\\n     --url https://api.accertify.net//rtd01.eu.accertify.net/icNowImport/{importerID} \\\n     --header 'accept: application/json' \\\n     --header 'content-type: application/json' \\\n     --data '{\n     \"transactionID\": \"ABC123456\",\n     \"transactionType\": \"postAuthorization\",\n     \"transactionDateTime\": \"2022-03-11T17:07:24-07:00\",\n     \"paymentAmount\": 1082.91,\n     \"currencyCode\": \"USD\",\n     \"success\": \"false\",\n     \"purchaseType\": \"physicalItems\",\n     \"eventSource\": \"web\",\n     \"paymentMethods\": [\n     {\n     \"paymentType\": \"creditCard\"\n     }\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\": \"postAuthorization\",\n   \"transactionDateTime\": \"2022-03-11T17:07:24-07:00\",\n   \"paymentAmount\": 1082.91,\n   \"currencyCode\": \"USD\",\n   \"success\": \"false\",\n   \"purchaseType\": \"physicalItems\",\n   \"eventSource\": \"web\",\n   \"paymentMethods\": [\n      {\n         \"paymentType\": \"creditCard\"\n      }\n   ]\n});\n\nvar requestOptions = {\n   method: 'POST',\n   headers: myHeaders,\n   body: raw,\n   redirect: 'follow'\n};\n\nfetch(\"https://api.accertify.net//rtd01.eu.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://api.accertify.net//rtd01.eu.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\": \"postAuthorization\",\n   \"transactionDateTime\": \"2022-03-11T17:07:24-07:00\",\n   \"paymentAmount\": 1082.91,\n   \"currencyCode\": \"USD\",\n   \"success\": \"false\",\n   \"purchaseType\": \"physicalItems\",\n   \"eventSource\": \"web\",\n   \"paymentMethods\": [\n      {\n         \"paymentType\": \"creditCard\"\n      }\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://api.accertify.net//rtd01.eu.accertify.net/icNowImport/{importerID}\"\n\npayload = json.dumps({\n   \"transactionID\": \"ABC123456\",\n   \"transactionType\": \"postAuthorization\",\n   \"transactionDateTime\": \"2022-03-11T17:07:24-07:00\",\n   \"paymentAmount\": 1082.91,\n   \"currencyCode\": \"USD\",\n   \"success\": \"false\",\n   \"purchaseType\": \"physicalItems\",\n   \"eventSource\": \"web\",\n   \"paymentMethods\": [\n      {\n         \"paymentType\": \"creditCard\"\n      }\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": "// Unexpected error. This could be an authentication error, invalid JSON payload, bad credentials, or another system error.\n"
        }
      ],
      "selectedLanguageId": "response-0-200"
    }
  },
  "children": [
    {
      "text": ""
    }
  ]
}