Scores a post-authorization iGaming transaction and returns device and connection signals.
", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "name": "accept", "type": "string", "kind": "optional", "description": "Generated from available response content types", "enum": [ "application/json" ], "default": "application/json" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "required", "name": "postAuth", "type": "object", "example": "{\"transactionID\":\"IGM-12345678\",\"transactionDateTime\":\"2022-06-10T14:30:00-05:00\",\"eventSource\":\"web\",\"accountID\":\"98712345678\",\"isGuestCheckout\":false,\"paymentAmount\":500,\"deliveryAmount\":0,\"success\":true,\"ipAddress\":\"10.12.12.123\",\"emailAddress\":\"a@example.com\",\"authenticationMethod\":\"password\",\"brand\":\"acme\",\"phoneNumber\":\"3125555555\",\"latitude\":41.878,\"longitude\":-87.629,\"accountStatus\":\"active\",\"firstName\":\"Jane\",\"middleName\":\"Marie\",\"lastName\":\"Doe\",\"purchaseType\":\"services\",\"listingID\":\"abcd1234\",\"isPaymentOptimization\":false,\"account\":{\"isEnrolledInLoyaltyProgram\":true,\"loyaltyNumber\":\"Id1234\",\"accountLocale\":\"en-US\",\"accountLevel\":\"Gold\",\"accountType\":\"individual\",\"loyaltyProgramName\":\"Members Plus\",\"loyaltyPointsBalance\":987654321},\"payment\":{\"isGift\":false,\"orderMessage\":\"Enjoy the gift\",\"isPaymentInInstallments\":false,\"isPaymentRecurring\":false},\"addresses\":[{\"addressType\":\"billing\",\"addressID\":\"23l4jk23klj23\",\"primaryFlag\":true,\"isAddressOnFile\":true,\"firstName\":\"Jane\",\"middleName\":\"Marie\",\"lastName\":\"Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"phone\":\"3125555555\",\"phoneCountryCode\":\"001\",\"address1\":\"1863 Main Street\",\"address2\":\"Apt 7\",\"city\":\"Chicago\",\"region\":\"IL\",\"postCode\":\"60601\",\"country\":\"US\"}],\"paymentMethods\":[{\"paymentType\":\"creditCard\",\"paymentMethodID\":\"2ljr9vxsdfew\",\"paymentMethodAmount\":500,\"isPaymentStoredOnFile\":true,\"cardToken\":\"6f7%gf38hfUa\",\"expirationMonth\":\"11\",\"expirationYear\":\"2027\",\"nameOnCreditCard\":\"Jane Doe\",\"cardBin\":\"345678\",\"cardLastFour\":\"1111\",\"totalFailedAttempts\":0,\"addressID\":\"23kl4l32l\",\"avsResult\":\"matched\",\"cvvResult\":\"matched\",\"cardAuthorizationCode\":\"12345\",\"cardAuthorizationDateTime\":\"2022-06-10T14:30:05-05:00\",\"sca3DSFlow\":\"frictionless\",\"sca3DSVersion\":\"2.2.0\",\"sca3DSChallengeRequestType\":\"02\",\"sca3DSTransactionStatus\":\"Y\",\"scaAuthorizationStatus\":\"approve\",\"eciIndicator\":\"successful\",\"isSCASoftDecline\":false}],\"memberStats\":{\"wagersLast7Days\":42,\"wagersAmountLast7Days\":850,\"wagersWonLast7Days\":18,\"averageWager7Days\":25.5,\"houseLimit\":5000},\"withdrawal\":{\"withdrawalID\":\"WD1234567\",\"withdrawalDateTime\":\"2022-06-10T14:28:00-05:00\",\"withdrawalTotalAmount\":250,\"taxAmount\":0,\"currencyCode\":\"USD\"}}", "description": "Top-level scalar fields shared by iGaming preAuth and postAuth. Tax and currency values are carried inside deposit or withdrawal. iGaming-specific top-level deposit, withdrawal, and member-statistics data.
", "schema": [ { "name": "transactionID", "kind": "required", "type": "string", "description": "[Required] Unique transaction identifier (max 40 chars).
", "example": "IGM-12345678", "maxLength": 40 }, { "name": "transactionDateTime", "kind": "required", "type": "string[Required] ISO 8601 timestamp of when the transaction occurred.
", "example": "2022-06-10T14:30:00-05:00", "format": "date-time" }, { "name": "eventSource", "kind": "required", "type": "string[Required] Originating channel.
", "example": "web", "enum": [ "agentPhone", "agentStore", "affiliate", "kiosk", "mobileApp", "other", "web" ] }, { "name": "accountID", "kind": "optional", "type": "string", "description": "[Conditional] Merchant internal account identifier; required when isGuestCheckout is false.
", "example": "98712345678" }, { "name": "isGuestCheckout", "kind": "required", "type": "boolean", "description": "[Required] Whether the customer checked out without an account.
", "example": false }, { "name": "isAgenticCheckout", "kind": "optional", "type": "boolean", "description": "[Optional] String \"true\"/\"false\" also accepted.
", "example": false }, { "name": "paymentAmount", "kind": "required", "type": "number", "description": "[Required] Total payment amount; zero or positive.
", "example": 500, "minimum": 0 }, { "name": "deliveryAmount", "kind": "required", "type": "number", "description": "[Required] Delivery amount; zero or positive.
", "example": 0, "minimum": 0 }, { "name": "success", "kind": "required", "type": "boolean", "description": "[Required] Outcome of the transaction attempt.
", "example": true }, { "name": "ipAddress", "kind": "optional", "type": "string", "description": "[Conditional] Client IP address; required for mobileApp or web.
", "example": "10.12.12.123" }, { "name": "userAgent", "kind": "optional", "type": "string", "description": "[Conditional] Browser User-Agent; required when eventSource is web.
", "example": "Mozilla/5.0", "maxLength": 250 }, { "name": "deviceTransactionID", "kind": "optional", "type": "string", "description": "[Optional] Device session token.
", "example": "e1a1aade06e2557f34036eeb06173faf1fa05c64959383" }, { "name": "devicePayload", "kind": "optional", "type": "string", "description": "[Optional] Device fingerprint payload.
", "example": "afklasdjlasdjl3l23j23423klj" }, { "name": "ubaID", "kind": "optional", "type": "string", "description": "[Optional] UBA session ID.
", "example": "3143e969395de649c48c1c9f3e363a3e7ae7", "maxLength": 100 }, { "name": "ubaEvents", "kind": "optional", "type": "string", "description": "[Optional] Serialized UBA events.
", "example": "lasjdlkfdsljelkrrjwl3kl324j32k432" }, { "name": "emailAddress", "kind": "required", "type": "string", "description": "[Required] Customer email address.
", "example": "a@example.com" }, { "name": "authenticationMethod", "kind": "optional", "type": "string[Optional] Customer authentication method.
", "example": "password", "enum": [ "appAuthenticator", "appPush", "other", "password", "passkey", "magicLink", "SMS" ] }, { "name": "failureCode", "kind": "optional", "type": "string[Conditional] Required when success is false.
", "example": "authFailed", "enum": [ "authFailed", "exportCompliance", "other" ] }, { "name": "brand", "kind": "optional", "type": "string", "description": "[Optional] Merchant sub-brand.
", "example": "acme", "maxLength": 50 }, { "name": "phoneNumber", "kind": "optional", "type": "string", "description": "[Optional] Customer billing phone.
", "example": "3125555555", "maxLength": 25 }, { "name": "latitude", "kind": "optional", "type": "number", "description": "[Optional] Transaction latitude.
", "example": 41.878 }, { "name": "longitude", "kind": "optional", "type": "number", "description": "[Optional] Transaction longitude.
", "example": -87.629 }, { "name": "accountStatus", "kind": "optional", "type": "string[Optional] Current account status.
", "example": "active", "enum": [ "active", "dormant", "suspended", "terminated", "trial", "other" ] }, { "name": "firstName", "kind": "optional", "type": "string", "description": "[Optional] Customer billing first name.
", "example": "Jane" }, { "name": "middleName", "kind": "optional", "type": "string", "description": "[Optional] Customer billing middle name.
", "example": "Marie" }, { "name": "lastName", "kind": "optional", "type": "string", "description": "[Optional] Customer billing last name.
", "example": "Doe" }, { "name": "purchaseType", "kind": "required", "type": "string[Required] Nature of the purchase.
", "example": "services", "enum": [ "physicalItems", "digitalItems", "services", "other" ] }, { "name": "listingID", "kind": "optional", "type": "string", "description": "[Optional] Marketplace listing identifier.
", "example": "abcd1234", "maxLength": 50 }, { "name": "isPaymentOptimization", "kind": "optional", "type": "boolean", "description": "[Optional] Whether payment optimization is enabled.
", "example": false }, { "name": "deposit", "kind": "optional", "type": "object", "description": "Deposit details. Send either deposit or withdrawal, never both.
", "example": "", "schema": [ { "name": "depositID", "kind": "optional", "type": "string", "description": "[Optional] Deposit identifier.
", "example": "DEP1234567" }, { "name": "depositDateTime", "kind": "optional", "type": "string[Conditional] Required when depositID is present.
", "example": "2022-03-11T17:07:24-07:00", "format": "date-time" }, { "name": "depositTotalAmount", "kind": "optional", "type": "number", "description": "[Conditional] Total deposited amount.
", "example": 500, "minimum": 0 }, { "name": "taxAmount", "kind": "optional", "type": "number", "description": "[Conditional] Deposit tax amount.
", "example": 0, "minimum": 0 }, { "name": "currencyCode", "kind": "optional", "type": "string", "description": "[Conditional] Deposit currency code.
", "example": "USD" }, { "name": "salesRepID", "kind": "optional", "type": "string", "description": "[Optional] Sales representative identifier.
", "example": "SR#46k90" }, { "name": "referralCode", "kind": "optional", "type": "string", "description": "[Optional] Referral code.
", "example": "API 210315" } ] }, { "name": "withdrawal", "kind": "optional", "type": "object", "description": "Withdrawal details. Send either deposit or withdrawal, never both.
", "example": "{\"withdrawalID\":\"WD1234567\",\"withdrawalDateTime\":\"2022-06-10T14:28:00-05:00\",\"withdrawalTotalAmount\":250,\"taxAmount\":0,\"currencyCode\":\"USD\"}", "schema": [ { "name": "withdrawalID", "kind": "optional", "type": "string", "description": "[Optional] Withdrawal identifier.
", "example": "WD1234567" }, { "name": "withdrawalDateTime", "kind": "optional", "type": "string[Conditional] Required when withdrawalID is present.
", "example": "2022-06-10T14:28:00-05:00", "format": "date-time" }, { "name": "withdrawalTotalAmount", "kind": "optional", "type": "number", "description": "[Conditional] Total withdrawn amount.
", "example": 250, "minimum": 0 }, { "name": "taxAmount", "kind": "optional", "type": "number", "description": "[Conditional] Withdrawal tax amount.
", "example": 0, "minimum": 0 }, { "name": "currencyCode", "kind": "optional", "type": "string", "description": "[Conditional] Withdrawal currency code.
", "example": "USD" } ] }, { "name": "memberStats", "kind": "optional", "type": "object", "description": "Rolling-window wagering statistics for the member account.
", "example": "{\"wagersLast7Days\":42,\"wagersAmountLast7Days\":850,\"wagersWonLast7Days\":18,\"averageWager7Days\":25.5,\"houseLimit\":5000}", "schema": [ { "name": "wagersLastDay", "kind": "optional", "type": "integer", "description": "[Optional] Number of wagers over the last day.
", "example": 42, "minimum": 0 }, { "name": "wagersAmountLastDay", "kind": "optional", "type": "number", "description": "[Optional] Total amount wagered over the last day.
", "example": 850, "minimum": 0 }, { "name": "wagersWonLastDay", "kind": "optional", "type": "integer", "description": "[Optional] Number of wagers won over the last day.
", "example": 18, "minimum": 0 }, { "name": "wagersAmountWonLastDay", "kind": "optional", "type": "number", "description": "[Optional] Total amount won over the last day.
", "example": 1200, "minimum": 0 }, { "name": "averageOddsLastDay", "kind": "optional", "type": "number", "description": "[Optional] Average odds over the last day.
", "example": 2.15, "minimum": 0 }, { "name": "wagersLast7Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of wagers over the last 7 days.
", "example": 42, "minimum": 0 }, { "name": "wagersAmountLast7Days", "kind": "optional", "type": "number", "description": "[Optional] Total amount wagered over the last 7 days.
", "example": 850, "minimum": 0 }, { "name": "wagersWonLast7Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of wagers won over the last 7 days.
", "example": 18, "minimum": 0 }, { "name": "wagersAmountWonLast7Days", "kind": "optional", "type": "number", "description": "[Optional] Total amount won over the last 7 days.
", "example": 1200, "minimum": 0 }, { "name": "averageOddsLast7Days", "kind": "optional", "type": "number", "description": "[Optional] Average odds over the last 7 days.
", "example": 2.15, "minimum": 0 }, { "name": "wagersLast30Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of wagers over the last 30 days.
", "example": 42, "minimum": 0 }, { "name": "wagersAmountLast30Days", "kind": "optional", "type": "number", "description": "[Optional] Total amount wagered over the last 30 days.
", "example": 850, "minimum": 0 }, { "name": "wagersWonLast30Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of wagers won over the last 30 days.
", "example": 18, "minimum": 0 }, { "name": "wagersAmountWonLast30Days", "kind": "optional", "type": "number", "description": "[Optional] Total amount won over the last 30 days.
", "example": 1200, "minimum": 0 }, { "name": "averageOddsLast30Days", "kind": "optional", "type": "number", "description": "[Optional] Average odds over the last 30 days.
", "example": 2.15, "minimum": 0 }, { "name": "wagersLast90Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of wagers over the last 90 days.
", "example": 42, "minimum": 0 }, { "name": "wagersAmountLast90Days", "kind": "optional", "type": "number", "description": "[Optional] Total amount wagered over the last 90 days.
", "example": 850, "minimum": 0 }, { "name": "wagersWonLast90Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of wagers won over the last 90 days.
", "example": 18, "minimum": 0 }, { "name": "wagersAmountWonLast90Days", "kind": "optional", "type": "number", "description": "[Optional] Total amount won over the last 90 days.
", "example": 1200, "minimum": 0 }, { "name": "averageOddsLast90Days", "kind": "optional", "type": "number", "description": "[Optional] Average odds over the last 90 days.
", "example": 2.15, "minimum": 0 }, { "name": "wagersLast365Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of wagers over the last 365 days.
", "example": 42, "minimum": 0 }, { "name": "wagersAmountLast365Days", "kind": "optional", "type": "number", "description": "[Optional] Total amount wagered over the last 365 days.
", "example": 850, "minimum": 0 }, { "name": "wagersWonLast365Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of wagers won over the last 365 days.
", "example": 18, "minimum": 0 }, { "name": "wagersAmountWonLast365Days", "kind": "optional", "type": "number", "description": "[Optional] Total amount won over the last 365 days.
", "example": 1200, "minimum": 0 }, { "name": "averageOddsLast365Days", "kind": "optional", "type": "number", "description": "[Optional] Average odds over the last 365 days.
", "example": 2.15, "minimum": 0 }, { "name": "wagersLifetime", "kind": "optional", "type": "integer", "description": "[Optional] Number of wagers over the account's lifetime.
", "example": 42, "minimum": 0 }, { "name": "wagersAmountLifetime", "kind": "optional", "type": "number", "description": "[Optional] Total amount wagered over the account's lifetime.
", "example": 850, "minimum": 0 }, { "name": "wagersWonLifetime", "kind": "optional", "type": "integer", "description": "[Optional] Number of wagers won over the account's lifetime.
", "example": 18, "minimum": 0 }, { "name": "wagersAmountWonLifetime", "kind": "optional", "type": "number", "description": "[Optional] Total amount won over the account's lifetime.
", "example": 1200, "minimum": 0 }, { "name": "averageOddsLifetime", "kind": "optional", "type": "number", "description": "[Optional] Average odds over the account's lifetime.
", "example": 2.15, "minimum": 0 }, { "name": "averageWagerLastDay", "kind": "optional", "type": "number", "description": "[Optional] Average wager amount over the last day.
", "example": 25.5, "minimum": 0 }, { "name": "averageWager7Days", "kind": "optional", "type": "number", "description": "[Optional] Average wager amount over the last 7 days.
", "example": 25.5, "minimum": 0 }, { "name": "averageWager30Days", "kind": "optional", "type": "number", "description": "[Optional] Average wager amount over the last 30 days.
", "example": 25.5, "minimum": 0 }, { "name": "averageWager90Days", "kind": "optional", "type": "number", "description": "[Optional] Average wager amount over the last 90 days.
", "example": 25.5, "minimum": 0 }, { "name": "averageWager365Days", "kind": "optional", "type": "number", "description": "[Optional] Average wager amount over the last 365 days.
", "example": 25.5, "minimum": 0 }, { "name": "averageWagerLifetime", "kind": "optional", "type": "number", "description": "[Optional] Average wager amount over the account's lifetime.
", "example": 25.5, "minimum": 0 }, { "name": "maxWagerLastDay", "kind": "optional", "type": "number", "description": "[Optional] Largest wager amount over the last day.
", "example": 500, "minimum": 0 }, { "name": "maxWager7Days", "kind": "optional", "type": "number", "description": "[Optional] Largest wager amount over the last 7 days.
", "example": 500, "minimum": 0 }, { "name": "maxWager30Days", "kind": "optional", "type": "number", "description": "[Optional] Largest wager amount over the last 30 days.
", "example": 500, "minimum": 0 }, { "name": "maxWager90Days", "kind": "optional", "type": "number", "description": "[Optional] Largest wager amount over the last 90 days.
", "example": 500, "minimum": 0 }, { "name": "maxWager365Days", "kind": "optional", "type": "number", "description": "[Optional] Largest wager amount over the last 365 days.
", "example": 500, "minimum": 0 }, { "name": "maxWagerLifetime", "kind": "optional", "type": "number", "description": "[Optional] Largest wager amount over the account's lifetime.
", "example": 500, "minimum": 0 }, { "name": "minWagerLastDay", "kind": "optional", "type": "number", "description": "[Optional] Smallest wager amount over the last day.
", "example": 1, "minimum": 0 }, { "name": "minWager7Days", "kind": "optional", "type": "number", "description": "[Optional] Smallest wager amount over the last 7 days.
", "example": 1, "minimum": 0 }, { "name": "minWager30Days", "kind": "optional", "type": "number", "description": "[Optional] Smallest wager amount over the last 30 days.
", "example": 1, "minimum": 0 }, { "name": "minWager90Days", "kind": "optional", "type": "number", "description": "[Optional] Smallest wager amount over the last 90 days.
", "example": 1, "minimum": 0 }, { "name": "minWager365Days", "kind": "optional", "type": "number", "description": "[Optional] Smallest wager amount over the last 365 days.
", "example": 1, "minimum": 0 }, { "name": "minWagerLifetime", "kind": "optional", "type": "number", "description": "[Optional] Smallest wager amount over the account's lifetime.
", "example": 1, "minimum": 0 }, { "name": "earlyCashoutsLastDay", "kind": "optional", "type": "integer", "description": "[Optional] Number of early cashouts over the last day.
", "example": 3, "minimum": 0 }, { "name": "earlyCashoutsLast7Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of early cashouts over the last 7 days.
", "example": 3, "minimum": 0 }, { "name": "earlyCashoutsLast30Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of early cashouts over the last 30 days.
", "example": 3, "minimum": 0 }, { "name": "earlyCashoutsLast90Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of early cashouts over the last 90 days.
", "example": 3, "minimum": 0 }, { "name": "earlyCashoutsLast365Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of early cashouts over the last 365 days.
", "example": 3, "minimum": 0 }, { "name": "earlyCashoutsLifetime", "kind": "optional", "type": "integer", "description": "[Optional] Number of early cashouts over the account's lifetime.
", "example": 3, "minimum": 0 }, { "name": "earlyCashoutsAmountLastDay", "kind": "optional", "type": "number", "description": "[Optional] Early cashout amount over the last day.
", "example": 75, "minimum": 0 }, { "name": "earlyCashoutsAmountLast7Days", "kind": "optional", "type": "number", "description": "[Optional] Early cashout amount over the last 7 days.
", "example": 75, "minimum": 0 }, { "name": "earlyCashoutsAmountLast30Days", "kind": "optional", "type": "number", "description": "[Optional] Early cashout amount over the last 30 days.
", "example": 75, "minimum": 0 }, { "name": "earlyCashoutsAmountLast90Days", "kind": "optional", "type": "number", "description": "[Optional] Early cashout amount over the last 90 days.
", "example": 75, "minimum": 0 }, { "name": "earlyCashoutsAmountLast365Days", "kind": "optional", "type": "number", "description": "[Optional] Early cashout amount over the last 365 days.
", "example": 75, "minimum": 0 }, { "name": "earlyCashoutsAmountLifetime", "kind": "optional", "type": "number", "description": "[Optional] Early cashout amount over the account's lifetime.
", "example": 75, "minimum": 0 }, { "name": "liveWagersLastDay", "kind": "optional", "type": "integer", "description": "[Optional] Number of live wagers over the last day.
", "example": 5, "minimum": 0 }, { "name": "liveWagersLast7Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of live wagers over the last 7 days.
", "example": 5, "minimum": 0 }, { "name": "liveWagersLast30Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of live wagers over the last 30 days.
", "example": 5, "minimum": 0 }, { "name": "liveWagersLast90Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of live wagers over the last 90 days.
", "example": 5, "minimum": 0 }, { "name": "liveWagersLast365Days", "kind": "optional", "type": "integer", "description": "[Optional] Number of live wagers over the last 365 days.
", "example": 5, "minimum": 0 }, { "name": "liveWagersLifetime", "kind": "optional", "type": "integer", "description": "[Optional] Number of live wagers over the account's lifetime.
", "example": 5, "minimum": 0 }, { "name": "averageTimeBeforeMatch", "kind": "optional", "type": "number", "description": "[Optional] Average minutes between wager placement and match start.
", "example": 45, "minimum": 0 }, { "name": "houseLimit", "kind": "optional", "type": "number", "description": "[Optional] Maximum wager amount the house permits.
", "example": 5000, "minimum": 0 } ] }, { "name": "account", "kind": "optional", "type": "object", "description": "Nested object containing account-level details for the transacting customer.
", "example": "{\"isEnrolledInLoyaltyProgram\":true,\"loyaltyNumber\":\"Id1234\",\"accountLocale\":\"en-US\",\"accountLevel\":\"Gold\",\"accountType\":\"individual\",\"loyaltyProgramName\":\"Members Plus\",\"loyaltyPointsBalance\":987654321}", "schema": [ { "name": "isEnrolledInLoyaltyProgram", "kind": "optional", "type": "boolean", "description": "[Optional] Whether the account holds a loyalty membership (\"true\"/\"false\").
", "example": true }, { "name": "loyaltyNumber", "kind": "optional", "type": "string", "description": "[Optional] Customer's loyalty program membership number.
", "example": "Id1234" }, { "name": "accountLocale", "kind": "optional", "type": "string", "description": "[Optional] Account locale/language preference (e.g., \"en-US\").
", "example": "en-US" }, { "name": "accountLevel", "kind": "optional", "type": "string", "description": "[Optional] Customer tier within the loyalty or membership program (e.g., \"Gold\").
", "example": "Gold" }, { "name": "accountType", "kind": "optional", "type": "string[Optional] Account category; one of: individual, business, family, other.
", "example": "individual", "enum": [ "individual", "business", "family", "other" ] }, { "name": "accountRegistrationDateTime", "kind": "optional", "type": "string[Optional] ISO 8601 timestamp of when the account was created.
", "example": "2020-11-22T17:07:24-07:00", "format": "date-time" }, { "name": "accountEmailUpdatedDateTime", "kind": "optional", "type": "string[Optional] ISO 8601 timestamp of the last email address change on the account.
", "example": "2020-08-28T19:00:00-04:00", "format": "date-time" }, { "name": "accountPasswordUpdatedDateTime", "kind": "optional", "type": "string[Optional] ISO 8601 timestamp of the last password change on the account.
", "example": "2021-06-15T10:30:00-07:00", "format": "date-time" }, { "name": "dateOfBirth", "kind": "optional", "type": "string[Optional] Customer's date of birth in ISO 8601 date format (YYYY-MM-DD).
", "example": "1985-11-15", "format": "date" }, { "name": "loyaltyProgramName", "kind": "optional", "type": "string", "description": "[Optional] Name of the loyalty program the account belongs to (max 100 chars).
", "example": "Members Plus", "maxLength": 100 }, { "name": "loyaltyPointsBalance", "kind": "optional", "type": "integer", "description": "[Optional] Current point balance in the loyalty program; zero or positive.
", "example": 987654321, "minimum": 0 } ] }, { "name": "payment", "kind": "optional", "type": "object", "description": "Additional iGaming payment-level details.
", "example": "{\"isGift\":false,\"orderMessage\":\"Enjoy the gift\",\"isPaymentInInstallments\":false,\"isPaymentRecurring\":false}", "schema": [ { "name": "isGift", "kind": "optional", "type": "boolean", "description": "[Optional] Whether the transaction is a gift.
", "example": false }, { "name": "orderMessage", "kind": "optional", "type": "string", "description": "[Optional] Personal message or order instruction associated with the transaction.
", "example": "Enjoy the gift" }, { "name": "isPaymentInInstallments", "kind": "optional", "type": "boolean", "description": "[Optional] Whether payment uses installments.
", "example": false }, { "name": "installmentAmount", "kind": "optional", "type": "number", "description": "[Optional] Amount of each installment.
", "example": 99.99, "minimum": 0, "exclusiveMinimum": true }, { "name": "installmentCurrencyCode", "kind": "optional", "type": "string", "description": "[Conditional] Required when installments are used.
", "example": "USD" }, { "name": "installmentCount", "kind": "optional", "type": "integer", "description": "[Conditional] Number of installments.
", "example": 12, "minimum": 0, "exclusiveMinimum": true }, { "name": "isPaymentRecurring", "kind": "optional", "type": "boolean", "description": "[Optional] Whether payment recurs.
", "example": false } ] }, { "name": "addresses", "kind": "optional", "type": "array", "description": "", "example": "[{\"addressType\":\"billing\",\"addressID\":\"23l4jk23klj23\",\"primaryFlag\":true,\"isAddressOnFile\":true,\"firstName\":\"Jane\",\"middleName\":\"Marie\",\"lastName\":\"Doe\",\"emailAddress\":\"jane.doe123@gmail.com\",\"phone\":\"3125555555\",\"phoneCountryCode\":\"001\",\"address1\":\"1863 Main Street\",\"address2\":\"Apt 7\",\"city\":\"Chicago\",\"region\":\"IL\",\"postCode\":\"60601\",\"country\":\"US\"}]", "itemType": "object", "customType": "object[]", "schema": [ { "name": "addressID", "kind": "required", "type": "string", "description": "[Required] Merchant-assigned identifier for this address record.
", "example": "23l4jk23klj23" }, { "name": "addressType", "kind": "required", "type": "string[Required] Role of this address in the order.
", "example": "billing", "enum": [ "account", "billing", "bopis", "curbside", "departure", "destination", "fulfillment", "listing", "lodging", "pickup", "return", "shipping", "venue", "other" ] }, { "name": "primaryFlag", "kind": "optional", "type": "boolean", "description": "[Optional] Marks this as the account's primary address (true/false).
", "example": true }, { "name": "isAddressOnFile", "kind": "optional", "type": "boolean", "description": "[Optional] Whether this address was previously saved to the account (\"true\"/\"false\").
", "example": true }, { "name": "firstName", "kind": "required", "type": "string", "description": "[Required] Recipient's first name at this address.
", "example": "Jane" }, { "name": "middleName", "kind": "optional", "type": "string", "description": "[Optional] Recipient's middle name at this address.
", "example": "Marie" }, { "name": "lastName", "kind": "required", "type": "string", "description": "[Required] Recipient's last name at this address.
", "example": "Doe" }, { "name": "emailAddress", "kind": "optional", "type": "string", "description": "[Conditional] Recipient's email address; required when addressType is account or billing.
", "example": "jane.doe123@gmail.com" }, { "name": "phone", "kind": "required", "type": "string", "description": "[Required] Recipient's phone number.
", "example": "3125555555" }, { "name": "phoneCountryCode", "kind": "required", "type": "string", "description": "[Required] International dial prefix for the phone number (for example, \"001\").
", "example": "001" }, { "name": "address1", "kind": "required", "type": "string", "description": "[Required] Primary street address line.
", "example": "1863 Main Street" }, { "name": "address2", "kind": "optional", "type": "string", "description": "[Optional] Secondary address line (suite, apartment, etc.).
", "example": "Apt 7" }, { "name": "city", "kind": "required", "type": "string", "description": "[Required] City component of the address.
", "example": "Chicago" }, { "name": "region", "kind": "required", "type": "string", "description": "[Required] State or region component of the address.
", "example": "IL" }, { "name": "postCode", "kind": "required", "type": "string", "description": "[Required] Postal or ZIP code.
", "example": "60601" }, { "name": "country", "kind": "required", "type": "string", "description": "[Required] ISO 3166-1 alpha-2 country code.
", "example": "US" }, { "name": "companyName", "kind": "optional", "type": "string", "description": "[Optional] Business name at this address.
", "example": "Accertify, Inc" }, { "name": "addressCreatedDateTime", "kind": "optional", "type": "string[Optional] ISO 8601 timestamp of when this address was saved.
", "example": "2020-03-28T17:07:24-07:00", "format": "date-time" }, { "name": "addressUpdatedDateTime", "kind": "optional", "type": "string[Optional] ISO 8601 timestamp of the last modification to this address.
", "example": "2021-03-28T17:07:24-07:00", "format": "date-time" } ] }, { "name": "paymentMethods", "kind": "optional", "type": "array", "description": "", "example": "[{\"paymentType\":\"creditCard\",\"paymentMethodID\":\"2ljr9vxsdfew\",\"paymentMethodAmount\":500,\"isPaymentStoredOnFile\":true,\"cardToken\":\"6f7%gf38hfUa\",\"expirationMonth\":\"11\",\"expirationYear\":\"2027\",\"nameOnCreditCard\":\"Jane Doe\",\"cardBin\":\"345678\",\"cardLastFour\":\"1111\",\"totalFailedAttempts\":0,\"addressID\":\"23kl4l32l\",\"avsResult\":\"matched\",\"cvvResult\":\"matched\",\"cardAuthorizationCode\":\"12345\",\"cardAuthorizationDateTime\":\"2022-06-10T14:30:05-05:00\",\"sca3DSFlow\":\"frictionless\",\"sca3DSVersion\":\"2.2.0\",\"sca3DSChallengeRequestType\":\"02\",\"sca3DSTransactionStatus\":\"Y\",\"scaAuthorizationStatus\":\"approve\",\"eciIndicator\":\"successful\",\"isSCASoftDecline\":false}]", "itemType": "object", "customType": "object[]", "schema": [ { "name": "paymentType", "kind": "optional", "type": "string[Conditional] Type of payment instrument. Required when paymentMethodID is present.
", "example": "creditCard", "enum": [ "bankAccount", "cash", "check", "creditCard", "cryptoCurrency", "digitalWallet", "electronicFundTransfer", "giftCard", "invoice", "loan", "loyaltyPoints", "moneyOrder", "secCard", "storeCredit", "thirdParty", "voucher" ] }, { "name": "paymentMethodID", "kind": "optional", "type": "string", "description": "[Optional] Merchant-assigned identifier for this payment method.
", "example": "2ljr9vxsdfew" }, { "name": "paymentMethodAmount", "kind": "optional", "type": "number", "description": "[Optional] Amount charged to this payment method.
", "example": 500, "minimum": 0 }, { "name": "isPaymentStoredOnFile", "kind": "optional", "type": "boolean", "description": "[Optional] Whether this instrument is saved to the account (\"true\"/\"false\").
", "example": true }, { "name": "cardNumber", "kind": "optional", "type": "string", "description": "[Optional] Full card number (PAN) for credit card payments, validated using the Luhn algorithm.
", "example": "4111111111111111" }, { "name": "cardToken", "kind": "optional", "type": "string", "description": "[Optional] Tokenized representation of the card number.
", "example": "6f7%gf38hfUa" }, { "name": "expirationMonth", "kind": "optional", "type": "string<01 | 02 | 03 | 04 | 05 | 06 | 07 | 8 | 9 | 10 | 11 | 12>", "description": "[Conditional] Zero-padded two-digit card expiration month (\"01\"..\"12\"); required when paymentType = creditCard.
", "example": "11", "enum": [ "01", "02", "03", "04", "05", "06", "07", "8", "9", "10", "11", "12" ] }, { "name": "expirationYear", "kind": "optional", "type": "string", "description": "[Conditional] Card expiration year (4-digit); required when paymentType = creditCard.
", "example": "2027" }, { "name": "nameOnCreditCard", "kind": "optional", "type": "string", "description": "[Conditional] Cardholder name as embossed on the card; required when paymentType = creditCard.
", "example": "Jane Doe" }, { "name": "cardBin", "kind": "optional", "type": "string", "description": "[Optional] Bank Identification Number (6 to 11 digits) of the card.
", "example": "345678" }, { "name": "cardLastFour", "kind": "optional", "type": "string", "description": "[Optional] Last four digits of the card number.
", "example": "1111" }, { "name": "totalFailedAttempts", "kind": "optional", "type": "integer", "description": "[Optional] Number of failed payment attempts for this method.
", "example": 0, "minimum": 0 }, { "name": "paymentMethodCreatedDateTime", "kind": "optional", "type": "string[Optional] ISO 8601 timestamp of when this payment method was saved.
", "example": "2020-03-28T17:07:24-07:00", "format": "date-time" }, { "name": "paymentMethodUpdatedDateTime", "kind": "optional", "type": "string[Optional] ISO 8601 timestamp of the last update to this payment method.
", "example": "2020-03-28T17:07:24-07:00", "format": "date-time" }, { "name": "addressID", "kind": "optional", "type": "string", "description": "[Optional] Reference to the billing address record for this payment method.
", "example": "23kl4l32l" }, { "name": "nameOnAccount", "kind": "optional", "type": "string", "description": "[Optional] Name on file for a wallet or account-based payment method.
", "example": "Jane Doe" }, { "name": "walletType", "kind": "optional", "type": "string", "description": "[Optional] Digital wallet provider.
", "example": "Apple Pay" }, { "name": "walletStatus", "kind": "optional", "type": "string[Optional] Current status of the wallet.
", "example": "active", "enum": [ "active", "pending", "inactive" ] }, { "name": "isWalletProtectionEligible", "kind": "optional", "type": "boolean", "description": "[Optional] Whether the wallet is eligible for purchase protection (\"true\"/\"false\").
", "example": true }, { "name": "paymentMethodBalanceAmount", "kind": "optional", "type": "number", "description": "[Optional] Remaining balance available on this payment method.
", "example": 4000.32, "minimum": 0, "exclusiveMinimum": true }, { "name": "giftCardNumber", "kind": "optional", "type": "string", "description": "[Optional] Full gift card number.
", "example": "5555444433332222" }, { "name": "giftCardLastFour", "kind": "optional", "type": "string", "description": "[Optional] Last four digits of the gift card number.
", "example": "2222" }, { "name": "giftCardBIN", "kind": "optional", "type": "string", "description": "[Optional] Bank Identification Number (first 6 digits) of the gift card.
", "example": "654678" }, { "name": "expirationDay", "kind": "optional", "type": "string", "description": "[Optional] Card expiration day, for payment types that include a day component.
", "example": 9 }, { "name": "points", "kind": "optional", "type": "integer", "description": "[Optional] Loyalty or reward points balance associated with this payment method.
", "example": 50000 }, { "name": "loyaltyProgramName", "kind": "optional", "type": "string", "description": "[Optional] Name of the loyalty program associated with this payment method.
", "example": "Members Plus" }, { "name": "accountType", "kind": "optional", "type": "string[Conditional] Bank account type; required when paymentType = bankAccount.
", "example": "checking", "enum": [ "checking", "saving", "moneyMarket", "other" ] }, { "name": "avsResult", "kind": "optional", "type": "string[Optional] Address Verification Service result code returned by the card network.
", "example": "matched", "enum": [ "matched", "partialMatch", "notMatched", "notChecked", "systemError", "other" ] }, { "name": "cvvResult", "kind": "optional", "type": "string[Optional] Card Verification Value validation result code returned by the card network.
", "example": "matched", "enum": [ "matched", "notMatched" ] }, { "name": "cardAuthorizationCode", "kind": "optional", "type": "string", "description": "[Optional] Authorization approval code returned by the card network.
", "example": "12345" }, { "name": "cardAuthorizationDateTime", "kind": "optional", "type": "string[Optional] ISO 8601 timestamp of when the authorization was issued.
", "example": "2022-06-10T14:30:05-05:00", "format": "date-time" }, { "name": "isPreAuthorizationReject", "kind": "optional", "type": "boolean", "description": "[Optional] Whether the authorization was rejected before submission (\"true\"/\"false\" also accepted).
", "example": false }, { "name": "postAuthorizationRejectReason", "kind": "optional", "type": "string[Optional] Reason the post-authorization was rejected.
", "example": "creditReject", "enum": [ "creditReject", "fraudReject", "otherReject" ] }, { "name": "eciIndicator", "kind": "optional", "type": "string[Conditional] E-Commerce Indicator returned by the 3DS process; required when sca3DSFlow is present.
", "example": "successful", "enum": [ "successful", "unsuccessfulOrNotAttempted", "attemptedButNotCompleted", "other" ] }, { "name": "isSCASoftDecline", "kind": "optional", "type": "boolean", "description": "[Conditional] Whether the authorization received a soft decline requiring SCA (\"true\"/\"false\" also accepted); required when sca3DSFlow is present.
", "example": false }, { "name": "sca3DSFlow", "kind": "optional", "type": "string[Optional] 3DS authentication flow that was applied; one of: challenge, frictionless, dataOnly; when present, the SCA fields below become required.
", "example": "frictionless", "enum": [ "challenge", "frictionless", "dataOnly" ] }, { "name": "sca3DSVersion", "kind": "optional", "type": "string", "description": "[Conditional] 3DS protocol version used; required when sca3DSFlow is present.
", "example": "2.2.0" }, { "name": "sca3DSChallengeRequestType", "kind": "optional", "type": "string<02 | 03 | 04 | 05 | 06 | 10 | 11>", "description": "[Conditional] Type of 3DS challenge initiated; one of: 02, 03, 04, 05, 06, 10, 11. Required when sca3DSFlow is present.
", "example": "02", "enum": [ "02", "03", "04", "05", "06", "10", "11" ] }, { "name": "sca3DSTransactionStatus", "kind": "optional", "type": "string[Conditional] 3DS transaction status returned by the issuer; one of: Y, N, U, A, I. Required when sca3DSFlow is present.
", "example": "Y", "enum": [ "Y", "N", "U", "A", "I" ] }, { "name": "scaAuthorizationStatus", "kind": "optional", "type": "string[Conditional] SCA authorization outcome; one of: approve, decline. Required when sca3DSFlow is present.
", "example": "approve", "enum": [ "approve", "decline" ] }, { "name": "scaAuthorizationError", "kind": "optional", "type": "string[Conditional] Reason for a declined SCA authorization; required when scaAuthorizationStatus is \"decline\".
", "example": "decline", "enum": [ "decline", "fraudReject", "insufficientFunds", "invalidCard", "incorrectInformation", "lostOrStolen", "withdrawalAmountExceeded", "technicalError", "other" ] } ] }, { "name": "items", "kind": "optional", "type": "array", "description": "", "example": "", "itemType": "object", "customType": "object[]", "schema": [ { "name": "itemType", "kind": "optional", "type": "string[Optional] Category of item; one of: giftCard, parking, physicalGood, reservation, subscription, ticket, other.
", "example": "physicalGood", "enum": [ "giftCard", "parking", "physicalGood", "reservation", "subscription", "ticket", "other" ] }, { "name": "brandName", "kind": "optional", "type": "string", "description": "[Optional] Brand or manufacturer of the item.
", "example": "Apple" }, { "name": "description", "kind": "optional", "type": "string", "description": "[Optional] Short description or name of the item.
", "example": "Macbook Pro" }, { "name": "category", "kind": "optional", "type": "string", "description": "[Optional] Merchant-defined product category.
", "example": "Computers" }, { "name": "itemID", "kind": "optional", "type": "string", "description": "[Optional] Merchant's unique product or SKU identifier.
", "example": "af877wernnasnfes" }, { "name": "isHighRiskItem", "kind": "required", "type": "boolean", "description": "[Required] Whether the item is flagged as high risk (\"true\"/\"false\").
", "example": true }, { "name": "price", "kind": "required", "type": "number", "description": "[Required] Unit price of the item; positive number.
", "example": 1199.99, "minimum": 0 }, { "name": "faceValueAmount", "kind": "optional", "type": "number", "description": "[Optional] Face or retail value of the item; zero or positive.
", "example": 1599.99, "minimum": 0 }, { "name": "quantity", "kind": "optional", "type": "number", "description": "[Optional] Number of units of this item in the order.
", "example": 2 }, { "name": "addressID", "kind": "optional", "type": "string", "description": "[Conditional] Delivery address reference for this line item; required when shippingMethod is present.
", "example": "2lkj34jldsoufsous82df" }, { "name": "productCondition", "kind": "optional", "type": "string[Optional] Condition of the item; one of: new, openPackage, other, refurbished, used.
", "example": "new", "enum": [ "new", "openPackage", "other", "refurbished", "used" ] }, { "name": "shippingCompany", "kind": "optional", "type": "string[Optional] Carrier for this item; one of: dhl, fedex, ups, usps, other.
", "example": "ups", "enum": [ "dhl", "fedex", "ups", "usps", "other" ] }, { "name": "companyName", "kind": "optional", "type": "string", "description": "[Optional] Shipping company name for this item, when not one of the standard carriers (max 50 chars).
", "example": "Regional Courier Co", "maxLength": 50 }, { "name": "shippingMethod", "kind": "required", "type": "string[Required] Shipping speed or method.
", "example": "ground", "enum": [ "digital", "ground", "international", "other", "nextDay", "sameDay", "storePickup", "twoDay", "threeDay" ] }, { "name": "shippingTrackingNumber", "kind": "optional", "type": "string", "description": "[Optional] Carrier tracking number for this item (max 30 chars).
", "example": "23l4fdswerea02", "maxLength": 30 }, { "name": "promoCode", "kind": "optional", "type": "string", "description": "[Optional] Promotion code applied specifically to this item (max 40 chars).
", "example": "ABC12", "maxLength": 40 }, { "name": "promoAmount", "kind": "optional", "type": "number", "description": "[Optional] Discount applied to this item; zero or positive.
", "example": 50, "minimum": 0 }, { "name": "promoType", "kind": "optional", "type": "string[Optional] Category of the item-level promotion.
", "example": "employeeDiscount", "enum": [ "bogo", "bundle", "employeeDiscount", "freeShipping", "loyaltyDiscount", "newMemberDiscount", "percentage", "quantityPromotion", "other" ] }, { "name": "pickupLocation", "kind": "optional", "type": "string[Optional] In-store or curbside pickup method; one of: curbside, dropBox, inStore, other.
", "example": "curbside", "enum": [ "curbside", "dropBox", "inStore", "other" ] }, { "name": "pickupDateTime", "kind": "optional", "type": "string[Optional] ISO 8601 timestamp of the scheduled pickup.
", "example": "2022-03-11T17:07:24-07:00", "format": "date-time" }, { "name": "pickupPersonFirstName", "kind": "optional", "type": "string", "description": "[Optional] First name of the person collecting the order (max 40 chars).
", "example": "Betty", "maxLength": 40 }, { "name": "pickupPersonLastName", "kind": "optional", "type": "string", "description": "[Optional] Last name of the person collecting the order (max 40 chars).
", "example": "Smith", "maxLength": 40 } ] }, { "name": "promotions", "kind": "optional", "type": "array", "description": "", "example": "", "itemType": "object", "customType": "object[]", "schema": [ { "name": "promoCode", "kind": "optional", "type": "string", "description": "[Optional] Promotional code applied to the order.
", "example": "ABC12" }, { "name": "promoAmount", "kind": "required", "type": "number", "description": "[Required] Discount amount granted by this promotion; zero or positive.
", "example": 50, "minimum": 0 }, { "name": "promoType", "kind": "optional", "type": "string[Optional] Category of the promotion (e.g., employeeDiscount, freeShipping).
", "example": "employeeDiscount", "enum": [ "bogo", "bundle", "employeeDiscount", "freeShipping", "loyaltyDiscount", "newMemberDiscount", "percentage", "quantityPromotion", "other" ] } ] } ], "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "oauthBearer", "name": "Authorization", "kind": "optional", "type": "apiKey", "description": "OAuth 2.0 Bearer token, e.g. 'Bearer '.
", "in": "header" } ] }, "responses": [ { "statusCode": "200", "description": "Successful response.", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "description": "Successful response.", "customType": "scoredResult", "schema": [ { "name": "eventID", "kind": "optional", "type": "string", "description": "" }, { "name": "eventDetails", "kind": "optional", "type": "object", "description": "Device and connection risk signals (scored responses only)
", "modelRef": "#/definitions/eventDetails", "customType": "eventDetails", "schema": [ { "name": "deviceDetails", "kind": "optional", "type": "object", "description": "", "example": "", "schema": [ { "name": "browserSpoofRisk", "kind": "optional", "type": "string", "description": "[Optional] Risk indicator for browser spoofing detected during device collection.
", "example": "HIGH_RISK" }, { "name": "deviceIDNew", "kind": "optional", "type": "string", "description": "[Optional] A flag indicating the device ID was observed for the first time (\"true\"/\"false\").
", "example": "true" }, { "name": "browserIsMobile", "kind": "optional", "type": "string", "description": "[Optional] A flag indicating the browser is running on a mobile device (\"true\"/\"false\").
", "example": "true" }, { "name": "mobileIsRooted", "kind": "optional", "type": "string", "description": "[Optional] A flag indicating the mobile device is rooted or jailbroken (\"true\"/\"false\").
", "example": "true" }, { "name": "deviceIDFirstSeen", "kind": "optional", "type": "number", "description": "[Optional] Number of days since this device ID was first observed.
", "example": 97 }, { "name": "browserNewCookie", "kind": "optional", "type": "string", "description": "[Optional] A flag indicating a new browser cookie was set during this session (\"true\"/\"false\").
", "example": "false" }, { "name": "deviceIDTimesSeen", "kind": "optional", "type": "number", "description": "[Optional] Total number of times this device ID has been seen.
", "example": 123 }, { "name": "mobileApp", "kind": "optional", "type": "string", "description": "[Optional] A flag indicating the event originated from a mobile app.
", "example": "true" }, { "name": "browserReplayTagStatus", "kind": "optional", "type": "string", "description": "[Optional] Status of the UBA replay tag detected in the session.
", "example": "VALID" }, { "name": "deviceID", "kind": "optional", "type": "string", "description": "[Optional] Unique persistent identifier assigned to the device.
", "example": "63dc80b4-e585-4ae8-8004-e24fb0d1fa84" } ] }, { "name": "connectionDetails", "kind": "optional", "type": "object", "description": "", "example": "", "schema": [ { "name": "hostingIndicator", "kind": "optional", "type": "string", "description": "[Optional] A flag indicating the client IP address belongs to a hosting provider (\"true\"/\"false\").
", "example": "true" }, { "name": "isTor", "kind": "optional", "type": "string", "description": "[Optional] A flag indicating the client IP address is a Tor exit node (\"true\"/\"false\").
", "example": "true" }, { "name": "hostingIndicatorReal", "kind": "optional", "type": "string", "description": "[Optional] A flag indicating the client real IP address belongs to a hosting provider (\"true\"/\"false\").
", "example": "true" }, { "name": "realIPMatch", "kind": "optional", "type": "string", "description": "[Optional] A flag indicating the stated IP address matches the detected real IP address (\"true\"/\"false\").
", "example": "true" }, { "name": "countryCode", "kind": "optional", "type": "string", "description": "[Optional] ISO 3166-1 alpha-2 country code of the client IP address.
", "example": "us" }, { "name": "countryCodeReal", "kind": "optional", "type": "string", "description": "[Optional] ISO 3166-1 alpha-2 country code of the real IP address when a proxy is detected.
", "example": "de" }, { "name": "isProxy", "kind": "optional", "type": "string", "description": "[Optional] A flag indicating the client IP address is a known proxy (\"true\"/\"false\").
", "example": "false" } ] } ] }, { "name": "messages", "kind": "optional", "type": "object", "description": "", "modelRef": "#/definitions/apiMessages", "customType": "apiMessages", "schema": [ { "name": "error", "kind": "optional", "type": "array", "description": "", "modelRef": "#/definitions/apiMessage", "customType": "apiMessage[]", "schema": [ { "name": "code", "kind": "required", "type": "string", "description": "Machine-readable message code
", "example": "FIELD_REQUIRED_MISSING" }, { "name": "message", "kind": "required", "type": "string", "description": "Human-readable message
", "example": "transactionID is required and was not provided" }, { "name": "field", "kind": "optional", "type": "string", "description": "Name of the field this message applies to", "example": "transactionID" }, { "name": "details", "kind": "optional", "type": "map", "description": "Structured detail keys.", "example": "", "customType": "mapMachine-readable message code
", "example": "FIELD_REQUIRED_MISSING" }, { "name": "message", "kind": "required", "type": "string", "description": "Human-readable message
", "example": "transactionID is required and was not provided" }, { "name": "field", "kind": "optional", "type": "string", "description": "Name of the field this message applies to", "example": "transactionID" }, { "name": "details", "kind": "optional", "type": "map", "description": "Structured detail keys.", "example": "", "customType": "mapMachine-readable message code
", "example": "FIELD_REQUIRED_MISSING" }, { "name": "message", "kind": "required", "type": "string", "description": "Human-readable message
", "example": "transactionID is required and was not provided" }, { "name": "field", "kind": "optional", "type": "string", "description": "Name of the field this message applies to", "example": "transactionID" }, { "name": "details", "kind": "optional", "type": "map", "description": "Structured detail keys.", "example": "", "customType": "mapHuman-readable summary of the validation error.
", "example": "Validation Failed" }, { "name": "errors", "kind": "optional", "type": "array", "description": "Validation error details for the request.", "example": "[\"Missing required field: transactionID\"]", "itemType": "string", "customType": "string[]", "itemExample": "", "itemDefault": "" } ], "modelRef": "#/definitions/validationFailedError", "isExpanded": true } ] }, { "statusCode": "401", "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.", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "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.", "customType": "notAuthorizedError", "schema": [ { "name": "errorCode", "kind": "optional", "type": "integer", "description": "HTTP status code for the authentication or authorization error.", "example": 401 }, { "name": "errorMessage", "kind": "optional", "type": "string", "description": "Human-readable summary of the authentication or authorization error.
", "example": "Not Authorized" } ], "modelRef": "#/definitions/notAuthorizedError", "isExpanded": true } ] }, { "statusCode": "429", "description": "Error response when the request rate limit has been exceeded for the API user or API configuration.", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "description": "Error response when the request rate limit has been exceeded for the API user or API configuration.", "customType": "rateLimitError", "schema": [ { "name": "errorCode", "kind": "optional", "type": "integer", "description": "HTTP status code for the rate-limit error.
", "example": 429 }, { "name": "errorMessage", "kind": "optional", "type": "string", "description": "Human-readable summary of the rate-limit error.
", "example": "Rate Limit Exceeded" } ], "modelRef": "#/definitions/rateLimitError", "isExpanded": true } ] }, { "statusCode": "500", "description": "Error response when the request cannot be processed due to an unexpected internal error.", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "description": "Error response when the request cannot be processed due to an unexpected internal error.", "customType": "internalServerError", "schema": [ { "name": "errorCode", "kind": "optional", "type": "integer", "description": "HTTP status code for the internal server error.", "example": 500 }, { "name": "errorMessage", "kind": "optional", "type": "string", "description": "Human-readable summary of the internal server error.
", "example": "Internal Server Error" } ], "modelRef": "#/definitions/internalServerError", "isExpanded": true } ] } ], "examples": { "languages": [ { "id": "example-0-curl", "language": "curl", "label": "cURL", "code": "curl --request POST \\\n --url https://api.accertify.net/api/v1/unified-risk/postAuthIGaming \\\n --header 'accept: application/json' \\\n --header 'content-type: application/json' \\\n --data-raw '{\n \"transactionID\": \"IGM-12345678\",\n \"transactionDateTime\": \"2022-06-10T14:30:00-05:00\",\n \"eventSource\": \"web\",\n \"isGuestCheckout\": false,\n \"paymentAmount\": 500,\n \"deliveryAmount\": 0,\n \"success\": true,\n \"emailAddress\": \"a@example.com\",\n \"purchaseType\": \"services\",\n \"addresses\": [\n {\n \"addressID\": \"23l4jk23klj23\",\n \"addressType\": \"billing\",\n \"firstName\": \"Jane\",\n \"lastName\": \"Doe\",\n \"phone\": \"3125555555\",\n \"phoneCountryCode\": \"001\",\n \"address1\": \"1863 Main Street\",\n \"city\": \"Chicago\",\n \"region\": \"IL\",\n \"postCode\": \"60601\",\n \"country\": \"US\"\n }\n ],\n \"items\": [\n {\n \"isHighRiskItem\": true,\n \"price\": 1199.99,\n \"shippingMethod\": \"ground\"\n }\n ],\n \"promotions\": [\n {\n \"promoAmount\": 50\n }\n ]\n }'" }, { "id": "example-1-javascript", "language": "javascript", "label": "javascript", "code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar raw = JSON.stringify({\n \"transactionID\": \"IGM-12345678\",\n \"transactionDateTime\": \"2022-06-10T14:30:00-05:00\",\n \"eventSource\": \"web\",\n \"isGuestCheckout\": false,\n \"paymentAmount\": 500,\n \"deliveryAmount\": 0,\n \"success\": true,\n \"emailAddress\": \"a@example.com\",\n \"purchaseType\": \"services\",\n \"addresses\": [\n {\n \"addressID\": \"23l4jk23klj23\",\n \"addressType\": \"billing\",\n \"firstName\": \"Jane\",\n \"lastName\": \"Doe\",\n \"phone\": \"3125555555\",\n \"phoneCountryCode\": \"001\",\n \"address1\": \"1863 Main Street\",\n \"city\": \"Chicago\",\n \"region\": \"IL\",\n \"postCode\": \"60601\",\n \"country\": \"US\"\n }\n ],\n \"items\": [\n {\n \"isHighRiskItem\": true,\n \"price\": 1199.99,\n \"shippingMethod\": \"ground\"\n }\n ],\n \"promotions\": [\n {\n \"promoAmount\": 50\n }\n ]\n});\n\nvar requestOptions = {\n method: 'POST',\n headers: myHeaders,\n body: raw,\n redirect: 'follow'\n};\n\nfetch(\"https://api.accertify.net/api/v1/unified-risk/postAuthIGaming\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));" }, { "id": "example-2-ruby", "language": "ruby", "label": "Ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.accertify.net/api/v1/unified-risk/postAuthIGaming\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\nrequest.body = JSON.dump({\n \"transactionID\": \"IGM-12345678\",\n \"transactionDateTime\": \"2022-06-10T14:30:00-05:00\",\n \"eventSource\": \"web\",\n \"isGuestCheckout\": false,\n \"paymentAmount\": 500,\n \"deliveryAmount\": 0,\n \"success\": true,\n \"emailAddress\": \"a@example.com\",\n \"purchaseType\": \"services\",\n \"addresses\": [\n {\n \"addressID\": \"23l4jk23klj23\",\n \"addressType\": \"billing\",\n \"firstName\": \"Jane\",\n \"lastName\": \"Doe\",\n \"phone\": \"3125555555\",\n \"phoneCountryCode\": \"001\",\n \"address1\": \"1863 Main Street\",\n \"city\": \"Chicago\",\n \"region\": \"IL\",\n \"postCode\": \"60601\",\n \"country\": \"US\"\n }\n ],\n \"items\": [\n {\n \"isHighRiskItem\": true,\n \"price\": 1199.99,\n \"shippingMethod\": \"ground\"\n }\n ],\n \"promotions\": [\n {\n \"promoAmount\": 50\n }\n ]\n})\n\nresponse = https.request(request)\nputs response.read_body\n" }, { "id": "example-3-python", "language": "python", "label": "Python", "code": "import requests\nimport json\n\nurl = \"https://api.accertify.net/api/v1/unified-risk/postAuthIGaming\"\n\npayload = json.dumps({\n \"transactionID\": \"IGM-12345678\",\n \"transactionDateTime\": \"2022-06-10T14:30:00-05:00\",\n \"eventSource\": \"web\",\n \"isGuestCheckout\": False,\n \"paymentAmount\": 500,\n \"deliveryAmount\": 0,\n \"success\": True,\n \"emailAddress\": \"a@example.com\",\n \"purchaseType\": \"services\",\n \"addresses\": [\n {\n \"addressID\": \"23l4jk23klj23\",\n \"addressType\": \"billing\",\n \"firstName\": \"Jane\",\n \"lastName\": \"Doe\",\n \"phone\": \"3125555555\",\n \"phoneCountryCode\": \"001\",\n \"address1\": \"1863 Main Street\",\n \"city\": \"Chicago\",\n \"region\": \"IL\",\n \"postCode\": \"60601\",\n \"country\": \"US\"\n }\n ],\n \"items\": [\n {\n \"isHighRiskItem\": True,\n \"price\": 1199.99,\n \"shippingMethod\": \"ground\"\n }\n ],\n \"promotions\": [\n {\n \"promoAmount\": 50\n }\n ]\n})\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json'\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.text)\n" } ], "selectedLanguageId": "example-0-curl" }, "results": { "languages": [ { "id": "response-0-200", "language": "200", "code": "// Successful response.\n{\n \"eventID\": \"\",\n \"eventDetails\": {\n \"deviceDetails\": {\n \"browserSpoofRisk\": \"HIGH_RISK\",\n \"deviceIDNew\": \"true\",\n \"browserIsMobile\": \"true\",\n \"mobileIsRooted\": \"true\",\n \"deviceIDFirstSeen\": 97,\n \"browserNewCookie\": \"false\",\n \"deviceIDTimesSeen\": 123,\n \"mobileApp\": \"true\",\n \"browserReplayTagStatus\": \"VALID\",\n \"deviceID\": \"63dc80b4-e585-4ae8-8004-e24fb0d1fa84\"\n },\n \"connectionDetails\": {\n \"hostingIndicator\": \"true\",\n \"isTor\": \"true\",\n \"hostingIndicatorReal\": \"true\",\n \"realIPMatch\": \"true\",\n \"countryCode\": \"us\",\n \"countryCodeReal\": \"de\",\n \"isProxy\": \"false\"\n }\n },\n \"messages\": {\n \"error\": [\n {\n \"code\": \"FIELD_REQUIRED_MISSING\",\n \"message\": \"transactionID is required and was not provided\",\n \"field\": \"transactionID\",\n \"details\": \"\"\n }\n ],\n \"warning\": [\n {\n \"code\": \"FIELD_REQUIRED_MISSING\",\n \"message\": \"transactionID is required and was not provided\",\n \"field\": \"transactionID\",\n \"details\": \"\"\n }\n ],\n \"info\": [\n {\n \"code\": \"FIELD_REQUIRED_MISSING\",\n \"message\": \"transactionID is required and was not provided\",\n \"field\": \"transactionID\",\n \"details\": \"\"\n }\n ]\n },\n \"status\": false\n}" }, { "id": "response-1-400", "language": "400", "code": "// Error response for invalid or missing request inputs. Returned when one or more required fields are absent or fail validation.\n{\n \"errorCode\": 400,\n \"errorMessage\": \"Validation Failed\",\n \"errors\": [\n \"\"\n ]\n}" }, { "id": "response-2-401", "language": "401", "code": "// Error response for authentication or authorization failures. Returned when credentials are invalid or the authenticated user has no matching API configuration for this endpoint.\n{\n \"errorCode\": 401,\n \"errorMessage\": \"Not Authorized\"\n}" }, { "id": "response-3-429", "language": "429", "code": "// Error response when the request rate limit has been exceeded for the API user or API configuration.\n{\n \"errorCode\": 429,\n \"errorMessage\": \"Rate Limit Exceeded\"\n}" }, { "id": "response-4-500", "language": "500", "code": "// Error response when the request cannot be processed due to an unexpected internal error.\n{\n \"errorCode\": 500,\n \"errorMessage\": \"Internal Server Error\"\n}" } ], "selectedLanguageId": "response-0-200" } }, "children": [ { "text": "" } ] }