Amusement Park post-authorization risk score

1 min

POST

https://api.accertify.net/api/v1/unified-risk/postAuthAmusement

Submits an amusement park purchase event after payment authorization, including the authorization outcome and SCA/3DS results. Returns a risk assessment enriched with device and connection intelligence.

Body Parameters

postAuthobjectrequired
Example
```
{
  "transactionID": "ABC123456",
  "transactionDateTime": "2022-03-11T17:07:24-07:00",
  "eventSource": "web",
  "accountID": "12363454566",
  "isGuestCheckout": false,
  "isAgenticCheckout": false,
  "paymentAmount": 1082.91,
  "taxAmount": 1.23,
  "deliveryAmount": 5.99,
  "currencyCode": "USD",
  "success": true,
  "ipAddress": "10.12.12.123",
  "emailAddress": "[email protected]",
  "authenticationMethod": "magicLink",
  "failureCode": "authFailed",
  "brand": "acme",
  "phoneNumber": "3125555555",
  "latitude": 33.836,
  "longitude": -117.914,
  "accountStatus": "dormant",
  "firstName": "Jane",
  "middleName": "Marie",
  "lastName": "Doe",
  "purchaseType": "physicalItems",
  "listingID": "abcd1234",
  "isPaymentOptimization": false,
  "is3DS": false,
  "ticketPackageID": "3jlsdfs9732",
  "ticketPackageClass": "gold",
  "ticketPackageDescription": "gold family package",
  "ticketDeliveryType": "mobileApp",
  "account": {
    "isEnrolledInLoyaltyProgram": true,
    "loyaltyNumber": "Id1234",
    "accountLocale": "en-US",
    "accountLevel": "Gold",
    "accountType": "family",
    "accountRegistrationDateTime": "2020-11-22T17:07:24-07:00",
    "accountEmailUpdatedDateTime": "2020-08-28T19:00:00-04:00",
    "accountPasswordUpdatedDateTime": "2021-08-28T19:00:00-04:00",
    "dateOfBirth": "1985-11-15",
    "loyaltyProgramName": "Members Plus",
    "loyaltyPointsBalance": 987654321
  },
  "payment": {
    "salesRepID": "SR#46k90",
    "referralCode": "API 210315",
    "isGift": true,
    "orderMessage": "Enjoy the gift",
    "isPaymentInInstallments": false,
    "installmentAmount": 99.99,
    "installmentCurrencyCode": "USD",
    "installmentCount": 12,
    "isPaymentRecurring": false
  },
  "addresses": [
    {
      "addressType": "shipping",
      "addressID": "23l4jk23klj23",
      "primaryFlag": true,
      "isAddressOnFile": false,
      "firstName": "Jane",
      "middleName": "Marie",
      "lastName": "Doe",
      "emailAddress": "[email protected]",
      "phone": "3125555555",
      "phoneCountryCode": "001",
      "address1": "1863 Main Street",
      "address2": "Apt 7",
      "city": "Anaheim",
      "region": "CA",
      "postCode": "92802",
      "country": "US",
      "companyName": "Accertify, Inc",
      "addressCreatedDateTime": "2020-03-28T17:07:24-07:00",
      "addressUpdatedDateTime": "2021-03-28T17:07:24-07:00"
    },
    {
      "addressID": "3243324232",
      "addressType": "venue",
      "firstName": "Jane",
      "lastName": "Doe",
      "phone": "3125555555",
      "phoneCountryCode": "001",
      "address1": "1313 Disneyland Drive",
      "city": "Anaheim",
      "region": "CA",
      "postCode": "92802",
      "country": "US"
    }
  ],
  "paymentMethods": [
    {
      "paymentType": "creditCard",
      "paymentMethodID": "2ljr9vxsdfew",
      "paymentMethodAmount": 399,
      "isPaymentStoredOnFile": true,
      "cardNumber": "4111111111111111",
      "cardToken": "6f7%gf38hfUa",
      "expirationMonth": "11",
      "expirationYear": "2027",
      "nameOnCreditCard": "Jane Doe",
      "cardBin": "345678",
      "cardLastFour": "1111",
      "totalFailedAttempts": 3,
      "paymentMethodCreatedDateTime": "2020-03-28T17:07:24-07:00",
      "paymentMethodUpdatedDateTime": "2020-03-28T17:07:24-07:00",
      "addressID": "23kl4l32l",
      "avsResult": "matched",
      "cvvResult": "matched",
      "cardAuthorizationCode": "12345",
      "cardAuthorizationDateTime": "2022-03-11T17:07:24-07:00",
      "isPreAuthorizationReject": false,
      "sca3DSFlow": "frictionless",
      "sca3DSVersion": "2.2.0",
      "sca3DSChallengeRequestType": "02",
      "sca3DSTransactionStatus": "Y",
      "scaAuthorizationStatus": "approve",
      "eciIndicator": "successful",
      "isSCASoftDecline": false
    }
  ],
  "promotions": [
    {
      "promoCode": "ABC12",
      "promoAmount": 50,
      "promoType": "employeeDiscount"
    }
  ],
  "items": [
    {
      "itemType": "ticket",
      "brandName": "Apple",
      "description": "Macbook Pro",
      "category": "Computers",
      "itemID": "af877wernnasnfes",
      "isHighRiskItem": true,
      "price": 1199.99,
      "faceValueAmount": 1599.99,
      "quantity": 2,
      "addressID": "2lkj34jldsoufsous82df",
      "productCondition": "new",
      "shippingMethod": "storePickup",
      "promoCode": "ABC12",
      "promoAmount": 50,
      "promoType": "employeeDiscount",
      "pickupLocation": "curbside",
      "pickupDateTime": "2022-03-11T17:07:24-07:00",
      "pickupPersonFirstName": "Betty",
      "pickupPersonLastName": "Smith"
    }
  ],
  "ticketDetails": [
    {
      "guestFirstName": "John",
      "guestMiddleName": "Edward",
      "guestLastName": "Smith",
      "guestAdultOrChild": "adult",
      "ticketPLU": "234jl234jl324jl23kl23",
      "ticketPrice": 99.92,
      "ticketCurrencyCode": "USD",
      "ticketStartDateTime": "2020-02-22T17:07:24-07:00",
      "ticketExpirationDateTime": "2020-02-22T17:07:24-07:00",
      "ticketClass": "premium",
      "ticketParkID": "3432432432",
      "isAnnualPass": true,
      "isRenewal": true,
      "annualPassName": "Gold Pass",
      "annualPassAltName": "Legacy Loyal Pass"
    }
  ],
  "event": {
    "eventID": "234kl5jkl523jkl423jkl",
    "eventType": "concert",
    "eventName": "Fleetwood Mac",
    "eventDateTime": "2022-03-11T17:07:24-07:00",
    "eventOnSaleDateTime": "2022-03-11T17:07:24-07:00",
    "eventGenre": "country",
    "venueID": "223jklk234j3l4",
    "venueAddressID": "3243324232",
    "eventCreatedDateTime": "2022-03-11T17:07:24-07:00",
    "eventLastUpdatedDateTime": "2022-03-11T17:07:24-07:00",
    "tickets": {
      "sectionNumber": "401",
      "sectionName": "home",
      "row": "24",
      "rowName": "upper",
      "numberOfTickets": 2,
      "startSeat": "2",
      "endSeat": "3"
    }
  },
  "agencyInformation": {
    "agencyDetails": [
      {
        "agencyCode": "01234ABC",
        "agencyName": "Acme Travel inc",
        "agencySalesRepresentativeID": "232324521",
        "agencyConfirmationNumber": "ABC123",
        "agencyCountryCode": "AU",
        "agencyEmail": "[email protected]",
        "agencyHeadOffice": "Melbourne",
        "agencyPhone": "19876543211"
      }
    ]
  },
  "insuranceInformation": {
    "insuranceDetails": [
      {
        "insuranceType": "travel",
        "insuranceCity": "Sydney",
        "insuranceCountryCode": "AU",
        "insuranceStartDateTime": "2022-03-11T17:07:24-07:00",
        "insuranceEndDateTime": "2022-03-11T17:07:24-07:00",
        "insuranceName": "Acme Insurance Full Cover",
        "insuranceReservationName": "Jane Doe",
        "insuranceTotalAmount": 399.04,
        "insuranceCurrencyCode": "AUD"
      }
    ]
  }
}
```
Description
Top-level scalar fields shared by the Universal Fraud API preAuth and postAuth endpoints. Amusement-specific top-level ticket package fields for the Universal Fraud API preAuth and postAuth endpoints.
- transactionIDstringrequired
  Example
  ABC123456
  Description
  [Required] Unique transaction identifier (max 40 chars).
  Max Length
  40
