EU Airline Fields

1 min

POST

https://rtd01.eu.accertify.net/icNowImport/{importerID}

Path Parameters

importerIDstringrequired

Body Parameters

transactionobject
Description
Core payment/transaction fields shared by all Fraud APIs. Fields required for all events. Fields to send when available; they materially improve scoring. Optional but useful context about session and account status. Account/loyalty profile attributes. Cart/session and payment context not tied to a single payment method. Line‑item details across product types. Structured addresses used across billing/shipping/venue/etc. Array of payment methods used (split or single tender). Order-level promotions/discounts. Shared flight schema reused by Airline and Travel APIs.
- transactionIDstringrequired
  Example
  ABC123456
  Description
  [REQUIRED] Unique transaction identifier (e.g., order/booking number). Max length 40.
- transactionTypestring<preAuthorization | postAuthorization | update>required
  Example
  preAuthorization
  Description
  [REQUIRED] Type of submission: occurs pre-auth, post-auth, or updates an existing transaction.
  Allowed
  preAuthorizationpostAuthorizationupdate
- transactionDateTimestring<date-time>required
  Example
  2022-03-11T17:07:24-07:00
  Description
  [REQUIRED] RFC3339 timestamp of when the transaction occurred. Future dates not accepted.
  Format
  date-time
- accountIDstring
  Example
  12363454566
  Description
  [OPTIONAL] Merchant's internal account identifier linked to the customer.
- isGuestCheckoutstring<true | false>
  Description
  [OPTIONAL] Whether checkout happened without logging in to an account.
  Allowed
  truefalse
- paymentAmountnumber<float>required
  Example
  1082.91
  Description
  [REQUIRED] Total amount for the transaction in local currency (tax + shipping included).
  Format
  float
- taxAmountnumber<float>
  Example
  1.23
  Description
  [OPTIONAL] Tax amount in local currency.
  Format
  float
- currencyCodestringrequired
  Example
  USD
  Description
  [REQUIRED] Three-letter ISO-4217 currency code for all monetary values (e.g., USD).
- successstring<true | false>required
  Description
  [REQUIRED] Merchant outcome prior to Accertify recommendation (true = would accept; false = would deny).
  Allowed
  truefalse
- failureCodestring<authFailed | other>
  Description
  [OPTIONAL] Failure reason code when applicable.
  Allowed
  authFailedother
- firstNamestring
  Example
  Jane
  Description
  [OPTIONAL] Account holder's first name (required if accountID exists).
- middleNamestring
  Example
  Marie
  Description
  [OPTIONAL] Account holder's middle name.
- lastNamestring
  Example
  Doe
  Description
  [OPTIONAL] Account holder's last name (required if accountID exists).
- phoneNumberstring
  Description
  [OPTIONAL] Account holder's phone number (no country prefix in this field).
- purchaseTypestring<physicalItems | digitalItems | services | other>required
  Description
  [REQUIRED] High-level purchase classification.
  Allowed
  physicalItemsdigitalItemsservicesother
- listingIDstring
  Example
  abcd1234
  Description
  [OPTIONAL] Third-party marketplace listing identifier where applicable.
- loyaltyNumberstring
  Example
  Id1234
  Description
  [OPTIONAL] Customer's loyalty ID if different from accountID.
- eventSourcestring<agentPhone | agentStore | affiliate | kiosk | mobileApp | other | web>required
  Description
  [REQUIRED] Where/how the event originated (web, mobile app, phone, and so forth).
  Allowed
  agentPhoneagentStoreaffiliatekioskmobileAppotherweb
- ipAddressstring
  Example
  192.168.41.17
  Description
  [IMPERATIVE] End-user IP address. Maximum field length = 45 characters.
- userAgentstring
  Example
  Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:72.0) Gecko/20100101 Firefox/72.0
  Description
  [IMPERATIVE] Browser/OS user agent captured by the site owner. Maximum field length = 250 characters.
- devicePayloadstring
  Example
  afklasdjlasdjl3l23j23423klj
  Description
  [IMPERATIVE] From Accertify Device, the user's device data sent by our Collector script. You will take the devicePayload from the script and add additional server-side properties to it as described in our "Device Payload via the Interceptas Platform" section of our Accertify Data Collector Script Implementation document. Maximum field length = 150,000 characters.
- deviceTransactionIDstring
  Example
  e1a1aade06e2557f34036eeb06173faf1fa05c64959383
  Description
  [IMPERATIVE] From Accertify Device, the Device Transaction ID from the Collector JS or SDK file captured by the site or application owner. Maximum field length = 100 characters. Notes:
  
  We recommend you send devicePayload instead of deviceTransactionID. We are leaving this here for backward compatibility.
  
  You do not have to put in logic to account for deviceTransactionID returning blank. This can happen if JavaScript is blocked or if it is an event taken over the phone.
- ubaIDstring
  Example
  3143e969395de649c48c1c9f3e363a3e7ae7
  Description
  [IMPERATIVE] From Accertify UBA, the ID used to reference behavior data already captured by Accertify. Maximum field length = 100 characters. This value is retrieved from:
  
  Browser from the JavaScript function getToken
  
  iOS/Android from the SDK?function getUbaId()
  
  Note: You do not have to put in logic to account for ubaID returning blank. This can happen if JavaScript is blocked or if it is an event taken over the phone.
- emailAddressstring
  Example
  [email protected]
  Description
  [IMPERATIVE] User's email associated with the account or transaction. Maximum field length = 100 characters.