- transactionDateTimestring<date-time>required
  Example
  2022-03-11T17:07:24-07:00
  Description
  [Required] ISO 8601 timestamp of when the transaction occurred.
  Format
  date-time
- eventSourcestring<agentPhone | agentStore | affiliate | kiosk | mobileApp | other | web>required
  Example
  web
  Description
  [Required] Originating channel; one of: agentPhone, agentStore, affiliate, kiosk, mobileApp, other, web.
  Allowed
  agentPhoneagentStoreaffiliatekioskmobileAppotherweb
- accountIDstring
  Example
  12363454566
  Description
  [Conditional] Merchant internal account identifier; required when isGuestCheckout is "false".
- isGuestCheckoutbooleanrequired
  Description
  [Required] Whether the customer checked out without an account ("true"/"false").
- isAgenticCheckoutboolean
  Description
  [Optional] String "true"/"false" also accepted.
- paymentAmountnumberrequired
  Example
  1082.91
  Description
  [Required] Total payment amount including tax and delivery; zero or positive, up to 2 decimal places.
  Minimum
  0
- taxAmountnumberrequired
  Example
  1.23
  Description
  [Required] Tax portion of the payment amount; zero or positive, up to 2 decimal places.
  Minimum
  0
- deliveryAmountnumberrequired
  Example
  5.99
  Description
  [Required] Delivery/shipping cost; zero or positive, up to 2 decimal places.
  Minimum
  0
- currencyCodestringrequired
  Example
  USD
  Description
  [Required] ISO 4217 three-letter currency code for the transaction.
- successbooleanrequired
  Example
  true
  Description
  [Required] Outcome of the transaction attempt ("true"/"false").
- ipAddressstring
  Example
  10.12.12.123
  Description
  [Conditional] Client IP address; required when eventSource is mobileApp or web.
- userAgentstring
  Example
  Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:72.0) Gecko/20100101 Firefox/72.0
  Description
  [Conditional] Browser User-Agent string (max 250 chars); required when eventSource is web.
  Max Length
  250
- deviceTransactionIDstring
  Example
  e1a1aade06e2557f34036eeb06173faf1fa05c64959383
  Description
  [Optional] Session token generated by the device data collection script.
- devicePayloadstring
  Example
  afklasdjlasdjl3l23j23423klj
  Description
  [Optional] Raw payload from the device fingerprinting library.
- ubaIDstring
  Example
  3143e969395de649c48c1c9f3e363a3e7ae7
  Description
  [Optional] UBA behavioral analytics session ID (max 100 chars).
  Max Length
  100
- ubaEventsstring
  Example
  lasjdlkfdsljelkrrjwl3kl324j32k432
  Description
  [Optional] Serialized stream of UBA behavioral events captured during the session.
- emailAddressstringrequired
  Example
  [email protected]
  Description
  [Required] Customer email address; must be a valid email format.
- authenticationMethodstring<appAuthenticator | appPush | other | password | passkey | magicLink | SMS>
  Example
  magicLink
  Description
  [Optional] Method used to authenticate the customer; one of: appAuthenticator, appPush, magicLink, other, passkey, password, SMS.
  Allowed
  appAuthenticatorappPushotherpasswordpasskeymagicLinkSMS
- failureCodestring<authFailed | exportCompliance | other>
  Example
  authFailed
  Description
  [Conditional] Reason the transaction was unsuccessful; one of: authFailed, exportCompliance, other. Required when success is "false".
  Allowed
  authFailedexportComplianceother
- brandstring
  Example
  acme
  Description
  [Optional] Merchant sub-brand for multi-brand deployments (max 50 chars).
  Max Length
  50
- phoneNumberstring
  Example
  3125555555
  Description
  [Optional] Customer billing phone number (max 25 chars).
  Max Length
  25
- latitudenumber
  Example
  33.836
  Description
  [Optional] Geographic latitude of the transaction origin.
- longitudenumber
  Example
  -117.914
  Description
  [Optional] Geographic longitude of the transaction origin.
- accountStatusstring<active | dormant | suspended | terminated | trial | other>
  Example
  dormant
  Description
  [Optional] Current lifecycle status of the account; one of: active, dormant, suspended, terminated, trial, other.
  Allowed
  activedormantsuspendedterminatedtrialother
- firstNamestring
  Example
  Jane
  Description
  [Optional] Customer billing first name.
- middleNamestring
  Example
  Marie
  Description
  [Optional] Customer billing middle name.
- lastNamestring
  Example
  Doe
  Description
  [Optional] Customer billing last name.
- purchaseTypestring<physicalItems | digitalItems | services | other>required
  Example
  physicalItems
  Description
  [Required] Nature of the items in this order; one of: physicalItems, digitalItems, services, other.
  Allowed
  physicalItemsdigitalItemsservicesother
- listingIDstring
  Example
  abcd1234
  Description
  [Optional] Marketplace listing identifier (max 50 chars).
  Max Length
  50
- isPaymentOptimizationboolean
  Description
  [Optional] Whether payment optimization is enabled ("true"/"false").
- is3DSboolean
  Description
  [Optional] Whether 3D Secure authentication was applied ("true"/"false").
- ticketPackageIDstring
  Example
  3jlsdfs9732
  Description
  [Optional] Ticket package identifier.
- ticketPackageClassstring
  Example
  gold
  Description
  [Optional] Ticket package class.
- ticketPackageDescriptionstring
  Example
  gold family package
  Description
  [Optional] Ticket package description.
- ticketDeliveryTypestring<email | mobileApp | pickup>
  Example
  mobileApp
  Description
  [Optional] How the ticket is delivered.
  Allowed
  emailmobileApppickup
- accountobject
  Example
```
{
  "isEnrolledInLoyaltyProgram": true,
  "loyaltyNumber": "Id1234",
  "accountLocale": "en-US",
  "accountLevel": "Gold",
  "accountType": "family",
  "accountRegistrationDateTime": "2020-11-22T17:07:24-07:00",
  "accountEmailUpdatedDateTime": "2020-08-28T19:00:00-04:00",
  "accountPasswordUpdatedDateTime": "2021-08-28T19:00:00-04:00",
  "dateOfBirth": "1985-11-15",
  "loyaltyProgramName": "Members Plus",
  "loyaltyPointsBalance": 987654321
}
```
  Description
  Nested object containing account-level details for the transacting customer.
  - isEnrolledInLoyaltyProgramboolean
    Example
    true
    Description
    [Optional] Whether the account holds a loyalty membership ("true"/"false").
  - loyaltyNumberstring
    Example
    Id1234
    Description
    [Optional] Customer's loyalty program membership number.
  - accountLocalestring
    Example
    en-US
    Description
    [Optional] Account locale/language preference (e.g., "en-US").
  - accountLevelstring
    Example
    Gold
    Description
    [Optional] Customer tier within the loyalty or membership program (e.g., "Gold").
  - accountTypestring<individual | business | family | other>
    Example
    family
    Description
    [Optional] Account category; one of: individual, business, family, other.
    Allowed
    individualbusinessfamilyother
  - accountRegistrationDateTimestring<date-time>
    Example
    2020-11-22T17:07:24-07:00
    Description
    [Optional] ISO 8601 timestamp of when the account was created.
    Format
    date-time
  - accountEmailUpdatedDateTimestring<date-time>
    Example
    2020-08-28T19:00:00-04:00
    Description
    [Optional] ISO 8601 timestamp of the last email address change on the account.
    Format
    date-time
  - accountPasswordUpdatedDateTimestring<date-time>
    Example
    2021-08-28T19:00:00-04:00
    Description
    [Optional] ISO 8601 timestamp of the last password change on the account.
    Format
    date-time
  - dateOfBirthstring<date>
    Example
    1985-11-15
    Description
    [Optional] Customer's date of birth in ISO 8601 date format (YYYY-MM-DD).
    Format
    date
  - loyaltyProgramNamestring
    Example
    Members Plus
    Description
    [Optional] Name of the loyalty program the account belongs to (max 100 chars).
    Max Length
    100
  - loyaltyPointsBalanceinteger
    Example
    987654321
    Description
    [Optional] Current point balance in the loyalty program; zero or positive.
    Minimum
    0
- paymentobject
  Example