- ubaEventsstring
  Example
  lasjdlkfdsljelkrrjwl3kl324j32k432
  Description
  [IMPERATIVE] From Accertify UBA, a payload of the most recent fields. This is used to make sure we have up to the second information.
- pageIDstring
  Example
  lk32j4lk324lkj324
  Description
  [IMPERATIVE] From Accertify UBA, the unique page ID defined from the Collector script.
- usernamestring
  Example
  erlichb
  Description
  [IMPERATIVE] User's username if your site allows logging in using username. Maximum field length = 100 characters.
- authenticationMethodstring<appAuthenticator | appPush | FIDO | other | password | magicLink | SMS>
  Description
  [IMPERATIVE] How the user authenticated (password, MFA push, magic link, and so forth).
  Allowed
  appAuthenticatorappPushFIDOotherpasswordmagicLinkSMS
- latitudenumber
  Example
  Numbers with up to 8 decimals, 58.99993333
  Description
  [OPTIONAL] The HTML 5 or GPS based latitude location of the user in decimal degrees format without letters. Maximum field length = 10 characters.
- longitudenumber
  Example
  Numbers with up to 8 decimals, 58.99993333
  Description
  [OPTIONAL] The HTML 5 or GPS based longitude location of the user in decimal degrees format without letters. Maximum field length = 10 characters.
- hashedPasswordstring
  Example
  234j32llk234j3l2k4jl
  Description
  [OPTIONAL] User’s password hashed using Accertify algorithm when required. Maximum field length = 100 characters.
- accountStatusstring<active | dormant | suspended | terminated | trial | other>
  Description
  [OPTIONAL] Status of membership or account.
  Allowed
  activedormantsuspendedterminatedtrialother
- brandstring
  Example
  Acme
  Description
  [OPTIONAL] The brand submitting the event, for clients with multiple brands under one corporate entity. Maximum field length = 50 characters.
- sessionIDstring
  Example
  961b521892e68f6c4d1c8459dfb530466eed
  Description
  [OPTIONAL] From Accertify UBA, the user's Session ID defined by you for the user's web browsing activity. Maximum field length = 250 characters.
- ubaSessionIDstring
  Example
  961b521892e68f6c4d1c8459dfb530466eed
  Description
  [OPTIONAL] From Accertify UBA, the user's Session ID defined by Accertify for the user's web browsing activity. Maximum field length = 50 characters.
- accountobject
  Description
  [OPTIONAL]
  - isEnrolledInLoyaltyProgramstring<true | false>
    Description
    [OPTIONAL] Whether the purchaser is enrolled in a loyalty program.
    Allowed
    truefalse
  - isMobileAppInstalledstring<true | false>
    Description
    [OPTIONAL] Whether the account has the mobile application installed somewhere, regardless if this event is from that mobile application.
    Allowed
    truefalse
  - accountLocalestring
    Example
    en-US
    Description
    [OPTIONAL] Native language expressed in UTF-8 encoding.
  - accountLevelstring
    Example
    Gold
    Description
    [OPTIONAL] Level of membership or account as defined by you.
  - accountTypestring<individual | business | family | other>
    Description
    [OPTIONAL] Type of membership or account.
    Allowed
    individualbusinessfamilyother
  - accountReferralCodestring
    Example
    [email protected]
    Description
    [OPTIONAL] Referral or promotion code tied to account creation.
  - accountRegistrationDateTimestring<date-time>
    Example
    2020-11-22T17:07:24-07:00
    Description
    [OPTIONAL] Date and time the account was created formatted in yyyy-MM-dd'T'HH:mm
    (RFC3339). This cannot be a future date.
    Format
    date-time
  - accountEmailUpdatedDateTimestring<date-time>
    Example
    2020-08-28T19:00:00-04:00
    Description
    [OPTIONAL] Date and time the member email was last updated formatted in yyyy-MM-dd'T'HH:mm
    (RFC3339). This cannot be a future date.
    Format
    date-time
  - accountEmailVerifiedDateTimestring<date-time>
    Example
    2020-08-28T19:00:00-04:00
    Description
    [OPTIONAL] Date and time the member email was last verified formatted in yyyy-MM-dd'T'HH:mm
    (RFC3339). This cannot be a future date.
    Format
    date-time
  - accountPasswordUpdatedDateTimestring<date-time>
    Example
    2020-02-22T17:07:24-07:00
    Description
    [OPTIONAL] Date and time the member password was last updated formatted in yyyy-MM-dd'T'HH:mm
    (RFC3339). This cannot be a future date.
    Format
    date-time
  - dateOfBirthstring
    Example
    1974-01-03
    Description
    [OPTIONAL] User's date of birth formatted YYYY-MM-DD.
  - totalCreditCardsOnFilestring
    Example
    3
    Description
    [OPTIONAL] Count of cards on file. Maximum field length = 10 characters.
  - totalInactiveCreditCardsOnFilestring
    Example
    1
    Description
    [OPTIONAL] Count of inactive cards on file. Maximum field length = 10 characters.
  - totalPurchasesstring
    Description
    [OPTIONAL] Lifetime number of purchases. Maximum field length = 10 characters.
  - totalRefundsstring
    Description
    [OPTIONAL] Lifetime number of refunds. Maximum field length = 10 characters.
  - totalOrdersAmountstring
    Description
    [OPTIONAL] Lifetime total order amount in the currency specified by the transaction currencyCode field. Format = two decimals.
  - loyaltyProgramNamestring
    Example
    Members Plus
    Description
    [OPTIONAL] Name of loyalty program governing points.
    
    Note: This is different than the accountLevel of a single loyalty program.
  - loyaltyNumberStartDateTimestring<date-time>
    Example
    2020-02-22T17:07:24-07:00
    Description
    [OPTIONAL] Date and time the loyalty account was opened formatted yyyy-MMdd'T'HH:mm
    (RFC3339). This cannot be a future date.
    Format
    date-time
  - loyaltyNumberLastUsedDateTimestring<date-time>
    Example
    2021-01-22T17:07:24-07:00
    Description
    [OPTIONAL] Date and time the loyalty account was last used formatted yyyy-MMdd'T'HH:mm
    (RFC3339). This cannot be a future date.
    Format
    date-time
  - loyaltyLastUsedPointsstring
    Example
    123
    Description
    [OPTIONAL] Points used on the last redemption in decimal numeric format. Maximum field length = 20 characters.
  - loyaltyPointsBalancestring
    Example
    987654321
    Description
    [OPTIONAL] Current points balance. Maximum field length = 20 characters.
  - loyaltyLastEarnedPointsstring
    Example
    1234
    Description
    [OPTIONAL] Points earned on the last earn event. Maximum field length = 20 characters.
  - loyaltyLastEarnedDateTimestring<date-time>
    Example
    2020-02-22T17:07:24-07:00
    Description
    [OPTIONAL] Date and time of last earn event formatted yyyy-MMdd'T'HH:mm
    (RFC3339). This cannot be a future date.
    Format
    date-time
  - loyaltyPromotionMessageTypestring<postalMail | email | smsText | none>
    Description
    [OPTIONAL] Preferred loyalty promo communications channel.
    Allowed
    postalMailemailsmsTextnone