```
{
  "salesRepID": "SR#46k90",
  "referralCode": "API 210315",
  "isGift": true,
  "orderMessage": "Enjoy the gift",
  "isPaymentInInstallments": false,
  "installmentAmount": 99.99,
  "installmentCurrencyCode": "USD",
  "installmentCount": 12,
  "isPaymentRecurring": false
}
```
  Description
  Nested object containing additional payment-level details for the order.
  - salesRepIDstring
    Example
    SR#46k90
    Description
    [Optional] Identifier of the sales representative who assisted with the order (max 20 chars).
    Max Length
    20
  - referralCodestring
    Example
    API 210315
    Description
    [Optional] Promotional or affiliate referral code applied at checkout (max 50 chars).
    Max Length
    50
  - isGiftboolean
    Example
    true
    Description
    [Optional] Indicates the order is being sent as a gift ("true"/"false").
  - isPaymentInInstallmentsboolean
    Description
    [Optional] Whether the total will be paid in multiple installments ("true"/"false").
  - installmentAmountnumber
    Example
    99.99
    Description
    [Optional] Amount of each individual installment payment; positive number.
    Minimum (exclusive)
    0
  - installmentCurrencyCodestring
    Example
    USD
    Description
    [Conditional] ISO 4217 currency code for installment amounts; required when isPaymentInInstallments is "true".
  - installmentCountinteger
    Example
    12
    Description
    [Conditional] Total number of installment payments; required when isPaymentInInstallments is "true".
    Minimum (exclusive)
    0
  - isPaymentRecurringboolean
    Description
    [Optional] Whether this is a recurring/subscription payment ("true"/"false").
  - orderMessagestring
    Example
    Enjoy the gift
    Description
    [Optional] Personal message or order instruction associated with the transaction.
- addressesobject[]
  Example
```
[
  {
    "addressType": "shipping",
    "addressID": "23l4jk23klj23",
    "primaryFlag": true,
    "isAddressOnFile": false,
    "firstName": "Jane",
    "middleName": "Marie",
    "lastName": "Doe",
    "emailAddress": "[email protected]",
    "phone": "3125555555",
    "phoneCountryCode": "001",
    "address1": "1863 Main Street",
    "address2": "Apt 7",
    "city": "Anaheim",
    "region": "CA",
    "postCode": "92802",
    "country": "US",
    "companyName": "Accertify, Inc",
    "addressCreatedDateTime": "2020-03-28T17:07:24-07:00",
    "addressUpdatedDateTime": "2021-03-28T17:07:24-07:00"
  },
  {
    "addressID": "3243324232",
    "addressType": "venue",
    "firstName": "Jane",
    "lastName": "Doe",
    "phone": "3125555555",
    "phoneCountryCode": "001",
    "address1": "1313 Disneyland Drive",
    "city": "Anaheim",
    "region": "CA",
    "postCode": "92802",
    "country": "US"
  }
]
```
  - addressIDstringrequired
    Example
    23l4jk23klj23
    Description
    [Required] Merchant-assigned identifier for this address record.
  - addressTypestring<account | billing | bopis | curbside | departure | destination | fulfillment | listing | lodging | pickup | return | shipping | venue | other>required
    Example
    shipping
    Description
    [Required] Role of this address in the order.
    Allowed
    accountbillingbopiscurbsidedeparturedestinationfulfillmentlistinglodgingpickupreturnshippingvenueother
  - primaryFlagboolean
    Example
    true
    Description
    [Optional] Marks this as the account's primary address (true/false).
  - isAddressOnFileboolean
    Description
    [Optional] Whether this address was previously saved to the account ("true"/"false").
  - firstNamestringrequired
    Example
    Jane
    Description
    [Required] Recipient's first name at this address.
  - middleNamestring
    Example
    Marie
    Description
    [Optional] Recipient's middle name at this address.
  - lastNamestringrequired
    Example
    Doe
    Description
    [Required] Recipient's last name at this address.
  - emailAddressstring
    Example
    [email protected]
    Description
    [Conditional] Recipient's email address; required when addressType is account or billing.
  - phonestringrequired
    Example
    3125555555
    Description
    [Required] Recipient's phone number.
  - phoneCountryCodestringrequired
    Example
    001
    Description
    [Required] International dial prefix for the phone number (for example, "001").
  - address1stringrequired
    Example
    1863 Main Street
    Description
    [Required] Primary street address line.
  - address2string
    Example
    Apt 7
    Description
    [Optional] Secondary address line (suite, apartment, etc.).
  - citystringrequired
    Example
    Anaheim
    Description
    [Required] City component of the address.
  - regionstringrequired
    Example
    CA
    Description
    [Required] State or region component of the address.
  - postCodestringrequired
    Example
    92802
    Description
    [Required] Postal or ZIP code.
  - countrystringrequired
    Example
    US
    Description
    [Required] ISO 3166-1 alpha-2 country code.
  - companyNamestring
    Example
    Accertify, Inc
    Description
    [Optional] Business name at this address.
  - addressCreatedDateTimestring<date-time>
    Example
    2020-03-28T17:07:24-07:00
    Description
    [Optional] ISO 8601 timestamp of when this address was saved.
    Format
    date-time
  - addressUpdatedDateTimestring<date-time>
    Example
    2021-03-28T17:07:24-07:00
    Description
    [Optional] ISO 8601 timestamp of the last modification to this address.
    Format
    date-time
- shippingAddressesobject[]
  - addressIDstringrequired
    Example
    23l4jk23klj23
    Description
    [Required] Merchant-assigned identifier for this address record.
  - primaryFlagboolean
    Example
    true
    Description
    [Optional] Marks this as the account's primary address ("true"/"false").
  - isAddressOnFileboolean
    Description
    [Optional] Whether this address was previously saved to the account ("true"/"false").
  - firstNamestringrequired
    Example
    Jane
    Description
    [Required] Recipient's first name at this address.
  - middleNamestring
    Example
    Marie
    Description
    [Optional] Recipient's middle name at this address.
  - lastNamestringrequired
    Example
    Doe
    Description
    [Required] Recipient's last name at this address.
  - emailAddressstring
    Example
    [email protected]
    Description
    [Optional] Recipient's email address for order communications.
  - phonestringrequired
    Example
    3125555555
    Description
    [Required] Recipient's phone number.
  - phoneCountryCodestringrequired
    Example
    001
    Description
    [Required] International dial prefix for the phone number (e.g., "001").
  - address1stringrequired
    Example
    1863 Main Street
    Description
    [Required] Primary street address line.
  - address2string
    Example
    Apt 7
    Description
    [Optional] Secondary address line (suite, apartment, etc.).
  - citystringrequired
    Example
    Anaheim
    Description
    [Required] City component of the address.
  - regionstringrequired
    Example
    CA
    Description
    [Required] State or region component of the address.
  - postCodestringrequired
    Example
    92802
    Description
    [Required] Postal or ZIP code.
  - countrystringrequired
    Example
    US
    Description
    [Required] ISO 3166-1 alpha-2 country code.
  - companyNamestring
    Example
    Accertify, Inc
    Description
    [Optional] Business name at this address.
  - addressCreatedDateTimestring<date-time>
    Example
    2020-03-28T17:07:24-07:00
    Description
    [Optional] ISO 8601 timestamp of when this address was saved.
    Format
    date-time
  - addressUpdatedDateTimestring<date-time>
    Example
    2021-03-28T17:07:24-07:00
    Description
    [Optional] ISO 8601 timestamp of the last modification to this address.
    Format
    date-time
- billingAddressesobject[]
  - addressIDstringrequired
    Example
    23l4jk23klj23
    Description
    [Required] Merchant-assigned identifier for this address record.
  - primaryFlagboolean
    Example
    true
    Description
    [Optional] Marks this as the account's primary address ("true"/"false").
  - isAddressOnFileboolean
    Description
    [Optional] Whether this address was previously saved to the account ("true"/"false").
  - firstNamestringrequired
    Example
    Jane
    Description
    [Required] Recipient's first name at this address.
  - middleNamestring
    Example
    Marie
    Description
    [Optional] Recipient's middle name at this address.
  - lastNamestringrequired
    Example
    Doe
    Description
    [Required] Recipient's last name at this address.
  - emailAddressstring
    Example
    [email protected]
    Description
    [Optional] Recipient's email address for order communications.
  - phonestringrequired
    Example
    3125555555
    Description
    [Required] Recipient's phone number.
  - phoneCountryCodestringrequired
    Example
    001
    Description
    [Required] International dial prefix for the phone number (e.g., "001").
  - address1stringrequired
    Example
    1863 Main Street
    Description
    [Required] Primary street address line.
  - address2string
    Example
    Apt 7
    Description
    [Optional] Secondary address line (suite, apartment, etc.).
  - citystringrequired
    Example
    Anaheim
    Description
    [Required] City component of the address.
  - regionstringrequired
    Example
    CA
    Description
    [Required] State or region component of the address.
  - postCodestringrequired
    Example
    92802
    Description
    [Required] Postal or ZIP code.
  - countrystringrequired
    Example
    US
    Description
    [Required] ISO 3166-1 alpha-2 country code.
  - companyNamestring
    Example
    Accertify, Inc
    Description
    [Optional] Business name at this address.
  - addressCreatedDateTimestring<date-time>
    Example
    2020-03-28T17:07:24-07:00
    Description
    [Optional] ISO 8601 timestamp of when this address was saved.
    Format
    date-time
  - addressUpdatedDateTimestring<date-time>
    Example
    2021-03-28T17:07:24-07:00
    Description
    [Optional] ISO 8601 timestamp of the last modification to this address.
    Format
    date-time