- paymentobject
  Description
  [OPTIONAL]
  - cartIDstring
    Example
    Cart
    Description
    [OPTIONAL] Unique identifier you assign for this session. Maximum field length = 50 characters.
  - salesRepIDstring
    Example
    SR#46k90
    Description
    [OPTIONAL] Sales representative identifier when applicable. Maximum field length = 20 characters.
  - websiteURLstring
    Example
    www.google.com
    Description
    [OPTIONAL] Website that captured the transaction. Maximum length = 2048 characters.
  - referralCodestring
    Example
    CFB2020
    Description
    [OPTIONAL] Affiliate or campaign code used to reach the site. Maximum field length = 50 characters.
  - isGiftstring<true | false>
    Description
    [OPTIONAL] Indicates the order is a gift.
    Allowed
    truefalse
  - giftMessagestring
    Example
    Enjoy the gift
    Description
    [OPTIONAL] Freeform gift message. Maximum field length = 100 characters.
  - deliveryFeenumber
    Example
    2
    Description
    [OPTIONAL] Delivery fee amount in the currency specified by the transaction currencyCode field. Format = two decimals.
  - deliveryFeeTypestring<free | consumerPaid | subscription | other>
    Description
    [OPTIONAL] Type of delivery fee.
    Allowed
    freeconsumerPaidsubscriptionother
  - isPaymentInInstallmentsstring<true | false>
    Description
    [OPTIONAL] Whether the payment is split into installments.
    Allowed
    truefalse
  - isPaymentRecurringstring<true | false>
    Description
    [OPTIONAL] Whether the payment is part of a recurring schedule (e.g., subscription).
    Allowed
    truefalse
  - totalFailedTransactionsstring
    Example
    99
    Description
    [OPTIONAL] Count of times the transaction has failed for any reason. Maximum field length = 10 characters.
  - isTravelPackagePurchasedstring<true | false>
    Description
    [OPTIONAL] Whether a travel package was included in the purchase.
    Allowed
    truefalse