- paymentMethodsobject[]
  Example
```
[
  {
    "paymentType": "creditCard",
    "paymentMethodID": "2ljr9vxsdfew",
    "paymentMethodAmount": 399,
    "isPaymentStoredOnFile": true,
    "cardNumber": "4111111111111111",
    "cardToken": "6f7%gf38hfUa",
    "expirationMonth": "11",
    "expirationYear": "2027",
    "nameOnCreditCard": "Jane Doe",
    "cardBin": "345678",
    "cardLastFour": "1111",
    "totalFailedAttempts": 3,
    "paymentMethodCreatedDateTime": "2020-03-28T17:07:24-07:00",
    "paymentMethodUpdatedDateTime": "2020-03-28T17:07:24-07:00",
    "addressID": "23kl4l32l",
    "avsResult": "matched",
    "cvvResult": "matched",
    "cardAuthorizationCode": "12345",
    "cardAuthorizationDateTime": "2022-03-11T17:07:24-07:00",
    "isPreAuthorizationReject": false,
    "sca3DSFlow": "frictionless",
    "sca3DSVersion": "2.2.0",
    "sca3DSChallengeRequestType": "02",
    "sca3DSTransactionStatus": "Y",
    "scaAuthorizationStatus": "approve",
    "eciIndicator": "successful",
    "isSCASoftDecline": false
  }
]
```
  - paymentTypestring<bankAccount | cash | check | creditCard | cryptoCurrency | digitalWallet | electronicFundTransfer | giftCard | invoice | loan | loyaltyPoints | moneyOrder | secCard | storeCredit | thirdParty | voucher>
    Example
    creditCard
    Description
    [Conditional] Type of payment instrument. Required when paymentMethodID is present.
    Allowed
    bankAccountcashcheckcreditCardcryptoCurrencydigitalWalletelectronicFundTransfergiftCardinvoiceloanloyaltyPointsmoneyOrdersecCardstoreCreditthirdPartyvoucher
  - paymentMethodIDstring
    Example
    2ljr9vxsdfew
    Description
    [Optional] Merchant-assigned identifier for this payment method.
  - paymentMethodAmountnumber
    Example
    399
    Description
    [Optional] Amount charged to this payment method.
    Minimum
    0
  - isPaymentStoredOnFileboolean
    Example
    true
    Description
    [Optional] Whether this instrument is saved to the account ("true"/"false").
  - cardNumberstring
    Example
    4111111111111111
    Description
    [Optional] Full card number (PAN) for credit card payments, validated using the Luhn algorithm.
  - cardTokenstring
    Example
    6f7%gf38hfUa
    Description
    [Optional] Tokenized representation of the card number.
  - expirationMonthstring<01 | 02 | 03 | 04 | 05 | 06 | 07 | 8 | 9 | 10 | 11 | 12>
    Example
    11
    Description
    [Conditional] Zero-padded two-digit card expiration month ("01".."12"); required when paymentType = creditCard.
    Allowed
    0102030405060789101112
  - expirationYearstring
    Example
    2027
    Description
    [Conditional] Card expiration year (4-digit); required when paymentType = creditCard.
  - nameOnCreditCardstring
    Example
    Jane Doe
    Description
    [Conditional] Cardholder name as embossed on the card; required when paymentType = creditCard.
  - cardBinstring
    Example
    345678
    Description
    [Optional] Bank Identification Number (6 to 11 digits) of the card.
  - cardLastFourstring
    Example
    1111
    Description
    [Optional] Last four digits of the card number.
  - totalFailedAttemptsinteger
    Example
    3
    Description
    [Optional] Number of failed payment attempts for this method.
    Minimum
    0
  - paymentMethodCreatedDateTimestring<date-time>
    Example
    2020-03-28T17:07:24-07:00
    Description
    [Optional] ISO 8601 timestamp of when this payment method was saved.
    Format
    date-time
  - paymentMethodUpdatedDateTimestring<date-time>
    Example
    2020-03-28T17:07:24-07:00
    Description
    [Optional] ISO 8601 timestamp of the last update to this payment method.
    Format
    date-time
  - addressIDstring
    Example
    23kl4l32l
    Description
    [Optional] Reference to the billing address record for this payment method.
  - nameOnAccountstring
    Example
    Jane Doe
    Description
    [Optional] Name on file for a wallet or account-based payment method.
  - walletTypestring
    Example
    Apple Pay
    Description
    [Optional] Digital wallet provider.
  - walletStatusstring<active | pending | inactive>
    Example
    active
    Description
    [Optional] Current status of the wallet.
    Allowed
    activependinginactive
  - isWalletProtectionEligibleboolean
    Example
    true
    Description
    [Optional] Whether the wallet is eligible for purchase protection ("true"/"false").
  - paymentMethodBalanceAmountnumber
    Example
    4000.32
    Description
    [Optional] Remaining balance available on this payment method.
    Minimum (exclusive)
    0
  - giftCardNumberstring
    Example
    5555444433332222
    Description
    [Optional] Full gift card number.
  - giftCardLastFourstring
    Example
    2222
    Description
    [Optional] Last four digits of the gift card number.
  - giftCardBINstring
    Example
    654678
    Description
    [Optional] Bank Identification Number (first 6 digits) of the gift card.
  - expirationDaystring
    Example
    9
    Description
    [Optional] Card expiration day, for payment types that include a day component.
  - pointsinteger
    Example
    50000
    Description
    [Optional] Loyalty or reward points balance associated with this payment method.
  - loyaltyProgramNamestring
    Example
    Members Plus
    Description
    [Optional] Name of the loyalty program associated with this payment method.
  - accountTypestring<checking | saving | moneyMarket | other>
    Example
    checking
    Description
    [Conditional] Bank account type; required when paymentType = bankAccount.
    Allowed
    checkingsavingmoneyMarketother
  - avsResultstring<matched | partialMatch | notMatched | notChecked | systemError | other>
    Example
    matched
    Description
    [Optional] Address Verification Service result code returned by the card network.
    Allowed
    matchedpartialMatchnotMatchednotCheckedsystemErrorother
  - cvvResultstring<matched | notMatched>
    Example
    matched
    Description
    [Optional] Card Verification Value validation result code returned by the card network.
    Allowed
    matchednotMatched
  - cardAuthorizationCodestring
    Example
    12345
    Description
    [Optional] Authorization approval code returned by the card network.
  - cardAuthorizationDateTimestring<date-time>
    Example
    2022-03-11T17:07:24-07:00
    Description
    [Optional] ISO 8601 timestamp of when the authorization was issued.
    Format
    date-time
  - isPreAuthorizationRejectboolean
    Description
    [Optional] Whether the authorization was rejected before submission ("true"/"false" also accepted).
  - postAuthorizationRejectReasonstring<creditReject | fraudReject | otherReject>
    Example
    creditReject
    Description
    [Optional] Reason the post-authorization was rejected.
    Allowed
    creditRejectfraudRejectotherReject
  - eciIndicatorstring<successful | unsuccessfulOrNotAttempted | attemptedButNotCompleted | other>
    Example
    successful
    Description
    [Conditional] E-Commerce Indicator returned by the 3DS process; required when sca3DSFlow is present.
    Allowed
    successfulunsuccessfulOrNotAttemptedattemptedButNotCompletedother
  - isSCASoftDeclineboolean
    Description
    [Conditional] Whether the authorization received a soft decline requiring SCA ("true"/"false" also accepted); required when sca3DSFlow is present.
  - sca3DSFlowstring<challenge | frictionless | dataOnly>
    Example
    frictionless
    Description
    [Optional] 3DS authentication flow that was applied; one of: challenge, frictionless, dataOnly; when present, the SCA fields below become required.
    Allowed
    challengefrictionlessdataOnly
  - sca3DSVersionstring
    Example
    2.2.0
    Description
    [Conditional] 3DS protocol version used; required when sca3DSFlow is present.
  - sca3DSChallengeRequestTypestring<02 | 03 | 04 | 05 | 06 | 10 | 11>
    Example
    02
    Description
    [Conditional] Type of 3DS challenge initiated; one of: 02, 03, 04, 05, 06, 10, 11. Required when sca3DSFlow is present.
    Allowed
    02030405061011
  - sca3DSTransactionStatusstring<Y | N | U | A | I>
    Example
    Y
    Description
    [Conditional] 3DS transaction status returned by the issuer; one of: Y, N, U, A, I. Required when sca3DSFlow is present.
    Allowed
    YNUAI
  - scaAuthorizationStatusstring<approve | decline>
    Example
    approve
    Description
    [Conditional] SCA authorization outcome; one of: approve, decline. Required when sca3DSFlow is present.
    Allowed
    approvedecline
  - scaAuthorizationErrorstring<decline | fraudReject | insufficientFunds | invalidCard | incorrectInformation | lostOrStolen | withdrawalAmountExceeded | technicalError | other>
    Example
    decline
    Description
    [Conditional] Reason for a declined SCA authorization; required when scaAuthorizationStatus is "decline".
    Allowed
    declinefraudRejectinsufficientFundsinvalidCardincorrectInformationlostOrStolenwithdrawalAmountExceededtechnicalErrorother