- itemsobject[]
  Description
  [OPTIONAL]
  - isUpsellstring<true | false>
    Description
    [OPTIONAL] Indicates if item was upsold.
    Allowed
    truefalse
  - itemTypestring<giftCard | parking | physicalGood | reservation | subscription | ticket | other>
    Description
    [OPTIONAL] Nature of item.
    Allowed
    giftCardparkingphysicalGoodreservationsubscriptionticketother
  - brandNamestring
    Example
    Apple
    Description
    [OPTIONAL] Item's brand name. Maximum field length = 20 characters.
  - categorystring
    Example
    Computer
    Description
    [OPTIONAL] Item category. Maximum field length = 100 characters.
  - descriptionstring
    Example
    Macbook Pro
    Description
    [OPTIONAL] Short description. Maximum field length = 40 characters.
  - itemIDstring
    Example
    SKU123
    Description
    [OPTIONAL] Item identifier, such as a SKU number, that you provide. Maximum field length = 20 characters.
  - pricenumber
    Example
    9.99
    Description
    [OPTIONAL] Item price. Format = two decimals.
  - faceValueAmountnumber
    Example
    19.99
    Description
    [OPTIONAL] Original cost of the transacted item. For some items, such as tickets, this could be more or less than the value in the price field. Format = two decimals.
  - quantitynumber
    Example
    3
    Description
    [OPTIONAL] Quantity (supports decimals). Maximum field length = 12 characters.
  - addressIDstring
    Example
    23kj423klj234j
    Description
    [OPTIONAL] Identifier you apply to addresses to differentiate orders with multiples. Maximum field length = 40 characters.
  - productConditionstring<new | openPackage | other | refurbished | used>
    Description
    [OPTIONAL] Condition of the product.
    Allowed
    newopenPackageotherrefurbishedused
  - shippingCompanystring<dhl | fedex | ups | usps | other>
    Description
    [OPTIONAL] Name of shipping company for merchant-to-consumer initial delivery.
    Allowed
    dhlfedexupsuspsother
  - shippingMethodstring<digital | ground | international | other | nextDay | sameDay | storePickup | twoDay | threeDay>
    Description
    [OPTIONAL] Shipping method.
    Allowed
    digitalgroundinternationalothernextDaysameDaystorePickuptwoDaythreeDay
  - shippingTrackingNumberstring
    Example
    23l4fdswerea02
    Description
    [OPTIONAL] Carrier tracking number. Maximum field length = 30 characters.
  - isLargeItemDeliverystring<true | false>
    Description
    [OPTIONAL] Whether delivery is for a large item.
    Allowed
    truefalse
  - promoCodestring
    Example
    ABC12
    Description
    [OPTIONAL] Line‑level promo code if applied here. Maximum field length = 100 characters.
  - promoAmountnumber
    Example
    5555
    Description
    [OPTIONAL] Promotion or discount amount applied in the currency specified by the transaction currencyCode field. Format = two decimals.
  - promoTypestring<bogo | bundle | employeeDiscount | freeShipping | loyaltyDiscount | newMemberDiscount | percentage | quantityPromotion | other>
    Description
    [OPTIONAL] Type of discount applied to this line item.
    Allowed
    bogobundleemployeeDiscountfreeShippingloyaltyDiscountnewMemberDiscountpercentagequantityPromotionother
  - pickupLocationstring<curbside | dropBox | inStore | other>
    Description
    [OPTIONAL] Type of pickup location when applicable.
    Allowed
    curbsidedropBoxinStoreother
  - pickupLocationDescriptionstring
    Example
    At the main entrance
    Description
    [OPTIONAL] Freeform description of pickup location. Maximum field length = 100 characters.
  - pickupPersonFirstNamePrimarystring
    Example
    Betty
    Description
    [OPTIONAL] Primary pickup person's first name. Maximum field length = 40 characters.
  - pickupPersonLastNamePrimarystring
    Example
    Smith
    Description
    [OPTIONAL] Primary pickup person's last name. Maximum field length = 40 characters.
  - pickupPersonFirstNameAlternatestring
    Example
    Mary
    Description
    [OPTIONAL] Alternate pickup person's first name. Maximum field length = 40 characters.
  - pickupPersonLastNameAlternatestring
    Example
    Jones
    Description
    [OPTIONAL] Alternate pickup person's last name. Maximum field length = 40 characters.
  - pickupVerificationMethodstring<idCard | signature | other>
    Description
    [OPTIONAL] Method used to verify pickup identity.
    Allowed
    idCardsignatureother
  - pickupDateTimestring<date-time>
    Example
    2021-03-02T17:07:24-07:00
    Description
    [OPTIONAL] Date and time the item was picked up (send as an update) formatted in yyyy-MMdd'T'HH:mm
    .
    Format
    date-time
  - pickupVerificationSignatureImagestring
    Description
    [OPTIONAL] Base64 signature image captured on pickup. Maximum field length = 4000 characters.
  - pickupVerificationIDCardImagestring
    Description
    [OPTIONAL] Base64 ID card image captured on pickup. Maximum field length = 4000 characters.
- addressesobject[]
  Description
  [OPTIONAL]
  - addressIDstring
    Example
    23kj423klj234j
    Description
    [OPTIONAL] Merchant-defined identifier to distinguish multiple addresses in one order. Maximum field length = 20 characters.
  - addressTypestring<account | billing | bopis | curbside | departure | destination | fulfillment | listing | lodging | pickup | return | shipping | venue | other>
    Description
    [OPTIONAL] Context for the address (billing, shipping, venue, and so forth).
    Allowed
    accountbillingbopiscurbsidedeparturedestinationfulfillmentlistinglodgingpickupreturnshippingvenueother
  - primaryFlagstring<true | false>
    Description
    [OPTIONAL] Whether this is the primary address of that type.
    Allowed
    truefalse
  - isAddressOnFilestring<true | false>
    Example
    Whether the shipping address is the same as the shipping address for this account.
    Description
    [OPTIONAL] Whether this address matches the address on file for that context.
    Allowed
    truefalse
  - firstNamestring
    Example
    Jane
    Description
    [OPTIONAL] Address owner's first name. Maximum field length = 40 characters.
  - middleNamestring
    Example
    Marie
    Description
    [OPTIONAL] Address owner's middle name. Maximum field length = 20 characters.
  - lastNamestring
    Example
    Doe
    Description
    [OPTIONAL] Address owner's last name. Maximum field length = 40 characters.
  - emailAddressstring
    Example
    [email protected]
    Description
    [OPTIONAL] Email associated with this user. Maximum field length = 100 characters.
  - phonestring
    Example
    2128387654
    Description
    [OPTIONAL] Phone number (no country prefix here). Maximum field length = 25 characters. If phoneCountryCode is not sent, we require valid format.
  - phoneCountryCodestring
    Example
    123
    Description
    [OPTIONAL] Country calling code for phone (omit '+').
  - address1string
    Example
    123 Main Street
    Description
    [OPTIONAL] Address line 1 for the account. Maximum field length = 40 characters.
  - address2string
    Example
    Apartment 456
    Description
    [OPTIONAL] Address line 2 for the account. Maximum field length = 40 characters.
  - citystring
    Example
    Itasca
    Description
    [OPTIONAL] Address city. Maximum field length = 40 characters.
  - regionstring
    Example
    IL
    Description
    [OPTIONAL] ISO 3166-2 state, province, or region code. Minimum field length = 1 character. Maximum field length = 3 characters.
  - postCodestring
    Example
    60143-0001
    Description
    [OPTIONAL] Address postal code. Maximum field length = 20 characters. (US ZIP+4 requires hyphen).
  - countrystring
    Example
    US
    Description
    [OPTIONAL] Two-letter ISO code for country formatted in ISO 3166-1.
  - companyNamestring
    Example
    Accertify, Inc
    Description
    [OPTIONAL] Company name associated with the address. Maximum field length = 50 characters.
  - locationTypestring<business | redirect | residence | siteToStore | other>
    Description
    [OPTIONAL] Residence or business type.
    Allowed
    businessredirectresidencesiteToStoreother
  - addressCreatedDateTimestring<date-time>
    Example
    2020-03-28T17:07:24-07:00
    Description
    [OPTIONAL] When address was created formatted yyyy-MM-dd'T'HH:mm
    .
    Format
    date-time
  - addressUpdatedDateTimestring<date-time>
    Example
    2021-03-28T17:07:24-07:00
    Description
    [OPTIONAL] When address was last updated formatted yyyy-MM-dd'T'HH:mm
    .
    Format
    date-time