- itemsobject[]
  Example
```
[
  {
    "itemType": "ticket",
    "brandName": "Apple",
    "description": "Macbook Pro",
    "category": "Computers",
    "itemID": "af877wernnasnfes",
    "isHighRiskItem": true,
    "price": 1199.99,
    "faceValueAmount": 1599.99,
    "quantity": 2,
    "addressID": "2lkj34jldsoufsous82df",
    "productCondition": "new",
    "shippingMethod": "storePickup",
    "promoCode": "ABC12",
    "promoAmount": 50,
    "promoType": "employeeDiscount",
    "pickupLocation": "curbside",
    "pickupDateTime": "2022-03-11T17:07:24-07:00",
    "pickupPersonFirstName": "Betty",
    "pickupPersonLastName": "Smith"
  }
]
```
  - itemTypestring<giftCard | parking | physicalGood | reservation | subscription | ticket | other>
    Example
    ticket
    Description
    [Optional] Category of item; one of: giftCard, parking, physicalGood, reservation, subscription, ticket, other.
    Allowed
    giftCardparkingphysicalGoodreservationsubscriptionticketother
  - brandNamestring
    Example
    Apple
    Description
    [Optional] Brand or manufacturer of the item.
  - descriptionstring
    Example
    Macbook Pro
    Description
    [Optional] Short description or name of the item.
  - categorystring
    Example
    Computers
    Description
    [Optional] Merchant-defined product category.
  - itemIDstring
    Example
    af877wernnasnfes
    Description
    [Optional] Merchant's unique product or SKU identifier.
  - isHighRiskItembooleanrequired
    Example
    true
    Description
    [Required] Whether the item is flagged as high risk ("true"/"false").
  - pricenumberrequired
    Example
    1199.99
    Description
    [Required] Unit price of the item; positive number.
    Minimum
    0
  - faceValueAmountnumber
    Example
    1599.99
    Description
    [Optional] Face or retail value of the item; zero or positive.
    Minimum
    0
  - quantitynumber
    Example
    2
    Description
    [Optional] Number of units of this item in the order.
  - addressIDstring
    Example
    2lkj34jldsoufsous82df
    Description
    [Conditional] Delivery address reference for this line item; required when shippingMethod is present.
  - productConditionstring<new | openPackage | other | refurbished | used>
    Example
    new
    Description
    [Optional] Condition of the item; one of: new, openPackage, other, refurbished, used.
    Allowed
    newopenPackageotherrefurbishedused
  - shippingCompanystring<dhl | fedex | ups | usps | other>
    Example
    ups
    Description
    [Optional] Carrier for this item; one of: dhl, fedex, ups, usps, other.
    Allowed
    dhlfedexupsuspsother
  - companyNamestring
    Example
    Regional Courier Co
    Description
    [Optional] Shipping company name for this item, when not one of the standard carriers (max 50 chars).
    Max Length
    50
  - shippingMethodstring<digital | ground | international | other | nextDay | sameDay | storePickup | twoDay | threeDay>required
    Example
    storePickup
    Description
    [Required] Shipping speed or method.
    Allowed
    digitalgroundinternationalothernextDaysameDaystorePickuptwoDaythreeDay
  - shippingTrackingNumberstring
    Example
    23l4fdswerea02
    Description
    [Optional] Carrier tracking number for this item (max 30 chars).
    Max Length
    30
  - promoCodestring
    Example
    ABC12
    Description
    [Optional] Promotion code applied specifically to this item (max 40 chars).
    Max Length
    40
  - promoAmountnumber
    Example
    50
    Description
    [Optional] Discount applied to this item; zero or positive.
    Minimum
    0
  - promoTypestring<bogo | bundle | employeeDiscount | freeShipping | loyaltyDiscount | newMemberDiscount | percentage | quantityPromotion | other>
    Example
    employeeDiscount
    Description
    [Optional] Category of the item-level promotion.
    Allowed
    bogobundleemployeeDiscountfreeShippingloyaltyDiscountnewMemberDiscountpercentagequantityPromotionother
  - pickupLocationstring<curbside | dropBox | inStore | other>
    Example
    curbside
    Description
    [Optional] In-store or curbside pickup method; one of: curbside, dropBox, inStore, other.
    Allowed
    curbsidedropBoxinStoreother
  - pickupDateTimestring<date-time>
    Example
    2022-03-11T17:07:24-07:00
    Description
    [Optional] ISO 8601 timestamp of the scheduled pickup.
    Format
    date-time
  - pickupPersonFirstNamestring
    Example
    Betty
    Description
    [Optional] First name of the person collecting the order (max 40 chars).
    Max Length
    40
  - pickupPersonLastNamestring
    Example
    Smith
    Description
    [Optional] Last name of the person collecting the order (max 40 chars).
    Max Length
    40
- promotionsobject[]
  Example
```
[
  {
    "promoCode": "ABC12",
    "promoAmount": 50,
    "promoType": "employeeDiscount"
  }
]
```
  - promoCodestring
    Example
    ABC12
    Description
    [Optional] Promotional code applied to the order.
  - promoAmountnumberrequired
    Example
    50
    Description
    [Required] Discount amount granted by this promotion; zero or positive.
    Minimum
    0
  - promoTypestring<bogo | bundle | employeeDiscount | freeShipping | loyaltyDiscount | newMemberDiscount | percentage | quantityPromotion | other>
    Example
    employeeDiscount
    Description
    [Optional] Category of the promotion (e.g., employeeDiscount, freeShipping).
    Allowed
    bogobundleemployeeDiscountfreeShippingloyaltyDiscountnewMemberDiscountpercentagequantityPromotionother
- ticketDetailsobject[]
  Example
```
[
  {
    "guestFirstName": "John",
    "guestMiddleName": "Edward",
    "guestLastName": "Smith",
    "guestAdultOrChild": "adult",
    "ticketPLU": "234jl234jl324jl23kl23",
    "ticketPrice": 99.92,
    "ticketCurrencyCode": "USD",
    "ticketStartDateTime": "2020-02-22T17:07:24-07:00",
    "ticketExpirationDateTime": "2020-02-22T17:07:24-07:00",
    "ticketClass": "premium",
    "ticketParkID": "3432432432",
    "isAnnualPass": true,
    "isRenewal": true,
    "annualPassName": "Gold Pass",
    "annualPassAltName": "Legacy Loyal Pass"
  }
]
```
  - guestFirstNamestring
    Example
    John
    Description
    [Optional] Guest first name.
  - guestMiddleNamestring
    Example
    Edward
    Description
    [Optional] Guest middle name.
  - guestLastNamestring
    Example
    Smith
    Description
    [Optional] Guest last name.
  - guestAdultOrChildstring<adult | child | infant | senior>
    Example
    adult
    Description
    [Optional] Guest age category.
    Allowed
    adultchildinfantsenior
  - ticketPLUstring
    Example
    234jl234jl324jl23kl23
    Description
    [Optional] Ticket product lookup identifier.
  - ticketPricenumber
    Example
    99.92
    Description
    [Optional] Ticket purchase price.
    Minimum
    0
  - ticketCurrencyCodestring
    Example
    USD
    Description
    [Optional] ISO-4217 currency code.
  - ticketStartDateTimestring<date-time>required
    Example
    2020-02-22T17:07:24-07:00
    Description
    [Required] Ticket start date and time.
    Format
    date-time
  - ticketExpirationDateTimestring<date-time>
    Example
    2020-02-22T17:07:24-07:00
    Description
    [Optional] Ticket expiration date and time.
    Format
    date-time
  - ticketClassstring<economy | premium | business | first>
    Example
    premium
    Description
    [Optional] Ticket class.
    Allowed
    economypremiumbusinessfirst
  - ticketParkIDstring
    Example
    3432432432
    Description
    [Optional] Identifier of the park associated with the ticket (max 40 chars).
    Max Length
    40
  - isAnnualPassboolean
    Example
    true
    Description
    [Optional] Whether the ticket is an annual pass ("true"/"false" also accepted).
  - isRenewalboolean
    Example
    true
    Description
    [Optional] Whether the ticket is a renewal of an existing pass ("true"/"false" also accepted).
  - annualPassNamestring
    Example
    Gold Pass
    Description
    [Optional] Name of the annual pass product (max 40 chars).
    Max Length
    40
  - annualPassAltNamestring
    Example
    Legacy Loyal Pass
    Description
    [Optional] Alternate or legacy name of the annual pass product (max 40 chars).
    Max Length
    40