- paymentMethodsobject[]
  Description
  [OPTIONAL]
  - paymentTypestring<bankAccount | cash | check | creditCard | cryptoCurrency | digitalWallet | electronicFundTransfer | giftCard | invoice | loan | loyaltyPoints | moneyOrder | secCard | storeCredit | thirdParty | voucher>required
    Description
    [REQUIRED] User's tender type (ACH in bankAccount; EFT in electronicFundTransfer).
    Allowed
    bankAccountcashcheckcreditCardcryptoCurrencydigitalWalletelectronicFundTransfergiftCardinvoiceloanloyaltyPointsmoneyOrdersecCardstoreCreditthirdPartyvoucher
  - paymentMethodIDstring
    Example
    2ljr9vxsdfey
    Description
    [OPTIONAL] Unique identifier for the payment method (not a card number). Maximum field length = 100 characters.
  - paymentMethodAmountnumber
    Example
    500
    Description
    [OPTIONAL] Amount applied to this method (transaction currency). Format = two decimals.
    
    Note: Payment amounts can be spread across several payment types in this array.
  - isPaymentStoredOnFilestring<true | false>
    Description
    [OPTIONAL] Indicates if method was stored on file.
    Allowed
    truefalse
  - emailAddressstring
    Example
    [email protected]
    Description
    [OPTIONAL] Email associated with the payment. Maximum field length = 50 characters.
  - nameOnAccountstring
    Example
    Jane Doe
    Description
    [OPTIONAL] Name on the account when you are sending payment. Maximum field length = 100 characters.
  - accountTypestring<checking | saving | moneyMarket | other>
    Description
    [OPTIONAL] Account type when paymentType=bankAccount.
    Allowed
    checkingsavingmoneyMarketother
  - cardNumberstring
    Example
    5555555555554444
    Description
    [OPTIONAL] Primary account number for creditCard. Data must pass ISO/IEC 7812-1 LUHN validation. Minimum field length = 10 characters. Maximum field length = 19 characters.
  - cardTokenstring
    Example
    6f7%gf38hfUa
    Description
    [IMPERATIVE] Tokenized card number for creditCard.
  - expirationMonthstring
    Example
    11
    Description
    [IMPERATIVE] Expiry month (MM) for cards/vouchers/points where applicable. Maximum field length = 2 characters.
  - expirationYearstring
    Example
    2026
    Description
    [IMPERATIVE] Expiry year (YYYY) for cards/vouchers/points where applicable. Maximum field length = 4 characters.
  - expirationDaystring
    Example
    12
    Description
    [IMPERATIVE] Expiry day (DD) for vouchers/points when used. Maximum field length = 10 characters.
  - nameOnCreditCardstring
    Example
    Jane Doe
    Description
    [IMPERATIVE] Cardholder name (creditCard/giftCard). Maximum field length = 100 characters.
  - cardBininteger
    Example
    345678
    Description
    [IMPERATIVE] Leading 6–11 digits of the credit card number (numeric only). Minimum field length = 6 digits. Maximum field length = 11 digits. For BIN lookups, Accertify will query the full/encrypted Payment Card Number (PAN).
  - cardLastFourstring
    Example
    4444
    Description
    [IMPERATIVE] Last four digits (numeric only). Must be 4 characters.
  - avsResultstring<matched | partialMatch | notMatched | notChecked | systemError | other>
    Description
    [IMPERATIVE] Issuer AVS result.
    Allowed
    matchedpartialMatchnotMatchednotCheckedsystemErrorother
  - cvvResultstring<matched | notMatched>
    Description
    [IMPERATIVE] Issuer CVV result.
    Allowed
    matchednotMatched
  - cardAuthorizationCodestring
    Example
    100
    Description
    [OPTIONAL] Payment card authorization code when available. Maximum field length = 20 characters.
  - cardAuthorizationDateTimestring<date-time>
    Example
    2010-02-15T17:07:24-07:00
    Description
    [OPTIONAL] Payment card authorization date in formatted yyyy-MM-dd'T'HH:mm
    .
    Format
    date-time
  - isPre-AuthorizationRejectstring<true | false>
    Description
    [OPTIONAL] Whether pre-authorization rejected the payment.
    Allowed
    truefalse
  - post-AuthorizationRejectReasonstring<creditReject | fraudReject | otherReject>
    Description
    [OPTIONAL] Reason for post-authorization reject.
    Allowed
    creditRejectfraudRejectotherReject
  - eciIndicatorstring<successful | unsuccessfulOrNotAttempted | attemptedButNotCompleted | other>
    Description
    [OPTIONAL] ECI status from card brand.
    Allowed
    successfulunsuccessfulOrNotAttemptedattemptedButNotCompletedother
  - totalFailedAttemptsnumber
    Example
    88
    Description
    [OPTIONAL] Number of failed attempts on this method. Maximum field length = 100 characters.
  - paymentMethodCreatedDateTimestring<date-time>
    Example
    2020-03-28T17:07:24-07:00
    Description
    [OPTIONAL] Payment method creation date formatted yyyy-MM-dd'T'HH:mm
    .
    Format
    date-time
  - paymentMethodUpdatedDateTimestring<date-time>
    Example
    2021-03-28T17:07:24-07:00
    Description
    [OPTIONAL] Payment method update date formatted yyyy-MM-dd'T'HH:mm
    .
    Format
    date-time
  - giftCardNumberstring
    Example
    a789sdf8asdfasd89f789asd78
    Description
    [OPTIONAL] Gift card number or account for this payment method. Maximum field length = 100 characters.
    
    Note: Shown hashed. We provide the Accertify Hashing Algorithm. If the value appears to be in plain text, we respond "400 Bad Request" with the appropriate errorResponse.
  - giftCardLastFourstring
    Example
    1111
    Description
    [OPTIONAL] Last four digits of gift card. Must be 4 characters.
  - giftCardBINstring
    Example
    4111
    Description
    [OPTIONAL] BIN number on the gift card or account for this payment method. Minimum field length = 6 characters.
  - paymentMethodBalanceAmountnumber
    Example
    4000
    Description
    [OPTIONAL] Monetary amount left on the card or account at the time of the request. Format = two decimals.
  - pointsinteger
    Example
    50000
    Description
    [OPTIONAL] Number of points being redeemed. Maximum field length = 100 digits. Note: Numbers only. This could be miles, points, units, or however you refer to the points.
  - loyaltyProgramNamestring
    Example
    Acme Platinum
    Description
    [OPTIONAL] Name of the program governing the points or loyalty program. Maximum field length = 100 characters.
  - walletTypestring
    Example
    Venmo, Google Pay, PayPal
    Description
    [OPTIONAL] Type of wallet with which the user paid. Maximum field length = 100 characters.
  - walletStatusstring<active | pending | inactive>
    Description
    [OPTIONAL] Wallet account status.
    Allowed
    activependinginactive
  - isWalletProtectionEligiblestring<true | false>
    Description
    [OPTIONAL] Whether the wallet is eligible for wallet protection.
    Allowed
    truefalse