- eventobject
  Example
```
{
  "eventID": "234kl5jkl523jkl423jkl",
  "eventType": "concert",
  "eventName": "Fleetwood Mac",
  "eventDateTime": "2022-03-11T17:07:24-07:00",
  "eventOnSaleDateTime": "2022-03-11T17:07:24-07:00",
  "eventGenre": "country",
  "venueID": "223jklk234j3l4",
  "venueAddressID": "3243324232",
  "eventCreatedDateTime": "2022-03-11T17:07:24-07:00",
  "eventLastUpdatedDateTime": "2022-03-11T17:07:24-07:00",
  "tickets": {
    "sectionNumber": "401",
    "sectionName": "home",
    "row": "24",
    "rowName": "upper",
    "numberOfTickets": 2,
    "startSeat": "2",
    "endSeat": "3"
  }
}
```
  Description
  Nested object containing information about the event and the tickets associated with the event.
  - eventIDstring
    Example
    234kl5jkl523jkl423jkl
    Description
    [Optional] Event identifier (max 30 chars).
    Max Length
    30
  - eventTypestring<activity | comedy | concert | sports | theater>
    Example
    concert
    Description
    [Conditional] Type of event; required when eventID is present.
    Allowed
    activitycomedyconcertsportstheater
  - eventNamestring
    Example
    Fleetwood Mac
    Description
    [Optional] Event name (max 30 chars).
    Max Length
    30
  - eventDateTimestring<date-time>
    Example
    2022-03-11T17:07:24-07:00
    Description
    [Conditional] ISO 8601 date and time of the event; required when eventID is present.
    Format
    date-time
  - eventOnSaleDateTimestring<date-time>
    Example
    2022-03-11T17:07:24-07:00
    Description
    [Optional] ISO 8601 date and time when tickets for the event went on sale.
    Format
    date-time
  - eventGenrestring<alternative | country | dance | jazz | other | pop | rap | rock>
    Example
    country
    Description
    [Optional] Event genre classification.
    Allowed
    alternativecountrydancejazzotherpopraprock
  - venueIDstring
    Example
    223jklk234j3l4
    Description
    [Optional] Identifier of the venue where the event is held (max 20 chars).
    Max Length
    20
  - venueAddressIDstring
    Example
    3243324232
    Description
    [Optional] Reference to the address record for the event venue (max 10 chars).
    Max Length
    10
  - eventCreatedDateTimestring<date-time>
    Example
    2022-03-11T17:07:24-07:00
    Description
    [Optional] ISO 8601 date and time when the event record was created.
    Format
    date-time
  - eventLastUpdatedDateTimestring<date-time>
    Example
    2022-03-11T17:07:24-07:00
    Description
    [Optional] ISO 8601 date and time when the event record was last updated.
    Format
    date-time
  - ticketsobject
    Example
    { "sectionNumber": "401", "sectionName": "home", "row": "24", "rowName": "upper", "numberOfTickets": 2, "startSeat": "2", "endSeat": "3" }
    Description
    [Optional] Seating and ticket quantity information associated with the event.
    - sectionNumberstring
      Example
      401
      Description
      [Optional] Section number associated with the tickets (max 5 chars).
      Max Length
      5
    - sectionNamestring
      Example
      home
      Description
      [Optional] Section name associated with the tickets (max 40 chars).
      Max Length
      40
    - rowstring
      Example
      24
      Description
      [Optional] Row identifier associated with the tickets (max 5 chars).
      Max Length
      5
    - rowNamestring
      Example
      upper
      Description
      [Optional] Row name associated with the tickets (max 5 chars).
      Max Length
      5
    - numberOfTicketsinteger
      Example
      2
      Description
      [Optional] Number of tickets associated with the event purchase; must be greater than zero.
      Minimum (exclusive)
      0
    - startSeatstring
      Example
      2
      Description
      [Optional] Starting seat number associated with the tickets (max 5 chars).
      Max Length
      5
    - endSeatstring
      Example
      3
      Description
      [Optional] Ending seat number associated with the tickets (max 5 chars).
      Max Length
      5
- agencyInformationobject
  Example
```
{
  "agencyDetails": [
    {
      "agencyCode": "01234ABC",
      "agencyName": "Acme Travel inc",
      "agencySalesRepresentativeID": "232324521",
      "agencyConfirmationNumber": "ABC123",
      "agencyCountryCode": "AU",
      "agencyEmail": "[email protected]",
      "agencyHeadOffice": "Melbourne",
      "agencyPhone": "19876543211"
    }
  ]
}
```
  Description
  Nested object containing agency information associated with the transaction.
  - agencyDetailsobject[]
    Example
    [ { "agencyCode": "01234ABC", "agencyName": "Acme Travel inc", "agencySalesRepresentativeID": "232324521", "agencyConfirmationNumber": "ABC123", "agencyCountryCode": "AU", "agencyEmail": "[email protected]", "agencyHeadOffice": "Melbourne", "agencyPhone": "19876543211" } ]
    Description
    [Optional] Agency records associated with the transaction.
    - agencyCodestring
      Example
      01234ABC
      Description
      [Optional] Agency code (max 20 chars).
      Max Length
      20
    - agencyNamestring
      Example
      Acme Travel inc
      Description
      [Optional] Agency name (max 50 chars).
      Max Length
      50
    - agencySalesRepresentativeIDstring
      Example
      232324521
      Description
      [Optional] Identifier of the agency sales representative (max 20 chars).
      Max Length
      20
    - agencyConfirmationNumberstring
      Example
      ABC123
      Description
      [Optional] Confirmation number assigned by the agency (max 25 chars).
      Max Length
      25
    - agencyCountryCodestring
      Example
      AU
      Description
      [Optional] ISO 3166-1 alpha-2 country code associated with the agency.
    - agencyEmailstring
      Example
      [email protected]
      Description
      [Optional] Agency email address.
    - agencyHeadOfficestring
      Example
      Melbourne
      Description
      [Optional] Location of the agency head office (max 50 chars).
      Max Length
      50
    - agencyPhonestring
      Example
      19876543211
      Description
      [Optional] Agency phone number (max 25 chars).
      Max Length
      25
- insuranceInformationobject
  Example
```
{
  "insuranceDetails": [
    {
      "insuranceType": "travel",
      "insuranceCity": "Sydney",
      "insuranceCountryCode": "AU",
      "insuranceStartDateTime": "2022-03-11T17:07:24-07:00",
      "insuranceEndDateTime": "2022-03-11T17:07:24-07:00",
      "insuranceName": "Acme Insurance Full Cover",
      "insuranceReservationName": "Jane Doe",
      "insuranceTotalAmount": 399.04,
      "insuranceCurrencyCode": "AUD"
    }
  ]
}
```
  Description
  Nested object containing insurance information associated with the transaction.
  - insuranceDetailsobject[]
    Example
    [ { "insuranceType": "travel", "insuranceCity": "Sydney", "insuranceCountryCode": "AU", "insuranceStartDateTime": "2022-03-11T17:07:24-07:00", "insuranceEndDateTime": "2022-03-11T17:07:24-07:00", "insuranceName": "Acme Insurance Full Cover", "insuranceReservationName": "Jane Doe", "insuranceTotalAmount": 399.04, "insuranceCurrencyCode": "AUD" } ]
    Description
    [Optional] Insurance records associated with the transaction.
    - insuranceTypestring
      Example
      travel
      Description
      [Optional] Type of insurance associated with the transaction (max 30 chars).
      Max Length
      30
    - insuranceCitystring
      Example
      Sydney
      Description
      [Optional] City associated with the insurance coverage (max 40 chars).
      Max Length
      40
    - insuranceCountryCodestring
      Example
      AU
      Description
      [Optional] ISO 3166-1 alpha-2 country code associated with the insurance coverage.
    - insuranceStartDateTimestring<date-time>
      Example
      2022-03-11T17:07:24-07:00
      Description
      [Optional] ISO 8601 date and time when the insurance coverage begins.
      Format
      date-time
    - insuranceEndDateTimestring<date-time>
      Example
      2022-03-11T17:07:24-07:00
      Description
      [Optional] ISO 8601 date and time when the insurance coverage ends.
      Format
      date-time
    - insuranceNamestring
      Example
      Acme Insurance Full Cover
      Description
      [Optional] Name of the insurance product (max 50 chars).
      Max Length
      50
    - insuranceReservationNamestring
      Example
      Jane Doe
      Description
      [Optional] Name associated with the insured reservation (max 100 chars).
      Max Length
      100
    - insuranceTotalAmountnumber
      Example
      399.04
      Description
      [Optional] Total amount charged for the insurance coverage; zero or positive.
      Minimum
      0
    - insuranceCurrencyCodestring
      Example
      AUD
      Description
      [Optional] ISO 4217 three-letter currency code for the insurance amount.

Responses

200Successful response.

scoredResult
Description
Successful response.
- eventIDstring
- eventDetailseventDetails
  Description
  Device and connection risk signals (scored responses only)
  - deviceDetailsobject
    - browserSpoofRiskstring
      Example
      HIGH_RISK
      Description
      [Optional] Risk indicator for browser spoofing detected during device collection.
    - deviceIDNewstring
      Example
      true
      Description
      [Optional] A flag indicating the device ID was observed for the first time ("true"/"false").
    - browserIsMobilestring
      Example
      true
      Description
      [Optional] A flag indicating the browser is running on a mobile device ("true"/"false").
    - mobileIsRootedstring
      Example
      true
      Description
      [Optional] A flag indicating the mobile device is rooted or jailbroken ("true"/"false").
    - deviceIDFirstSeennumber
      Example
      97
      Description
      [Optional] Number of days since this device ID was first observed.
    - browserNewCookiestring
      Example
      false
      Description
      [Optional] A flag indicating a new browser cookie was set during this session ("true"/"false").
    - deviceIDTimesSeennumber
      Example
      123
      Description
      [Optional] Total number of times this device ID has been seen.
    - mobileAppstring
      Example
      true
      Description
      [Optional] A flag indicating the event originated from a mobile app.
    - browserReplayTagStatusstring
      Example
      VALID
      Description
      [Optional] Status of the UBA replay tag detected in the session.
    - deviceIDstring
      Example
      63dc80b4-e585-4ae8-8004-e24fb0d1fa84
      Description
      [Optional] Unique persistent identifier assigned to the device.
  - connectionDetailsobject
    - hostingIndicatorstring
      Example
      true
      Description
      [Optional] A flag indicating the client IP address belongs to a hosting provider ("true"/"false").
    - isTorstring
      Example
      true
      Description
      [Optional] A flag indicating the client IP address is a Tor exit node ("true"/"false").
    - hostingIndicatorRealstring
      Example
      true
      Description
      [Optional] A flag indicating the client real IP address belongs to a hosting provider ("true"/"false").
    - realIPMatchstring
      Example
      true
      Description
      [Optional] A flag indicating the stated IP address matches the detected real IP address ("true"/"false").
    - countryCodestring
      Example
      us
      Description
      [Optional] ISO 3166-1 alpha-2 country code of the client IP address.
    - countryCodeRealstring
      Example
      de
      Description
      [Optional] ISO 3166-1 alpha-2 country code of the real IP address when a proxy is detected.
    - isProxystring
      Example
      false
      Description
      [Optional] A flag indicating the client IP address is a known proxy ("true"/"false").
- messagesapiMessages
  - errorapiMessage[]
    - codestringrequired
      Example
      FIELD_REQUIRED_MISSING
      Description
      Machine-readable message code
    - messagestringrequired
      Example
      transactionID is required and was not provided
      Description
      Human-readable message
    - fieldstring
      Example
      transactionID
      Description
      Name of the field this message applies to
    - detailsmap<string, string>
      Description
      Structured detail keys.
  - warningapiMessage[]
    - codestringrequired
      Example
      FIELD_REQUIRED_MISSING
      Description
      Machine-readable message code
    - messagestringrequired
      Example
      transactionID is required and was not provided
      Description
      Human-readable message
    - fieldstring
      Example
      transactionID
      Description
      Name of the field this message applies to
    - detailsmap<string, string>
      Description
      Structured detail keys.
  - infoapiMessage[]
    - codestringrequired
      Example
      FIELD_REQUIRED_MISSING
      Description
      Machine-readable message code
    - messagestringrequired
      Example
      transactionID is required and was not provided
      Description
      Human-readable message
    - fieldstring
      Example
      transactionID
      Description
      Name of the field this message applies to
    - detailsmap<string, string>
      Description
      Structured detail keys.
- statusbooleanrequired

400Error response for invalid or missing request inputs. Returned when one or more required fields are absent or fail validation.

validationFailedError
Description
Error response for invalid or missing request inputs. Returned when one or more required fields are absent or fail validation.
- errorCodeinteger
  Example
  400
  Description
  HTTP status code for the validation error.
- errorMessagestring
  Example
  Validation Failed
  Description
  Human-readable summary of the validation error.
- errorsstring[]
  Example
```
[
  "Missing required field: transactionID"
]
```
  Description
  Validation error details for the request.

401Error response for authentication or authorization failures. Returned when credentials are invalid or the authenticated user has no matching API configuration for this endpoint.

notAuthorizedError
Description
Error response for authentication or authorization failures. Returned when credentials are invalid or the authenticated user has no matching API configuration for this endpoint.
- errorCodeinteger
  Example
  401
  Description
  HTTP status code for the authentication or authorization error.
- errorMessagestring
  Example
  Not Authorized
  Description
  Human-readable summary of the authentication or authorization error.

429Error response when the request rate limit has been exceeded for the API user or API configuration.

rateLimitError
Description
Error response when the request rate limit has been exceeded for the API user or API configuration.
- errorCodeinteger
  Example
  429
  Description
  HTTP status code for the rate-limit error.
- errorMessagestring
  Example
  Rate Limit Exceeded
  Description
  Human-readable summary of the rate-limit error.

500Error response when the request cannot be processed due to an unexpected internal error.

internalServerError
Description
Error response when the request cannot be processed due to an unexpected internal error.
- errorCodeinteger
  Example
  500
  Description
  HTTP status code for the internal server error.
- errorMessagestring
  Example
  Internal Server Error
  Description
  Human-readable summary of the internal server error.

curl

curl --request POST \
     --url https://api.accertify.net/api/v1/unified-risk/postAuthAmusement \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data-raw '{
     "transactionID": "ABC123456",
     "transactionDateTime": "2022-03-11T17:07:24-07:00",
     "eventSource": "web",
     "isGuestCheckout": false,
     "paymentAmount": 1082.91,
     "taxAmount": 1.23,
     "deliveryAmount": 5.99,
     "currencyCode": "USD",
     "success": true,
     "emailAddress": "[email protected]",
     "purchaseType": "physicalItems",
     "addresses": [
     {
     "addressID": "23l4jk23klj23",
     "addressType": "shipping",
     "firstName": "Jane",
     "lastName": "Doe",
     "phone": "3125555555",
     "phoneCountryCode": "001",
     "address1": "1863 Main Street",
     "city": "Anaheim",
     "region": "CA",
     "postCode": "92802",
     "country": "US"
     }
     ],
     "shippingAddresses": [
     {
     "addressID": "23l4jk23klj23",
     "firstName": "Jane",
     "lastName": "Doe",
     "phone": "3125555555",
     "phoneCountryCode": "001",
     "address1": "1863 Main Street",
     "city": "Anaheim",
     "region": "CA",
     "postCode": "92802",
     "country": "US"
     }
     ],
     "billingAddresses": [
     {
     "addressID": "23l4jk23klj23",
     "firstName": "Jane",
     "lastName": "Doe",
     "phone": "3125555555",
     "phoneCountryCode": "001",
     "address1": "1863 Main Street",
     "city": "Anaheim",
     "region": "CA",
     "postCode": "92802",
     "country": "US"
     }
     ],
     "items": [
     {
     "isHighRiskItem": true,
     "price": 1199.99,
     "shippingMethod": "storePickup"
     }
     ],
     "promotions": [
     {
     "promoAmount": 50
     }
     ],
     "ticketDetails": [
     {
     "ticketStartDateTime": "2020-02-22T17:07:24-07:00"
     }
     ]
     }'