- promotionsobject[]
  Description
  [OPTIONAL]
  - promoCodestring
    Example
    ABC12
    Description
    [OPTIONAL] Promotion or discount used. Maximum field length = 40 characters.
  - promoAmountnumber
    Example
    5555
    Description
    [OPTIONAL] Promotion or discount amount applied in the currency specified by the transaction currencyCode field. Format = two decimals.
  - promoTypestring<bogo | bundle | employeeDiscount | freeShipping | loyaltyDiscount | newMemberDiscount | percentage | quantityPromotion | other>
    Description
    [OPTIONAL] The type of discount code used.
    Allowed
    bogobundleemployeeDiscountfreeShippingloyaltyDiscountnewMemberDiscountpercentagequantityPromotionother
- flightInformationobject
  Description
  [OPTIONAL]
  - pnrstringrequired
    Example
    ABC123
    Description
    [REQUIRED] Passenger Name Record. Maximum field length = 50 characters.
  - flightTypestring<multi-city | one-way | round-trip>required
    Example
    multi-city
    Description
    [REQUIRED] Type of ticket purchased.
    Allowed
    multi-cityone-wayround-trip
  - isThirdPartyBookingstring<true | false>
    Description
    [OPTIONAL] Indicates if booked through a third-party/OTA.
    Allowed
    truefalse
  - fareBasisCodestring
    Example
    2E7N
    Description
    [OPTIONAL] The alpha-numeric code used by airlines to identify the fare type. Maximum field length = 30 characters.
  - otaIdentificationNumberstring
    Example
    ABC123
    Description
    [OPTIONAL] OTA ID number. Required if isThirdPartyBooking is true. Maximum field length = 20 characters.
  - otaNamestring
    Example
    Best Travel Agency
    Description
    [OPTIONAL] Third-party agency name corresponding to the OTA ID. Required if otaIdentificationNumber exists. Maximum field length = 50 characters.
  - initialDepartingAirportstring
    Example
    ORD
    Description
    [OPTIONAL] IATA airport code where itinerary originates. Required if pnr exists.
  - finalArrivalAirportstring
    Example
    MIA
    Description
    [OPTIONAL] IATA airport code for the itinerary's final destination. Required if pnr exists.
  - segmentsobject[]required
    Description
    [REQUIRED] Flight segments in the itinerary.
    - routeInfostring
      Example
      ORDMIA1232014-08-30T17:07:24-05:00
      Description
      [REQUIRED] Coded description of the flight details, including departure and arrival airports as the first six characters. Required if pnr exists. Maximum field length = 100 characters.
    - airlineNamestring
      Example
      Primary Airlines Ltd
      Description
      [REQUIRED] Marketing airline name for this segment. Required if pnr exists. Maximum field length = 40 characters.
    - operatingAirlinestring
      Example
      Actual Carrier Air Inc.
      Description
      [REQUIRED] Operating carrier in codeshare scenarios. Required if pnr exists. Maximum field length = 40 characters.
    - flightNumberstring
      Example
      123
      Description
      [OPTIONAL] Flight number. Maximum field length = 10 characters.
    - ticketClassstring<business | economy | first | premium>
      Example
      economy
      Description
      [REQUIRED] Ticket cabin class.
      Allowed
      businesseconomyfirstpremium
    - fareClassstring
      Example
      Y
      Description
      [REQUIRED] First letter of fare basis code. Required if pnr exists. Maximum field length = 30 characters.
    - specialFareTypestring<bereavement | corporate | employee | infant | military | senior | student | unaccompaniedMinor | other>
      Example
      bereavement
      Description
      [OPTIONAL] Special fare type when applicable.
      Allowed
      bereavementcorporateemployeeinfantmilitaryseniorstudentunaccompaniedMinorother
    - isAwardTicketstring<true | false>
      Example
      true
      Description
      [REQUIRED] Indicates award redemption ticket.
      Allowed
      truefalse
    - departureDateTimestring<date-time>
      Example
      2022-03-28T17:07:24-07:00
      Description
      [REQUIRED] Required if pnr exists. The departure date and time formatted yyyy-MM-dd'T'HH:mm
      .
      Format
      date-time
    - departureAirportCodestring
      Example
      ORD
      Description
      [REQUIRED] IATA code for departure airport. Required if pnr exists.
    - arrivalDateTimestring<date-time>
      Example
      2022-03-28T17:07:24-07:00
      Description
      [REQUIRED] Required if pnr exists. The arrival date and time formatted yyyy-MM-dd'T'HH:mm
      .
      Format
      date-time
    - arrivalAirportCodestring
      Example
      ORD
      Description
      [REQUIRED] IATA code for arrival airport. Required if pnr exists.
    - isFinalDestinationstring<true | false>
      Example
      true
      Description
      [REQUIRED] Indicates which segment array's Arrival Airport is the final destination for the PNR. Must be set to True in one and only one segment array and set to False in all other segment arrays. Set to True for the last segment of a one-way ticket.
      Allowed
      truefalse
  - passengersobject[]required
    Description
    [REQUIRED] Passenger details for the itinerary.
    - passengerIDstring
      Example
      998fsd72234
      Description
      [OPTIONAL] Passenger's unique identifier you assigned. Maximum field length = 40 characters.
    - ticketNumberstring
      Example
      ABC123
      Description
      [REQUIRED] Required if flightNumber exists. Maximum field length = 30 characters.
    - passengerDateOfBirthstring
      Example
      1985-01-24
      Description
      [OPTIONAL] Passenger date of birth in YYYY-MM-DD.
    - passengerGenderstring<F | M | U | O>
      Example
      M
      Description
      [OPTIONAL] Passenger gender. Options are:
      
      F: Female
      
      M: Male
      
      U: Undisclosed
      
      O: Other
      Allowed
      FMUO
    - passengerAdultOrChildstring<adult | child | infant>
      Example
      adult
      Description
      [OPTIONAL] Age classification.
      Allowed
      adultchildinfant
    - passengerTitlestring
      Example
      Mr
      Description
      [OPTIONAL] Honorific preceding the passenger name. Maximum field length = 10 characters. (Mr/Ms/etc.).
    - passengerFirstNamestring
      Example
      John
      Description
      [REQUIRED] Passenger first name (required if flightNumber exists). Maximum field length = 40 characters.
    - passengerMiddleNamestring
      Example
      Peter
      Description
      [OPTIONAL] Passenger middle name. Maximum field length = 20 characters.
    - passengerLastNamestring
      Example
      Smith
      Description
      [REQUIRED] Passenger last name (required if flightNumber exists). Maximum field length = 40 characters.
    - passengerPhonenumber<integer>
      Example
      3125555555
      Description
      [OPTIONAL] Passenger phone number (no country prefix). Maximum field length = 25 characters.
      Format
      integer
    - passengerPhoneCountryCodenumber
      Example
      10
      Description
      [OPTIONAL] Country code; required if passengerPhone is provided (omit '+').
    - passengerEmailAddressstring
      Example
      [email protected]
      Description
      [OPTIONAL] Passenger email address.
    - passengerCheckedBaggageCountnumber
      Example
      2
      Description
      [OPTIONAL] Number of checked bags. Maximum field length = 10 characters.
    - passengerLoyaltyNumberstring
      Example
      LL123456
      Description
      [OPTIONAL] Passenger loyalty membership number. Maximum field length = 40 characters.
    - passengerLoyaltySinceDatestring
      Example
      2000-01-18
      Description
      [OPTIONAL] Membership start date.
    - passengerLoyaltyLevelstring
      Example
      Gold
      Description
      [OPTIONAL] Membership tier/level. Maximum field length = 20 characters.
    - passengerPassportNumberstring
      Example
      P7475664383454343
      Description
      [OPTIONAL] Passport number when applicable. Maximum field length = 40 characters.
    - passengerPassportCountryCodestring
      Example
      US
      Description
      [OPTIONAL] Required if passengerPassportNumber exists. Two-letter passport country (ISO 3166-1); required if passport number is sent.
    - passengerPassportExpirationDatestring
      Example
      2015-01-24
      Description
      [OPTIONAL] Passport expiration date (required with passport number).