javascript

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");

var raw = JSON.stringify({
   "transactionID": "ABC123456",
   "transactionDateTime": "2022-03-11T17:07:24-07:00",
   "eventSource": "web",
   "isGuestCheckout": false,
   "paymentAmount": 1082.91,
   "taxAmount": 1.23,
   "deliveryAmount": 5.99,
   "currencyCode": "USD",
   "success": true,
   "emailAddress": "[email protected]",
   "purchaseType": "physicalItems",
   "addresses": [
      {
         "addressID": "23l4jk23klj23",
         "addressType": "shipping",
         "firstName": "Jane",
         "lastName": "Doe",
         "phone": "3125555555",
         "phoneCountryCode": "001",
         "address1": "1863 Main Street",
         "city": "Anaheim",
         "region": "CA",
         "postCode": "92802",
         "country": "US"
      }
   ],
   "shippingAddresses": [
      {
         "addressID": "23l4jk23klj23",
         "firstName": "Jane",
         "lastName": "Doe",
         "phone": "3125555555",
         "phoneCountryCode": "001",
         "address1": "1863 Main Street",
         "city": "Anaheim",
         "region": "CA",
         "postCode": "92802",
         "country": "US"
      }
   ],
   "billingAddresses": [
      {
         "addressID": "23l4jk23klj23",
         "firstName": "Jane",
         "lastName": "Doe",
         "phone": "3125555555",
         "phoneCountryCode": "001",
         "address1": "1863 Main Street",
         "city": "Anaheim",
         "region": "CA",
         "postCode": "92802",
         "country": "US"
      }
   ],
   "items": [
      {
         "isHighRiskItem": true,
         "price": 1199.99,
         "shippingMethod": "storePickup"
      }
   ],
   "promotions": [
      {
         "promoAmount": 50
      }
   ],
   "ticketDetails": [
      {
         "ticketStartDateTime": "2020-02-22T17:07:24-07:00"
      }
   ]
});

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://api.accertify.net/api/v1/unified-risk/postAuthAmusement", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

ruby

require "uri"
require "json"
require "net/http"

url = URI("https://api.accertify.net/api/v1/unified-risk/postAuthAmusement")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
   "transactionID": "ABC123456",
   "transactionDateTime": "2022-03-11T17:07:24-07:00",
   "eventSource": "web",
   "isGuestCheckout": false,
   "paymentAmount": 1082.91,
   "taxAmount": 1.23,
   "deliveryAmount": 5.99,
   "currencyCode": "USD",
   "success": true,
   "emailAddress": "[email protected]",
   "purchaseType": "physicalItems",
   "addresses": [
      {
         "addressID": "23l4jk23klj23",
         "addressType": "shipping",
         "firstName": "Jane",
         "lastName": "Doe",
         "phone": "3125555555",
         "phoneCountryCode": "001",
         "address1": "1863 Main Street",
         "city": "Anaheim",
         "region": "CA",
         "postCode": "92802",
         "country": "US"
      }
   ],
   "shippingAddresses": [
      {
         "addressID": "23l4jk23klj23",
         "firstName": "Jane",
         "lastName": "Doe",
         "phone": "3125555555",
         "phoneCountryCode": "001",
         "address1": "1863 Main Street",
         "city": "Anaheim",
         "region": "CA",
         "postCode": "92802",
         "country": "US"
      }
   ],
   "billingAddresses": [
      {
         "addressID": "23l4jk23klj23",
         "firstName": "Jane",
         "lastName": "Doe",
         "phone": "3125555555",
         "phoneCountryCode": "001",
         "address1": "1863 Main Street",
         "city": "Anaheim",
         "region": "CA",
         "postCode": "92802",
         "country": "US"
      }
   ],
   "items": [
      {
         "isHighRiskItem": true,
         "price": 1199.99,
         "shippingMethod": "storePickup"
      }
   ],
   "promotions": [
      {
         "promoAmount": 50
      }
   ],
   "ticketDetails": [
      {
         "ticketStartDateTime": "2020-02-22T17:07:24-07:00"
      }
   ]
})

response = https.request(request)
puts response.read_body

python

import requests
import json

url = "https://api.accertify.net/api/v1/unified-risk/postAuthAmusement"

payload = json.dumps({
   "transactionID": "ABC123456",
   "transactionDateTime": "2022-03-11T17:07:24-07:00",
   "eventSource": "web",
   "isGuestCheckout": False,
   "paymentAmount": 1082.91,
   "taxAmount": 1.23,
   "deliveryAmount": 5.99,
   "currencyCode": "USD",
   "success": True,
   "emailAddress": "[email protected]",
   "purchaseType": "physicalItems",
   "addresses": [
      {
         "addressID": "23l4jk23klj23",
         "addressType": "shipping",
         "firstName": "Jane",
         "lastName": "Doe",
         "phone": "3125555555",
         "phoneCountryCode": "001",
         "address1": "1863 Main Street",
         "city": "Anaheim",
         "region": "CA",
         "postCode": "92802",
         "country": "US"
      }
   ],
   "shippingAddresses": [
      {
         "addressID": "23l4jk23klj23",
         "firstName": "Jane",
         "lastName": "Doe",
         "phone": "3125555555",
         "phoneCountryCode": "001",
         "address1": "1863 Main Street",
         "city": "Anaheim",
         "region": "CA",
         "postCode": "92802",
         "country": "US"
      }
   ],
   "billingAddresses": [
      {
         "addressID": "23l4jk23klj23",
         "firstName": "Jane",
         "lastName": "Doe",
         "phone": "3125555555",
         "phoneCountryCode": "001",
         "address1": "1863 Main Street",
         "city": "Anaheim",
         "region": "CA",
         "postCode": "92802",
         "country": "US"
      }
   ],
   "items": [
      {
         "isHighRiskItem": True,
         "price": 1199.99,
         "shippingMethod": "storePickup"
      }
   ],
   "promotions": [
      {
         "promoAmount": 50
      }
   ],
   "ticketDetails": [
      {
         "ticketStartDateTime": "2020-02-22T17:07:24-07:00"
      }
   ]
})
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

200

// Successful response.
{
  "eventID": "",
  "eventDetails": {
    "deviceDetails": {
      "browserSpoofRisk": "HIGH_RISK",
      "deviceIDNew": "true",
      "browserIsMobile": "true",
      "mobileIsRooted": "true",
      "deviceIDFirstSeen": 97,
      "browserNewCookie": "false",
      "deviceIDTimesSeen": 123,
      "mobileApp": "true",
      "browserReplayTagStatus": "VALID",
      "deviceID": "63dc80b4-e585-4ae8-8004-e24fb0d1fa84"
    },
    "connectionDetails": {
      "hostingIndicator": "true",
      "isTor": "true",
      "hostingIndicatorReal": "true",
      "realIPMatch": "true",
      "countryCode": "us",
      "countryCodeReal": "de",
      "isProxy": "false"
    }
  },
  "messages": {
    "error": [
      {
        "code": "FIELD_REQUIRED_MISSING",
        "message": "transactionID is required and was not provided",
        "field": "transactionID",
        "details": ""
      }
    ],
    "warning": [
      {
        "code": "FIELD_REQUIRED_MISSING",
        "message": "transactionID is required and was not provided",
        "field": "transactionID",
        "details": ""
      }
    ],
    "info": [
      {
        "code": "FIELD_REQUIRED_MISSING",
        "message": "transactionID is required and was not provided",
        "field": "transactionID",
        "details": ""
      }
    ]
  },
  "status": false
}

400

// Error response for invalid or missing request inputs. Returned when one or more required fields are absent or fail validation.
{
  "errorCode": 400,
  "errorMessage": "Validation Failed",
  "errors": [
    ""
  ]
}

401

// Error response for authentication or authorization failures. Returned when credentials are invalid or the authenticated user has no matching API configuration for this endpoint.
{
  "errorCode": 401,
  "errorMessage": "Not Authorized"
}

429

// Error response when the request rate limit has been exceeded for the API user or API configuration.
{
  "errorCode": 429,
  "errorMessage": "Rate Limit Exceeded"
}

500

// Error response when the request cannot be processed due to an unexpected internal error.
{
  "errorCode": 500,
  "errorMessage": "Internal Server Error"
}