Responses

200Success response

successResponse
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
- transaction-resultsobject
  Description
  A block indicating the results of your successful call.
  - transaction-idstring
    Description
    Transaction's unique identifier. Typically, this is your order number.
    
    Note: This is the transactionID field.
  - cross-referencestring
    Description
    Unique identifier Accertify assigns to this transaction. It is a cross reference to the transactionID field.
  - rules-trippedstring
    Description
    Identifier, description, and score of the rules that tripped on this transaction.
    
    Example: 5237260000001628419
    Between IP Postal Code and Billing Postal Code Greater Than 1000
    Where:
    
    Identifier: 5237260000001628419
    
    Description: apir_Distance Between IP Postal Code and Billing Postal Code Greater Than 1000
    
    Score: 500
  - total-scoreinteger
    Description
    The accumulated fraud score of this transaction.
  - recommendation-codestring<ACCEPT | REJECT | REVIEW | ACCEPT_POLICY | REJECT_POLICY | REVIEW_POLICY>
    Description
    Our transaction recommendation.
    
    ACCEPT
    
    REJECT
    
    REVIEW
    
    ACCEPT_POLICY
    
    REJECT_POLICY
    
    REVIEW_POLICY
    Allowed
    ACCEPTREJECTREVIEWACCEPT_POLICYREJECT_POLICYREVIEW_POLICY
  - remarksstring
    Description
    Details left by an analyst if they resolve the transaction.
    
    Example: AT: 5/5/21 1:04
    PM CDT
- validation_responseobject
  - warningsmap<string, string>
    Description
    Map of field names and warning messages that may impair fraud scoring if not resolved.
  - originalValuesmap<string, string>
    Description
    Map of field names and input values present when warnings or errors are reported. The values here should be fixed to validate.
  - statusstring<true | false>
    Description
    Whether the validation has errors.
    
    Options are:
    
    true when there are no errors.
    
    false when there are errors.
    Allowed
    truefalse

400Error response

errorResponse
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
- validation_responseobject
  - errorsmap<string, string>
    Description
    Map of field names and error messages that have prevented processing of the transaction.
  - warningsmap<string, string>
    Description
    Map of field names and warning messages that may impair fraud scoring if not resolved.
  - originalValuesmap<string, string>
    Description
    Map of field names and input values present when warnings or errors are reported. The values here should be fixed to validate.
  - statusstring<true | false>
    Description
    Whether the validation has errors.
    
    Options are:
    
    true when there are no errors.
    
    false when there are errors.
    Allowed
    truefalse

500

curl

curl --request POST \
     --url https://rtd01.eu.accertify.net/icNowImport/{importerID} \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "transactionID": "ABC123456",
     "transactionType": "preAuthorization",
     "transactionDateTime": "2022-03-11T17:07:24-07:00",
     "paymentAmount": 1082.91,
     "currencyCode": "USD",
     "success": "",
     "purchaseType": "",
     "eventSource": "",
     "paymentMethods": [
     {
     "paymentType": ""
     }
     ],
     "flightInformation": {
     "pnr": "ABC123",
     "flightType": "multi-city",
     "segments": [
     {}
     ],
     "passengers": [
     {}
     ]
     }
     }'

javascript

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

var raw = JSON.stringify({
   "transactionID": "ABC123456",
   "transactionType": "preAuthorization",
   "transactionDateTime": "2022-03-11T17:07:24-07:00",
   "paymentAmount": 1082.91,
   "currencyCode": "USD",
   "success": "",
   "purchaseType": "",
   "eventSource": "",
   "paymentMethods": [
      {
         "paymentType": ""
      }
   ],
   "flightInformation": {
      "pnr": "ABC123",
      "flightType": "multi-city",
      "segments": [
         {}
      ],
      "passengers": [
         {}
      ]
   }
});

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

fetch("https://rtd01.eu.accertify.net/icNowImport/{importerID}", 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://rtd01.eu.accertify.net/icNowImport/{importerID}")

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",
   "transactionType": "preAuthorization",
   "transactionDateTime": "2022-03-11T17:07:24-07:00",
   "paymentAmount": 1082.91,
   "currencyCode": "USD",
   "success": "",
   "purchaseType": "",
   "eventSource": "",
   "paymentMethods": [
      {
         "paymentType": ""
      }
   ],
   "flightInformation": {
      "pnr": "ABC123",
      "flightType": "multi-city",
      "segments": [
         {}
      ],
      "passengers": [
         {}
      ]
   }
})

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

python

import requests
import json

url = "https://rtd01.eu.accertify.net/icNowImport/{importerID}"

payload = json.dumps({
   "transactionID": "ABC123456",
   "transactionType": "preAuthorization",
   "transactionDateTime": "2022-03-11T17:07:24-07:00",
   "paymentAmount": 1082.91,
   "currencyCode": "USD",
   "success": "",
   "purchaseType": "",
   "eventSource": "",
   "paymentMethods": [
      {
         "paymentType": ""
      }
   ],
   "flightInformation": {
      "pnr": "ABC123",
      "flightType": "multi-city",
      "segments": [
         {}
      ],
      "passengers": [
         {}
      ]
   }
})
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

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

print(response.text)

200

// Success response
{
  "transaction-results": {
    "transaction-id": "",
    "cross-reference": "",
    "rules-tripped": "",
    "total-score": 0,
    "recommendation-code": "",
    "remarks": ""
  },
  "validation_response": {
    "warnings": "",
    "originalValues": "",
    "status": ""
  }
}

400

// Error response
{
  "validation_response": {
    "errors": "",
    "warnings": "",
    "originalValues": "",
    "status": ""
  }
}

500