--- title: サインアップ slug: 1KNYTUq262_j-3J7YHl5V createdAt: 2025-08-12T21:15:13.774Z --- { "id": "IhRR_AHNkOnz9mheogsYd", "type": "api-oas-v2", "data": { "method": "POST", "url": "https://api.forter-secure.com/v2/accounts/signup/{id}", "servers": [ { "url": "https://api.forter-secure.com/v2/accounts/signup/{id}" } ], "name": "Signup", "description": "Send account registration information at signup to receive a fraud or abuse decision.", "contentType": "application/json", "request": { "pathParameters": [ { "kind": "required", "name": "id", "type": "string", "description": "" } ], "headerParameters": [ { "kind": "required", "name": "api-version", "type": "string", "example": "10.1", "description": "Specify the version of the API to target.", "default": "10.1" }, { "kind": "required", "name": "x-forter-siteid", "type": "string", "example": "a1b2c3d4e5f6", "description": "

Forter-assigned ID for your account. Note that your Site ID for your test site is different from your production site.

", "default": "8b47c6d423ba" }, { "kind": "required", "name": "Authorization", "type": "string", "example": "Basic ", "description": "Basic Authentiation in the form of a username and password. Use the API Key as the username and leave the password empty.", "default": "Basic " } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "required", "name": "body", "type": "object", "description": "Send account registration information at signup to receive a fraud or abuse decision.", "customType": "accountSignupRequest", "schema": [ { "name": "accountData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "AccountData", "description": "", "modelRef": "#/components/schemas/AccountData", "schema": [ { "name": "additionalVerificationDocuments", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "AdditionalVerificationDocuments", "description": "", "modelRef": "#/components/schemas/AdditionalVerificationDocuments", "schema": [ { "name": "documentDateOfBirth", "kind": "optional", "type": "string", "description": "Date of birth as appears on the document. Use YYYY-MM-DD format.", "example": "", "default": "1991-01-09" }, { "name": "documentExpiration", "kind": "optional", "type": "string", "description": "Document's exipration date. Use YYYY-MM-DD format.", "example": "", "default": "2017-01-15" }, { "name": "documentFirstName", "kind": "optional", "type": "string", "description": "First name as appears on the document", "example": "", "default": "John" }, { "name": "documentIssuingState", "kind": "optional", "type": "string", "description": "Document issuing state or region", "example": "", "default": "NY" }, { "name": "documentLastName", "kind": "optional", "type": "string", "description": "Last name as appears on the document", "example": "", "default": "Smith" }, { "name": "documentNumber", "kind": "optional", "type": "string", "description": "Official document's number (e.g. passport number, driving license number, etc.)", "example": "", "default": "20439190" }, { "name": "documentSource", "kind": "required", "type": "string", "description": "Source of document (e.g. uploaded file, captured by camera, typed in by customer, etc.)", "example": "", "default": "UPLOADED_FILE" }, { "name": "documentStatus", "kind": "optional", "type": "string", "description": "Status of verification document (e.g. sent to customer, received by customer, abandoned by customer ).", "example": "", "default": "SENT_TO_CLIENT" }, { "name": "documentType", "kind": "required", "type": "string", "description": "Type of document (Passport, ID, Driving license)", "example": "", "default": "Passport" }, { "name": "documentVerificationServiceAnswer", "kind": "optional", "type": "string", "description": "Answer received from 3rd party document verification services", "example": "", "default": "APPROVED" }, { "name": "documentVerificationServiceName", "kind": "optional", "type": "string", "description": "Name of 3rd party document verifcation service", "example": "", "default": "IDVerification.com" }, { "name": "documentVerificationServiceResponsePayload", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "GeneralPayloadMap", "description": "", "modelRef": "#/components/schemas/GeneralPayloadMap", "schema": [] } ], "schema": [] }, { "name": "documentVerified", "kind": "optional", "type": "boolean", "description": "True if document was verified as authentic by merchant or 3rd party service", "example": "", "default": true }, { "name": "eventTime", "kind": "optional", "type": "number", "description": "Time of event in seconds since unix epoch (UTC, Jan 1, 1970). For example, 01/01/2015 00:00 is 1420070400", "example": "", "default": 1420070400 }, { "name": "nationality", "kind": "optional", "type": "string", "description": "Document holder's nationality", "example": "", "default": "US" } ] } ], "schema": [] }, { "name": "addressesInAccount", "kind": "optional", "type": "array", "description": "All non-billing addresses saved in account. Billing information is included in paymentMethodsInAccount", "modelRef": "#/components/schemas/Address", "customType": "Address[]", "schema": [ { "name": "address1", "kind": "optional", "type": "string", "description": "Street-level address. Required when full address details are available", "example": "", "default": "235 Montgomery st." }, { "name": "address2", "kind": "optional", "type": "string", "description": "Unit-level address", "example": "", "default": "Ste. 1110" }, { "name": "city", "kind": "optional", "type": "string", "description": "City. Required when full address details are available", "example": "", "default": "San Francisco" }, { "name": "company", "kind": "optional", "type": "string", "description": "Company", "example": "", "default": "Generic Corp. ltd." }, { "name": "country", "kind": "required", "type": "string", "description": "Country, two-letter ISO 3166-1 alpha-2 country code", "example": "", "default": "US" }, { "name": "region", "kind": "optional", "type": "string", "description": "Top-level administrative subdivision - state/province/department/etc. Can be either abbreviated format or full name (NY/New York)", "example": "", "default": "CA" }, { "name": "savedData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "SavedData", "description": "", "modelRef": "#/components/schemas/SavedData", "schema": [ { "name": "choseToSaveData", "kind": "optional", "type": "boolean", "description": "True if customer chose to save data in the account for future use", "example": "", "default": false }, { "name": "usedSavedData", "kind": "required", "type": "boolean", "description": "True if customer chose to use data saved in the account", "example": "", "default": true } ] } ], "schema": [] }, { "name": "zip", "kind": "optional", "type": "string", "description": "Zipcode", "example": "", "default": "94104" } ] }, { "name": "customerEngagement", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "CustomerEngagement", "description": "", "modelRef": "#/components/schemas/CustomerEngagement", "schema": [ { "name": "aboutMe", "kind": "optional", "type": "boolean", "description": "True if customer added a short bio or about me to the profile", "example": "", "default": false }, { "name": "communityPostsWritten", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ListProperties", "description": "", "modelRef": "#/components/schemas/ListProperties", "schema": [ { "name": "inUse", "kind": "optional", "type": "boolean", "description": "Indicates whether the feature is in use, for example if a customer is subscribed to a newsletter, has items in his wishlist etc.", "example": "", "default": true }, { "name": "itemInListCount", "kind": "optional", "type": "integer", "description": "Number of items in the list", "example": 0, "default": 4 }, { "name": "updateTimes", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "UpdateTimes", "description": "", "modelRef": "#/components/schemas/UpdateTimes", "schema": [ { "name": "creationTime", "kind": "required", "type": "number", "description": "Time item was first entered by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastModifiedTime", "kind": "optional", "type": "number", "description": "Time item was last modified by the customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastUsed", "kind": "optional", "type": "number", "description": "Time item was last used by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448560456 }, { "name": "removalTime", "kind": "optional", "type": "number", "description": "Time item was removed by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448895522 } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "enableDeviceLocation", "kind": "optional", "type": "boolean", "description": "Set to True if the user has allowed the app to track their location.", "example": "", "default": false }, { "name": "extendedBioOrDescription", "kind": "optional", "type": "boolean", "description": "True if account owner added an extended info/bio/description paragraph to their profile", "example": "", "default": false }, { "name": "followersCount", "kind": "optional", "type": "integer", "description": "Number of followers of customer's account, or number of likes to user's profile", "example": 0, "default": 105 }, { "name": "followingCount", "kind": "optional", "type": "integer", "description": "Number of other users the customer is following, or number of likes customer gave to other users' profiles", "example": 0, "default": 230 }, { "name": "invites", "kind": "optional", "type": "array", "description": "Invites to merchant's site customer sent and received", "modelRef": "#/components/schemas/Invite", "customType": "Invite[]", "schema": [ { "name": "invitationCounterpartyPhone", "kind": "optional", "type": "string", "description": "Invitation sender/recipient phone number", "example": "", "default": "+12126667777" }, { "name": "sent", "kind": "optional", "type": "number", "description": "Time invite was sent in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1420955538 }, { "name": "type", "kind": "required", "type": "string", "description": "Type of invite", "example": "", "default": "SENT" } ] }, { "name": "likedItems", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ListProperties", "description": "", "modelRef": "#/components/schemas/ListProperties", "schema": [ { "name": "inUse", "kind": "optional", "type": "boolean", "description": "Indicates whether the feature is in use, for example if a customer is subscribed to a newsletter, has items in his wishlist etc.", "example": "", "default": true }, { "name": "itemInListCount", "kind": "optional", "type": "integer", "description": "Number of items in the list", "example": 0, "default": 4 }, { "name": "updateTimes", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "UpdateTimes", "description": "", "modelRef": "#/components/schemas/UpdateTimes", "schema": [ { "name": "creationTime", "kind": "required", "type": "number", "description": "Time item was first entered by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastModifiedTime", "kind": "optional", "type": "number", "description": "Time item was last modified by the customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastUsed", "kind": "optional", "type": "number", "description": "Time item was last used by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448560456 }, { "name": "removalTime", "kind": "optional", "type": "number", "description": "Time item was removed by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448895522 } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "messagesReceived", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ListProperties", "description": "", "modelRef": "#/components/schemas/ListProperties", "schema": [ { "name": "inUse", "kind": "optional", "type": "boolean", "description": "Indicates whether the feature is in use, for example if a customer is subscribed to a newsletter, has items in his wishlist etc.", "example": "", "default": true }, { "name": "itemInListCount", "kind": "optional", "type": "integer", "description": "Number of items in the list", "example": 0, "default": 4 }, { "name": "updateTimes", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "UpdateTimes", "description": "", "modelRef": "#/components/schemas/UpdateTimes", "schema": [ { "name": "creationTime", "kind": "required", "type": "number", "description": "Time item was first entered by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastModifiedTime", "kind": "optional", "type": "number", "description": "Time item was last modified by the customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastUsed", "kind": "optional", "type": "number", "description": "Time item was last used by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448560456 }, { "name": "removalTime", "kind": "optional", "type": "number", "description": "Time item was removed by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448895522 } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "messagesSent", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ListProperties", "description": "", "modelRef": "#/components/schemas/ListProperties", "schema": [ { "name": "inUse", "kind": "optional", "type": "boolean", "description": "Indicates whether the feature is in use, for example if a customer is subscribed to a newsletter, has items in his wishlist etc.", "example": "", "default": true }, { "name": "itemInListCount", "kind": "optional", "type": "integer", "description": "Number of items in the list", "example": 0, "default": 4 }, { "name": "updateTimes", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "UpdateTimes", "description": "", "modelRef": "#/components/schemas/UpdateTimes", "schema": [ { "name": "creationTime", "kind": "required", "type": "number", "description": "Time item was first entered by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastModifiedTime", "kind": "optional", "type": "number", "description": "Time item was last modified by the customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastUsed", "kind": "optional", "type": "number", "description": "Time item was last used by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448560456 }, { "name": "removalTime", "kind": "optional", "type": "number", "description": "Time item was removed by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448895522 } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "newsletters", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ListProperties", "description": "", "modelRef": "#/components/schemas/ListProperties", "schema": [ { "name": "inUse", "kind": "optional", "type": "boolean", "description": "Indicates whether the feature is in use, for example if a customer is subscribed to a newsletter, has items in his wishlist etc.", "example": "", "default": true }, { "name": "itemInListCount", "kind": "optional", "type": "integer", "description": "Number of items in the list", "example": 0, "default": 4 }, { "name": "updateTimes", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "UpdateTimes", "description": "", "modelRef": "#/components/schemas/UpdateTimes", "schema": [ { "name": "creationTime", "kind": "required", "type": "number", "description": "Time item was first entered by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastModifiedTime", "kind": "optional", "type": "number", "description": "Time item was last modified by the customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastUsed", "kind": "optional", "type": "number", "description": "Time item was last used by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448560456 }, { "name": "removalTime", "kind": "optional", "type": "number", "description": "Time item was removed by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448895522 } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "profileLogo", "kind": "optional", "type": "boolean", "description": "True if account owner added a non-default logo to their account", "example": "", "default": false }, { "name": "profilePicture", "kind": "optional", "type": "boolean", "description": "True if customer added a profile picture", "example": "", "default": true }, { "name": "requestedDemo", "kind": "optional", "type": "boolean", "description": "True if account owner requested to schedule a walthrough or demo of the site", "example": "", "default": true }, { "name": "reviewsWritten", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ListProperties", "description": "", "modelRef": "#/components/schemas/ListProperties", "schema": [ { "name": "inUse", "kind": "optional", "type": "boolean", "description": "Indicates whether the feature is in use, for example if a customer is subscribed to a newsletter, has items in his wishlist etc.", "example": "", "default": true }, { "name": "itemInListCount", "kind": "optional", "type": "integer", "description": "Number of items in the list", "example": 0, "default": 4 }, { "name": "updateTimes", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "UpdateTimes", "description": "", "modelRef": "#/components/schemas/UpdateTimes", "schema": [ { "name": "creationTime", "kind": "required", "type": "number", "description": "Time item was first entered by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastModifiedTime", "kind": "optional", "type": "number", "description": "Time item was last modified by the customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastUsed", "kind": "optional", "type": "number", "description": "Time item was last used by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448560456 }, { "name": "removalTime", "kind": "optional", "type": "number", "description": "Time item was removed by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448895522 } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "savedLocations", "kind": "optional", "type": "array", "description": "Saved locations in account.", "modelRef": "#/components/schemas/ExactLocation", "customType": "ExactLocation[]", "schema": [ { "name": "latitude", "kind": "required", "type": "number", "description": "Latitude in Decimal Degrees (WGS84)", "example": "", "default": 32.07332 }, { "name": "longitude", "kind": "required", "type": "number", "description": "Longitude in Decimal Degrees (WGS84)", "example": "", "default": 34.79675 }, { "name": "source", "kind": "required", "type": "string", "description": "Source of location data", "example": "", "default": "MOBILE" } ] }, { "name": "sharedItems", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ListProperties", "description": "", "modelRef": "#/components/schemas/ListProperties", "schema": [ { "name": "inUse", "kind": "optional", "type": "boolean", "description": "Indicates whether the feature is in use, for example if a customer is subscribed to a newsletter, has items in his wishlist etc.", "example": "", "default": true }, { "name": "itemInListCount", "kind": "optional", "type": "integer", "description": "Number of items in the list", "example": 0, "default": 4 }, { "name": "updateTimes", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "UpdateTimes", "description": "", "modelRef": "#/components/schemas/UpdateTimes", "schema": [ { "name": "creationTime", "kind": "required", "type": "number", "description": "Time item was first entered by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastModifiedTime", "kind": "optional", "type": "number", "description": "Time item was last modified by the customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastUsed", "kind": "optional", "type": "number", "description": "Time item was last used by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448560456 }, { "name": "removalTime", "kind": "optional", "type": "number", "description": "Time item was removed by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448895522 } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "signedUpForPushNotifications", "kind": "optional", "type": "boolean", "description": "True if customer asked to receive push notifications from the merchant.", "example": "", "default": true }, { "name": "signedUpForSMSUpdates", "kind": "optional", "type": "boolean", "description": "True if customer asked to receive SMS updates from the merchant regarding discounts, promotions, etc.", "example": "", "default": true }, { "name": "wishlist", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ListProperties", "description": "", "modelRef": "#/components/schemas/ListProperties", "schema": [ { "name": "inUse", "kind": "optional", "type": "boolean", "description": "Indicates whether the feature is in use, for example if a customer is subscribed to a newsletter, has items in his wishlist etc.", "example": "", "default": true }, { "name": "itemInListCount", "kind": "optional", "type": "integer", "description": "Number of items in the list", "example": 0, "default": 4 }, { "name": "updateTimes", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "UpdateTimes", "description": "", "modelRef": "#/components/schemas/UpdateTimes", "schema": [ { "name": "creationTime", "kind": "required", "type": "number", "description": "Time item was first entered by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastModifiedTime", "kind": "optional", "type": "number", "description": "Time item was last modified by the customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "lastUsed", "kind": "optional", "type": "number", "description": "Time item was last used by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448560456 }, { "name": "removalTime", "kind": "optional", "type": "number", "description": "Time item was removed by customer in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448895522 } ] } ], "schema": [] } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "emailsInAccount", "kind": "optional", "type": "array", "description": "All email addresses saved in account", "modelRef": "#/components/schemas/Email", "customType": "Email[]", "schema": [ { "name": "email", "kind": "required", "type": "string", "description": "Email address", "example": "", "default": "john_s@test.com" }, { "name": "emailVerification", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Verification", "description": "", "modelRef": "#/components/schemas/Verification", "schema": [ { "name": "sent", "kind": "required", "type": "boolean", "description": "True if verification email was sent to email address or verification SMS was sent to phone number", "example": "", "default": true }, { "name": "timeSent", "kind": "optional", "type": "number", "description": "Date verification email or SMS was sent in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1389567341 }, { "name": "verified", "kind": "required", "type": "boolean", "description": "True if customer received email verification message to this address and clicked-through back to merchant's site, or received SMS message and enterd code in merchant's site (two-factor authentication)", "example": "", "default": false } ] } ], "schema": [] } ] }, { "name": "paymentMethodsInAccount", "kind": "optional", "type": "array", "description": "All payment methods saved in account", "modelRef": "#/components/schemas/Payment", "customType": "Payment[]", "schema": [ { "name": "allowedMerchantInitiatedTransactions", "kind": "optional", "type": "boolean", "description": "True if customer chose to allow future transactions to initiate without taking further action (payment that's initiated on behalf of a customer)", "example": "", "default": false }, { "name": "amount", "kind": "required", "type": "object", "description": "Amount paid with this payment instrument", "modelRef": "#/components/schemas/Amount", "customType": "Amount", "schema": [ { "name": "amountLocalCurrency", "kind": "optional", "type": "string", "description": "Transaction amount in currency chosen by the buyer", "example": "", "default": "105.55" }, { "name": "amountUSD", "kind": "optional", "type": "string", "description": "Transaction amount in USD", "example": "", "default": "99.95" }, { "name": "currency", "kind": "optional", "type": "string", "description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code", "example": "", "default": "CAD" } ] }, { "name": "androidPay", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "TokenizedCreditCard", "description": "", "modelRef": "#/components/schemas/TokenizedCreditCard", "schema": [ { "name": "cardBank", "kind": "optional", "type": "string", "description": "Credit card's issuing bank", "example": "", "default": "Chase" }, { "name": "cardBrand", "kind": "optional", "type": "string", "description": "Credit card's issuer brand", "example": "", "default": "VISA" }, { "name": "cardType", "kind": "optional", "type": "string", "description": "Payment card type", "example": "", "default": "CREDIT" }, { "name": "countryOfIssuance", "kind": "optional", "type": "string", "description": "Credit card's issuing country, two-letter ISO 3166-1 alpha-2 country code", "example": "", "default": "US" }, { "name": "creationTime", "kind": "optional", "type": "number", "description": "Time the card was tokenized by the merchant in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1430997968 }, { "name": "creditCardCorrelationId", "kind": "optional", "type": "string", "description": "Credit card - CorrelationId that was recieved by the init 3DS API", "example": "" }, { "name": "expirationMonth", "kind": "required", "type": "string", "description": "Credit card's expiration month, in MM format", "example": "", "default": "03" }, { "name": "expirationYear", "kind": "required", "type": "string", "description": "Credit card's expiration year, in YYYY format", "example": "", "default": "2018" }, { "name": "fullResponsePayload", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "GeneralPayloadMap", "description": "", "modelRef": "#/components/schemas/GeneralPayloadMap", "schema": [] } ], "schema": [] }, { "name": "lastFourDigits", "kind": "optional", "type": "string", "description": "Credit card's last 4 digits", "example": "", "default": "4242" }, { "name": "nameOnCard", "kind": "optional", "type": "string", "description": "Cardholder's full name", "example": "", "default": "John R. H. Smith" }, { "name": "paymentProcessorData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "PaymentProcessorData", "description": "", "modelRef": "#/components/schemas/PaymentProcessorData", "schema": [ { "name": "processorName", "kind": "optional", "type": "string", "description": "Payment processor name", "example": "", "default": "Chase Paymentech" }, { "name": "processorTransactionId", "kind": "optional", "type": "string", "description": "Unique transaction identifier (sent by processor)", "example": "", "default": "fjdsS46sdklFd20" } ] } ], "schema": [] }, { "name": "threeDSecure", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ThreeDSecureInput", "description": "", "modelRef": "#/components/schemas/ThreeDSecureInput", "schema": [ { "name": "acquirerData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "AcquirerData", "description": "", "modelRef": "#/components/schemas/AcquirerData", "schema": [ { "name": "acquirerBIN", "kind": "optional", "type": "string", "description": "Bank acquirer BIN (Bank Identification Number)", "example": "", "default": "457173" }, { "name": "acquirerCountry", "kind": "optional", "type": "string", "description": "Acquirer country", "example": "", "default": "US" }, { "name": "acquirerMerchantId", "kind": "optional", "type": "string", "description": "Merchant ID (MID) - merchant ID is a unique code provided to merchants by their payment processor", "example": "", "default": "5245020244654" }, { "name": "acquirerMerchantName", "kind": "optional", "type": "string", "description": "Merchant Name as appearing in processor records", "example": "", "default": "Simple T-shirt" }, { "name": "acquirerName", "kind": "optional", "type": "string", "description": "Bank acquirer Name", "example": "", "default": "Barclays" }, { "name": "merchantCategoryCode", "kind": "optional", "type": "number", "description": "A Merchant Category Code (MCC) is a four-digit number listed in ISO 18245 for retail financial services. MCC is used to classify the business by the type of goods or services it provides.", "example": "", "default": 5655 }, { "name": "merchantCountryCode", "kind": "optional", "type": "number", "description": "Merchant country code", "example": "", "default": 840 } ] } ], "schema": [] }, { "name": "challengeIndicator", "kind": "optional", "type": "string", "description": "Request your preference regarding the executing of 3DS challange regardless of Forter's decision and recommendation", "example": "", "default": "NO_PREFERENCE" }, { "name": "execute3ds", "kind": "optional", "type": "string", "description": "Request your preference regarding the execution of 3DS", "example": "", "default": "DYNAMIC_FORTER_DECISION" }, { "name": "forcePsd2Exemption", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ThreeDSecureForcePsd2Exemption", "description": "", "modelRef": "#/components/schemas/ThreeDSecureForcePsd2Exemption", "schema": [ { "name": "channel", "kind": "required", "type": "string", "description": "The channel through which the exemption is requested", "example": "", "default": "THREEDS_RAILS" }, { "name": "type", "kind": "required", "type": "string", "description": "The type of exemption requested", "example": "", "default": "LOW_VALUE" } ] } ], "schema": [] }, { "name": "requestChallenge", "kind": "optional", "type": "boolean", "description": "Indicates if a 3DS challenge should be requested from the Issuer ACS.", "example": "", "default": false }, { "name": "threeDSServerTransID", "kind": "required", "type": "string", "description": "Universally unique transaction identifier assigned by the 3DS Server to identify a single transaction generated by the Init 3DS API and used to link the init call to the order call", "example": "", "default": "26d648a9-da8a-4f8b-a76d-094801d2fd45" }, { "name": "threeDsExecutor", "kind": "optional", "type": "string", "description": "Request your preference regarding the 3DS executor. To be used only for an edge case, where a merchant with 3DS execution demands Forter to not execute 3DS on a limited subset of TXs", "example": "" } ] } ], "schema": [] }, { "name": "token", "kind": "required", "type": "string", "description": "Credit card token used by the merchant", "example": "", "default": "tkn-77620C360132856A103477D2959967AB" }, { "name": "tokenType", "kind": "optional", "type": "string", "description": "Token type, determined by the party/protocol the token created by", "example": "" }, { "name": "verificationResults", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "CreditCardVerification", "description": "", "modelRef": "#/components/schemas/CreditCardVerification", "schema": [ { "name": "authorizationCode", "kind": "optional", "type": "string", "description": "Card authorization code from payment gateway", "example": "", "default": "A33244" }, { "name": "authorizationProcessedWith3DS", "kind": "optional", "type": "boolean", "description": "3DSecure - indicating that the 3DS results were sent to processor and have been used during the authorization", "example": "", "default": true }, { "name": "avsFullResult", "kind": "optional", "type": "string", "description": "Procesor response code for AVS. Only required in cases where all AVS results (zipcode, street address, and name when available) arrive as one string", "example": "", "default": "Y" }, { "name": "avsNameResult", "kind": "optional", "type": "string", "description": "Name portion of card's AVS result (when available)", "example": "", "default": "M" }, { "name": "avsStreetResult", "kind": "optional", "type": "string", "description": "Street address portion of card's AVS result", "example": "", "default": "N" }, { "name": "avsZipResult", "kind": "optional", "type": "string", "description": "Zipcode portion of card's AVS result", "example": "", "default": "M" }, { "name": "cavvResult", "kind": "optional", "type": "string", "description": "3DSecure - Authentication Value (CAVV / AAV for 3DS1) recieved from authorization/Authentication response", "example": "", "default": "VYboNwcsB3F9gTIsbaUjvEuLW0o=" }, { "name": "cvvResult", "kind": "optional", "type": "string", "description": "CVV result (if no data please send the value U)", "example": "", "default": "M" }, { "name": "eciValue", "kind": "optional", "type": "string", "description": "3DSecure - ECI value recieved from authorization/authentication response", "example": "", "default": "05" }, { "name": "liabilityShift", "kind": "optional", "type": "boolean", "description": "3DSecure - liability shift - indicate whether the chargeback liability shifted to the card issuer", "example": "", "default": true }, { "name": "processorResponseCode", "kind": "optional", "type": "string", "description": "Response code received from processor", "example": "", "default": "D23" }, { "name": "processorResponseText", "kind": "optional", "type": "string", "description": "Response text received from processor", "example": "", "default": "Stolen card" }, { "name": "threeDsStatus", "kind": "optional", "type": "string", "description": "3DSecure - Status text received from 3D secure vendor", "example": "", "default": "Cardholder authenticated" }, { "name": "threeDsVersion", "kind": "optional", "type": "string", "description": "3DSecure - Version used in the transaction", "example": "", "default": "2.1.0" } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "applePay", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "TokenizedCreditCard", "description": "", "modelRef": "#/components/schemas/TokenizedCreditCard", "schema": [ { "name": "cardBank", "kind": "optional", "type": "string", "description": "Credit card's issuing bank", "example": "", "default": "Chase" }, { "name": "cardBrand", "kind": "optional", "type": "string", "description": "Credit card's issuer brand", "example": "", "default": "VISA" }, { "name": "cardType", "kind": "optional", "type": "string", "description": "Payment card type", "example": "", "default": "CREDIT" }, { "name": "countryOfIssuance", "kind": "optional", "type": "string", "description": "Credit card's issuing country, two-letter ISO 3166-1 alpha-2 country code", "example": "", "default": "US" }, { "name": "creationTime", "kind": "optional", "type": "number", "description": "Time the card was tokenized by the merchant in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1430997968 }, { "name": "creditCardCorrelationId", "kind": "optional", "type": "string", "description": "Credit card - CorrelationId that was recieved by the init 3DS API", "example": "" }, { "name": "expirationMonth", "kind": "required", "type": "string", "description": "Credit card's expiration month, in MM format", "example": "", "default": "03" }, { "name": "expirationYear", "kind": "required", "type": "string", "description": "Credit card's expiration year, in YYYY format", "example": "", "default": "2018" }, { "name": "fullResponsePayload", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "GeneralPayloadMap", "description": "", "modelRef": "#/components/schemas/GeneralPayloadMap", "schema": [] } ], "schema": [] }, { "name": "lastFourDigits", "kind": "optional", "type": "string", "description": "Credit card's last 4 digits", "example": "", "default": "4242" }, { "name": "nameOnCard", "kind": "optional", "type": "string", "description": "Cardholder's full name", "example": "", "default": "John R. H. Smith" }, { "name": "paymentProcessorData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "PaymentProcessorData", "description": "", "modelRef": "#/components/schemas/PaymentProcessorData", "schema": [ { "name": "processorName", "kind": "optional", "type": "string", "description": "Payment processor name", "example": "", "default": "Chase Paymentech" }, { "name": "processorTransactionId", "kind": "optional", "type": "string", "description": "Unique transaction identifier (sent by processor)", "example": "", "default": "fjdsS46sdklFd20" } ] } ], "schema": [] }, { "name": "threeDSecure", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ThreeDSecureInput", "description": "", "modelRef": "#/components/schemas/ThreeDSecureInput", "schema": [ { "name": "acquirerData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "AcquirerData", "description": "", "modelRef": "#/components/schemas/AcquirerData", "schema": [ { "name": "acquirerBIN", "kind": "optional", "type": "string", "description": "Bank acquirer BIN (Bank Identification Number)", "example": "", "default": "457173" }, { "name": "acquirerCountry", "kind": "optional", "type": "string", "description": "Acquirer country", "example": "", "default": "US" }, { "name": "acquirerMerchantId", "kind": "optional", "type": "string", "description": "Merchant ID (MID) - merchant ID is a unique code provided to merchants by their payment processor", "example": "", "default": "5245020244654" }, { "name": "acquirerMerchantName", "kind": "optional", "type": "string", "description": "Merchant Name as appearing in processor records", "example": "", "default": "Simple T-shirt" }, { "name": "acquirerName", "kind": "optional", "type": "string", "description": "Bank acquirer Name", "example": "", "default": "Barclays" }, { "name": "merchantCategoryCode", "kind": "optional", "type": "number", "description": "A Merchant Category Code (MCC) is a four-digit number listed in ISO 18245 for retail financial services. MCC is used to classify the business by the type of goods or services it provides.", "example": "", "default": 5655 }, { "name": "merchantCountryCode", "kind": "optional", "type": "number", "description": "Merchant country code", "example": "", "default": 840 } ] } ], "schema": [] }, { "name": "challengeIndicator", "kind": "optional", "type": "string", "description": "Request your preference regarding the executing of 3DS challange regardless of Forter's decision and recommendation", "example": "", "default": "NO_PREFERENCE" }, { "name": "execute3ds", "kind": "optional", "type": "string", "description": "Request your preference regarding the execution of 3DS", "example": "", "default": "DYNAMIC_FORTER_DECISION" }, { "name": "forcePsd2Exemption", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ThreeDSecureForcePsd2Exemption", "description": "", "modelRef": "#/components/schemas/ThreeDSecureForcePsd2Exemption", "schema": [ { "name": "channel", "kind": "required", "type": "string", "description": "The channel through which the exemption is requested", "example": "", "default": "THREEDS_RAILS" }, { "name": "type", "kind": "required", "type": "string", "description": "The type of exemption requested", "example": "", "default": "LOW_VALUE" } ] } ], "schema": [] }, { "name": "requestChallenge", "kind": "optional", "type": "boolean", "description": "Indicates if a 3DS challenge should be requested from the Issuer ACS.", "example": "", "default": false }, { "name": "threeDSServerTransID", "kind": "required", "type": "string", "description": "Universally unique transaction identifier assigned by the 3DS Server to identify a single transaction generated by the Init 3DS API and used to link the init call to the order call", "example": "", "default": "26d648a9-da8a-4f8b-a76d-094801d2fd45" }, { "name": "threeDsExecutor", "kind": "optional", "type": "string", "description": "Request your preference regarding the 3DS executor. To be used only for an edge case, where a merchant with 3DS execution demands Forter to not execute 3DS on a limited subset of TXs", "example": "" } ] } ], "schema": [] }, { "name": "token", "kind": "required", "type": "string", "description": "Credit card token used by the merchant", "example": "", "default": "tkn-77620C360132856A103477D2959967AB" }, { "name": "tokenType", "kind": "optional", "type": "string", "description": "Token type, determined by the party/protocol the token created by", "example": "" }, { "name": "verificationResults", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "CreditCardVerification", "description": "", "modelRef": "#/components/schemas/CreditCardVerification", "schema": [ { "name": "authorizationCode", "kind": "optional", "type": "string", "description": "Card authorization code from payment gateway", "example": "", "default": "A33244" }, { "name": "authorizationProcessedWith3DS", "kind": "optional", "type": "boolean", "description": "3DSecure - indicating that the 3DS results were sent to processor and have been used during the authorization", "example": "", "default": true }, { "name": "avsFullResult", "kind": "optional", "type": "string", "description": "Procesor response code for AVS. Only required in cases where all AVS results (zipcode, street address, and name when available) arrive as one string", "example": "", "default": "Y" }, { "name": "avsNameResult", "kind": "optional", "type": "string", "description": "Name portion of card's AVS result (when available)", "example": "", "default": "M" }, { "name": "avsStreetResult", "kind": "optional", "type": "string", "description": "Street address portion of card's AVS result", "example": "", "default": "N" }, { "name": "avsZipResult", "kind": "optional", "type": "string", "description": "Zipcode portion of card's AVS result", "example": "", "default": "M" }, { "name": "cavvResult", "kind": "optional", "type": "string", "description": "3DSecure - Authentication Value (CAVV / AAV for 3DS1) recieved from authorization/Authentication response", "example": "", "default": "VYboNwcsB3F9gTIsbaUjvEuLW0o=" }, { "name": "cvvResult", "kind": "optional", "type": "string", "description": "CVV result (if no data please send the value U)", "example": "", "default": "M" }, { "name": "eciValue", "kind": "optional", "type": "string", "description": "3DSecure - ECI value recieved from authorization/authentication response", "example": "", "default": "05" }, { "name": "liabilityShift", "kind": "optional", "type": "boolean", "description": "3DSecure - liability shift - indicate whether the chargeback liability shifted to the card issuer", "example": "", "default": true }, { "name": "processorResponseCode", "kind": "optional", "type": "string", "description": "Response code received from processor", "example": "", "default": "D23" }, { "name": "processorResponseText", "kind": "optional", "type": "string", "description": "Response text received from processor", "example": "", "default": "Stolen card" }, { "name": "threeDsStatus", "kind": "optional", "type": "string", "description": "3DSecure - Status text received from 3D secure vendor", "example": "", "default": "Cardholder authenticated" }, { "name": "threeDsVersion", "kind": "optional", "type": "string", "description": "3DSecure - Version used in the transaction", "example": "", "default": "2.1.0" } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "bankTransfer", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "BankTransfer", "description": "", "modelRef": "#/components/schemas/BankTransfer", "schema": [ { "name": "accountHolderFirstName", "kind": "optional", "type": "string", "description": "Bank account holder first name", "example": "", "default": "John" }, { "name": "accountHolderLastName", "kind": "optional", "type": "string", "description": "Bank account holder last name", "example": "", "default": "Smith" }, { "name": "achProcessingType", "kind": "optional", "type": "string", "description": "Type of ACH processing used in the transaction", "example": "", "default": "SAME_DAY_ACH" }, { "name": "bankAccountIdentifier", "kind": "optional", "type": "string", "description": "Bank account unique identifier (IBAN or equivalent)", "example": "", "default": "TEST63TEST1212121212" }, { "name": "bankAccountType", "kind": "optional", "type": "string", "description": "Type of bank account payment is made from (e.g. savings/checking, etc.)", "example": "", "default": "Savings" }, { "name": "bankName", "kind": "optional", "type": "string", "description": "Name of bank payment is made from", "example": "", "default": "Citigroup" }, { "name": "paymentGatewayData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "PaymentGatewayData", "description": "", "modelRef": "#/components/schemas/PaymentGatewayData", "schema": [ { "name": "gatewayName", "kind": "optional", "type": "string", "description": "Payment gateway name", "example": "", "default": "Braintree" }, { "name": "gatewayTransactionId", "kind": "optional", "type": "string", "description": "Unique transaction identifier (sent by gateway)", "example": "", "default": "fjdsS46sdklFd20" } ] } ], "schema": [] }, { "name": "paymentSuccessStatus", "kind": "optional", "type": "string", "description": "Response text as received from the service provider", "example": "", "default": "Payment Successful" }, { "name": "serviceName", "kind": "optional", "type": "string", "description": "Payment method name", "example": "", "default": "Direct Debit" } ] } ], "schema": [] }, { "name": "billingDetails", "kind": "required", "type": "object", "description": "Billing details associated with this payment method", "modelRef": "#/components/schemas/Person", "customType": "Person", "schema": [ { "name": "address", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Address", "description": "", "modelRef": "#/components/schemas/Address", "schema": [ { "name": "address1", "kind": "optional", "type": "string", "description": "Street-level address. Required when full address details are available", "example": "", "default": "235 Montgomery st." }, { "name": "address2", "kind": "optional", "type": "string", "description": "Unit-level address", "example": "", "default": "Ste. 1110" }, { "name": "city", "kind": "optional", "type": "string", "description": "City. Required when full address details are available", "example": "", "default": "San Francisco" }, { "name": "company", "kind": "optional", "type": "string", "description": "Company", "example": "", "default": "Generic Corp. ltd." }, { "name": "country", "kind": "required", "type": "string", "description": "Country, two-letter ISO 3166-1 alpha-2 country code", "example": "", "default": "US" }, { "name": "region", "kind": "optional", "type": "string", "description": "Top-level administrative subdivision - state/province/department/etc. Can be either abbreviated format or full name (NY/New York)", "example": "", "default": "CA" }, { "name": "savedData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "SavedData", "description": "", "modelRef": "#/components/schemas/SavedData", "schema": [ { "name": "choseToSaveData", "kind": "optional", "type": "boolean", "description": "True if customer chose to save data in the account for future use", "example": "", "default": false }, { "name": "usedSavedData", "kind": "required", "type": "boolean", "description": "True if customer chose to use data saved in the account", "example": "", "default": true } ] } ], "schema": [] }, { "name": "zip", "kind": "optional", "type": "string", "description": "Zipcode", "example": "", "default": "94104" } ] } ], "schema": [] }, { "name": "allAdditionalVerificationDocuments", "kind": "optional", "type": "array", "description": "Additional identification documents details and verification", "modelRef": "#/components/schemas/AdditionalVerificationDocuments", "customType": "AdditionalVerificationDocuments[]", "schema": [ { "name": "documentDateOfBirth", "kind": "optional", "type": "string", "description": "Date of birth as appears on the document. Use YYYY-MM-DD format.", "example": "", "default": "1991-01-09" }, { "name": "documentExpiration", "kind": "optional", "type": "string", "description": "Document's exipration date. Use YYYY-MM-DD format.", "example": "", "default": "2017-01-15" }, { "name": "documentFirstName", "kind": "optional", "type": "string", "description": "First name as appears on the document", "example": "", "default": "John" }, { "name": "documentIssuingState", "kind": "optional", "type": "string", "description": "Document issuing state or region", "example": "", "default": "NY" }, { "name": "documentLastName", "kind": "optional", "type": "string", "description": "Last name as appears on the document", "example": "", "default": "Smith" }, { "name": "documentNumber", "kind": "optional", "type": "string", "description": "Official document's number (e.g. passport number, driving license number, etc.)", "example": "", "default": "20439190" }, { "name": "documentSource", "kind": "required", "type": "string", "description": "Source of document (e.g. uploaded file, captured by camera, typed in by customer, etc.)", "example": "", "default": "UPLOADED_FILE" }, { "name": "documentStatus", "kind": "optional", "type": "string", "description": "Status of verification document (e.g. sent to customer, received by customer, abandoned by customer ).", "example": "", "default": "SENT_TO_CLIENT" }, { "name": "documentType", "kind": "required", "type": "string", "description": "Type of document (Passport, ID, Driving license)", "example": "", "default": "Passport" }, { "name": "documentVerificationServiceAnswer", "kind": "optional", "type": "string", "description": "Answer received from 3rd party document verification services", "example": "", "default": "APPROVED" }, { "name": "documentVerificationServiceName", "kind": "optional", "type": "string", "description": "Name of 3rd party document verifcation service", "example": "", "default": "IDVerification.com" }, { "name": "documentVerificationServiceResponsePayload", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "GeneralPayloadMap", "description": "", "modelRef": "#/components/schemas/GeneralPayloadMap", "schema": [] } ], "schema": [] }, { "name": "documentVerified", "kind": "optional", "type": "boolean", "description": "True if document was verified as authentic by merchant or 3rd party service", "example": "", "default": true }, { "name": "eventTime", "kind": "optional", "type": "number", "description": "Time of event in seconds since unix epoch (UTC, Jan 1, 1970). For example, 01/01/2015 00:00 is 1420070400", "example": "", "default": 1420070400 }, { "name": "nationality", "kind": "optional", "type": "string", "description": "Document holder's nationality", "example": "", "default": "US" } ] }, { "name": "employmentInformation", "kind": "optional", "type": "array", "description": "Credit applicant's employment information", "modelRef": "#/components/schemas/EmploymentInformation", "customType": "EmploymentInformation[]", "schema": [ { "name": "employerAddress", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Address", "description": "", "modelRef": "#/components/schemas/Address", "schema": [ { "name": "address1", "kind": "optional", "type": "string", "description": "Street-level address. Required when full address details are available", "example": "", "default": "235 Montgomery st." }, { "name": "address2", "kind": "optional", "type": "string", "description": "Unit-level address", "example": "", "default": "Ste. 1110" }, { "name": "city", "kind": "optional", "type": "string", "description": "City. Required when full address details are available", "example": "", "default": "San Francisco" }, { "name": "company", "kind": "optional", "type": "string", "description": "Company", "example": "", "default": "Generic Corp. ltd." }, { "name": "country", "kind": "required", "type": "string", "description": "Country, two-letter ISO 3166-1 alpha-2 country code", "example": "", "default": "US" }, { "name": "region", "kind": "optional", "type": "string", "description": "Top-level administrative subdivision - state/province/department/etc. Can be either abbreviated format or full name (NY/New York)", "example": "", "default": "CA" }, { "name": "savedData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "SavedData", "description": "", "modelRef": "#/components/schemas/SavedData", "schema": [ { "name": "", "description": "", "customType": "Max depth limit reached" } ] } ], "schema": [] }, { "name": "zip", "kind": "optional", "type": "string", "description": "Zipcode", "example": "", "default": "94104" } ] } ], "schema": [] }, { "name": "employerCompanySizeRange", "kind": "optional", "type": "string", "description": "Employing company's number of employees", "example": "", "default": "20" }, { "name": "employerIndustry", "kind": "optional", "type": "string", "description": "Employing company's industry", "example": "", "default": "Retail" }, { "name": "employerName", "kind": "required", "type": "string", "description": "Employing company's name", "example": "", "default": "Forter" }, { "name": "employerPhone", "kind": "optional", "type": "string", "description": "Employing company's phone", "example": "", "default": "+12126667777" }, { "name": "income", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Amount", "description": "", "modelRef": "#/components/schemas/Amount", "schema": [ { "name": "amountLocalCurrency", "kind": "optional", "type": "string", "description": "Transaction amount in currency chosen by the buyer", "example": "", "default": "105.55" }, { "name": "amountUSD", "kind": "optional", "type": "string", "description": "Transaction amount in USD", "example": "", "default": "99.95" }, { "name": "currency", "kind": "optional", "type": "string", "description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code", "example": "", "default": "CAD" } ] } ], "schema": [] }, { "name": "jobTitle", "kind": "optional", "type": "string", "description": "Job title", "example": "", "default": "Fraud Analyst" } ] }, { "name": "personalDetails", "kind": "required", "type": "object", "description": "Personal information such as name and birthdate", "modelRef": "#/components/schemas/PersonalDetails", "customType": "PersonalDetails", "schema": [ { "name": "birthdate", "kind": "optional", "type": "string", "description": "Date of birth. Use YYYY-MM-DD format.", "example": "", "default": "1987-05-22" }, { "name": "email", "kind": "optional", "type": "string", "description": "Email address", "example": "", "default": "john_s@test.com" }, { "name": "firstName", "kind": "optional", "type": "string", "description": "First name", "example": "", "default": "John" }, { "name": "fullName", "kind": "optional", "type": "string", "description": "Full name. Not Needed if firstName and LastName are provided independently.", "example": "", "default": "John Smith" }, { "name": "gender", "kind": "optional", "type": "string", "description": "Gender", "example": "", "default": "MALE" }, { "name": "lastName", "kind": "optional", "type": "string", "description": "Last name", "example": "", "default": "Smith" } ] }, { "name": "phone", "kind": "optional", "type": "array", "description": "Phone details", "modelRef": "#/components/schemas/Phone", "customType": "Phone[]", "schema": [ { "name": "phone", "kind": "required", "type": "string", "description": "Phone number including all country and local access codes", "example": "", "default": "15557654321" }, { "name": "smsVerified", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Verification", "description": "", "modelRef": "#/components/schemas/Verification", "schema": [ { "name": "sent", "kind": "required", "type": "boolean", "description": "True if verification email was sent to email address or verification SMS was sent to phone number", "example": "", "default": true }, { "name": "timeSent", "kind": "optional", "type": "number", "description": "Date verification email or SMS was sent in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1389567341 }, { "name": "verified", "kind": "required", "type": "boolean", "description": "True if customer received email verification message to this address and clicked-through back to merchant's site, or received SMS message and enterd code in merchant's site (two-factor authentication)", "example": "", "default": false } ] } ], "schema": [] } ] } ] }, { "name": "cameraCaptured", "kind": "optional", "type": "boolean", "description": "True if payment instrument details were captured by OCR from a picture. False if payment instrument details were manually typed in", "example": "", "default": true }, { "name": "cash", "kind": "optional", "type": "boolean", "description": "Payed with cash", "example": "", "default": false }, { "name": "creditCard", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "CreditCard", "description": "", "modelRef": "#/components/schemas/CreditCard", "schema": [ { "name": "bin", "kind": "required", "type": "string", "description": "Credit card's BIN (Bank Identification Number)", "example": "", "default": "42424242" }, { "name": "cardBank", "kind": "optional", "type": "string", "description": "Credit card's issuing bank", "example": "", "default": "Chase" }, { "name": "cardBrand", "kind": "optional", "type": "string", "description": "Credit Card's issuer brand", "example": "", "default": "VISA" }, { "name": "cardType", "kind": "optional", "type": "string", "description": "Payment card type", "example": "", "default": "CREDIT" }, { "name": "countryOfIssuance", "kind": "optional", "type": "string", "description": "Credit card's issuing country, two-letter ISO 3166-1 alpha-2 country code", "example": "", "default": "US" }, { "name": "creditCardCorrelationId", "kind": "optional", "type": "string", "description": "Credit card - CorrelationId that was recieved by the init 3DS API", "example": "" }, { "name": "expirationMonth", "kind": "required", "type": "string", "description": "Credit card's expiration month, in MM format", "example": "", "default": "03" }, { "name": "expirationYear", "kind": "required", "type": "string", "description": "Credit card's expiration year, in YYYY format", "example": "", "default": "2018" }, { "name": "fingerprint", "kind": "optional", "type": "string", "description": "Unique identifier for card (sent by gateway or processor)", "example": "", "default": "Xt5EWLLDS7FJjR1c" }, { "name": "fullCreditCard", "kind": "optional", "type": "string", "description": "Credit Card's full PAN - needed for the 3DS secure implementation", "example": "", "default": "2424242424242424" }, { "name": "fullResponsePayload", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "GeneralPayloadMap", "description": "", "modelRef": "#/components/schemas/GeneralPayloadMap", "schema": [] } ], "schema": [] }, { "name": "lastFourDigits", "kind": "required", "type": "string", "description": "Credit card's last 4 digits (For Amex, take 4 digits from last digit)", "example": "", "default": "4242" }, { "name": "nameOnCard", "kind": "required", "type": "string", "description": "Cardholder's full name", "example": "", "default": "John R. H. Smith" }, { "name": "paymentProcessorData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "PaymentProcessorData", "description": "", "modelRef": "#/components/schemas/PaymentProcessorData", "schema": [ { "name": "processorName", "kind": "optional", "type": "string", "description": "Payment processor name", "example": "", "default": "Chase Paymentech" }, { "name": "processorTransactionId", "kind": "optional", "type": "string", "description": "Unique transaction identifier (sent by processor)", "example": "", "default": "fjdsS46sdklFd20" } ] } ], "schema": [] }, { "name": "threeDSecure", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ThreeDSecureInput", "description": "", "modelRef": "#/components/schemas/ThreeDSecureInput", "schema": [ { "name": "acquirerData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "AcquirerData", "description": "", "modelRef": "#/components/schemas/AcquirerData", "schema": [ { "name": "acquirerBIN", "kind": "optional", "type": "string", "description": "Bank acquirer BIN (Bank Identification Number)", "example": "", "default": "457173" }, { "name": "acquirerCountry", "kind": "optional", "type": "string", "description": "Acquirer country", "example": "", "default": "US" }, { "name": "acquirerMerchantId", "kind": "optional", "type": "string", "description": "Merchant ID (MID) - merchant ID is a unique code provided to merchants by their payment processor", "example": "", "default": "5245020244654" }, { "name": "acquirerMerchantName", "kind": "optional", "type": "string", "description": "Merchant Name as appearing in processor records", "example": "", "default": "Simple T-shirt" }, { "name": "acquirerName", "kind": "optional", "type": "string", "description": "Bank acquirer Name", "example": "", "default": "Barclays" }, { "name": "merchantCategoryCode", "kind": "optional", "type": "number", "description": "A Merchant Category Code (MCC) is a four-digit number listed in ISO 18245 for retail financial services. MCC is used to classify the business by the type of goods or services it provides.", "example": "", "default": 5655 }, { "name": "merchantCountryCode", "kind": "optional", "type": "number", "description": "Merchant country code", "example": "", "default": 840 } ] } ], "schema": [] }, { "name": "challengeIndicator", "kind": "optional", "type": "string", "description": "Request your preference regarding the executing of 3DS challange regardless of Forter's decision and recommendation", "example": "", "default": "NO_PREFERENCE" }, { "name": "execute3ds", "kind": "optional", "type": "string", "description": "Request your preference regarding the execution of 3DS", "example": "", "default": "DYNAMIC_FORTER_DECISION" }, { "name": "forcePsd2Exemption", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ThreeDSecureForcePsd2Exemption", "description": "", "modelRef": "#/components/schemas/ThreeDSecureForcePsd2Exemption", "schema": [ { "name": "channel", "kind": "required", "type": "string", "description": "The channel through which the exemption is requested", "example": "", "default": "THREEDS_RAILS" }, { "name": "type", "kind": "required", "type": "string", "description": "The type of exemption requested", "example": "", "default": "LOW_VALUE" } ] } ], "schema": [] }, { "name": "requestChallenge", "kind": "optional", "type": "boolean", "description": "Indicates if a 3DS challenge should be requested from the Issuer ACS.", "example": "", "default": false }, { "name": "threeDSServerTransID", "kind": "required", "type": "string", "description": "Universally unique transaction identifier assigned by the 3DS Server to identify a single transaction generated by the Init 3DS API and used to link the init call to the order call", "example": "", "default": "26d648a9-da8a-4f8b-a76d-094801d2fd45" }, { "name": "threeDsExecutor", "kind": "optional", "type": "string", "description": "Request your preference regarding the 3DS executor. To be used only for an edge case, where a merchant with 3DS execution demands Forter to not execute 3DS on a limited subset of TXs", "example": "" } ] } ], "schema": [] }, { "name": "verificationResults", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "CreditCardVerification", "description": "", "modelRef": "#/components/schemas/CreditCardVerification", "schema": [ { "name": "authorizationCode", "kind": "optional", "type": "string", "description": "Card authorization code from payment gateway", "example": "", "default": "A33244" }, { "name": "authorizationProcessedWith3DS", "kind": "optional", "type": "boolean", "description": "3DSecure - indicating that the 3DS results were sent to processor and have been used during the authorization", "example": "", "default": true }, { "name": "avsFullResult", "kind": "optional", "type": "string", "description": "Procesor response code for AVS. Only required in cases where all AVS results (zipcode, street address, and name when available) arrive as one string", "example": "", "default": "Y" }, { "name": "avsNameResult", "kind": "optional", "type": "string", "description": "Name portion of card's AVS result (when available)", "example": "", "default": "M" }, { "name": "avsStreetResult", "kind": "optional", "type": "string", "description": "Street address portion of card's AVS result", "example": "", "default": "N" }, { "name": "avsZipResult", "kind": "optional", "type": "string", "description": "Zipcode portion of card's AVS result", "example": "", "default": "M" }, { "name": "cavvResult", "kind": "optional", "type": "string", "description": "3DSecure - Authentication Value (CAVV / AAV for 3DS1) recieved from authorization/Authentication response", "example": "", "default": "VYboNwcsB3F9gTIsbaUjvEuLW0o=" }, { "name": "cvvResult", "kind": "optional", "type": "string", "description": "CVV result (if no data please send the value U)", "example": "", "default": "M" }, { "name": "eciValue", "kind": "optional", "type": "string", "description": "3DSecure - ECI value recieved from authorization/authentication response", "example": "", "default": "05" }, { "name": "liabilityShift", "kind": "optional", "type": "boolean", "description": "3DSecure - liability shift - indicate whether the chargeback liability shifted to the card issuer", "example": "", "default": true }, { "name": "processorResponseCode", "kind": "optional", "type": "string", "description": "Response code received from processor", "example": "", "default": "D23" }, { "name": "processorResponseText", "kind": "optional", "type": "string", "description": "Response text received from processor", "example": "", "default": "Stolen card" }, { "name": "threeDsStatus", "kind": "optional", "type": "string", "description": "3DSecure - Status text received from 3D secure vendor", "example": "", "default": "Cardholder authenticated" }, { "name": "threeDsVersion", "kind": "optional", "type": "string", "description": "3DSecure - Version used in the transaction", "example": "", "default": "2.1.0" } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "creditLineDetails", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "CreditLineDetails", "description": "", "modelRef": "#/components/schemas/CreditLineDetails", "schema": [ { "name": "askedToIncreaseCreditLineLimit", "kind": "required", "type": "boolean", "description": "True if customer asked to increase credit line limit", "example": "", "default": false }, { "name": "creditLineLimitIncreaseMethod", "kind": "required", "type": "string", "description": "Method customer chose to ask to increase credit line limit - PRE_APPROVAL, AT_PURCHASE", "example": "", "default": "AT_PURCHASE" }, { "name": "currentCreditLineLimit", "kind": "required", "type": "object", "description": "Current limit that was set for the credit line", "modelRef": "#/components/schemas/Amount", "customType": "Amount", "schema": [ { "name": "amountLocalCurrency", "kind": "optional", "type": "string", "description": "Transaction amount in currency chosen by the buyer", "example": "", "default": "105.55" }, { "name": "amountUSD", "kind": "optional", "type": "string", "description": "Transaction amount in USD", "example": "", "default": "99.95" }, { "name": "currency", "kind": "optional", "type": "string", "description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code", "example": "", "default": "CAD" } ] }, { "name": "originalCreditLineLimit", "kind": "required", "type": "object", "description": "Original limit that was set for the credit line", "modelRef": "#/components/schemas/Amount", "customType": "Amount", "schema": [ { "name": "amountLocalCurrency", "kind": "optional", "type": "string", "description": "Transaction amount in currency chosen by the buyer", "example": "", "default": "105.55" }, { "name": "amountUSD", "kind": "optional", "type": "string", "description": "Transaction amount in USD", "example": "", "default": "99.95" }, { "name": "currency", "kind": "optional", "type": "string", "description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code", "example": "", "default": "CAD" } ] } ] } ], "schema": [] }, { "name": "cryptoWallet", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "CryptoWallet", "description": "", "modelRef": "#/components/schemas/CryptoWallet", "schema": [ { "name": "cryptoWalletName", "kind": "optional", "type": "string", "description": "Crypto wallet name", "example": "", "default": "CryptoWallet" }, { "name": "cryptoWalletPaymentId", "kind": "optional", "type": "string", "description": "Crypto wallet payment ID", "example": "", "default": "3JQiwG88SQvwihDAHg9M2EnqEisharz49c" }, { "name": "cryptoWalletType", "kind": "required", "type": "string", "description": "Crypto wallet type (Indicate whether wallet provider is internal to the site ecosystem)", "example": "", "default": "EXTERNAL" } ] } ], "schema": [] }, { "name": "digitalWallet", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "DigitalWallet", "description": "", "modelRef": "#/components/schemas/DigitalWallet", "schema": [ { "name": "digitalWalletName", "kind": "required", "type": "string", "description": "Digital wallet name", "example": "", "default": "ALIPAY" }, { "name": "digitalWalletPayerEmail", "kind": "optional", "type": "string", "description": "Email address associated with the digital wallet account", "example": "", "default": "john_s@test.com" }, { "name": "digitalWalletPayerId", "kind": "optional", "type": "string", "description": "Unique identifier for each digital wallet account. This ID should persist across all orders made by the same user, regardless of underlying payment methods.", "example": "", "default": "FD000A45P" }, { "name": "digitalWalletpaymentId", "kind": "optional", "type": "string", "description": "Digital wallet payment ID", "example": "", "default": "PAY-0MB00000KR8073311KZSDEYA" }, { "name": "freeTextDigitalWalletName", "kind": "optional", "type": "string", "description": "Specifics about the source of the wallet such as the name / 3rd party name, etc. (required for OTHER digitalWalletName)", "example": "", "default": "ALIBABA" }, { "name": "fullDigitalWalletResponsePayload", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "GeneralPayloadMap", "description": "", "modelRef": "#/components/schemas/GeneralPayloadMap", "schema": [] } ], "schema": [] }, { "name": "payerAccountCountry", "kind": "optional", "type": "string", "description": "Digital wallet account country, two-letter ISO 3166-1 alpha-2 country code", "example": "", "default": "US" }, { "name": "paymentSuccessStatus", "kind": "optional", "type": "string", "description": "Digital wallet payment status", "example": "", "default": "COMPLETED" }, { "name": "underlyingPaymentMethod", "kind": "required", "type": "object", "description": "The underlying payment method associated to the digital wallet that was used in the current transaction", "modelRef": "#/components/schemas/UnderlyingPaymentMethod", "customType": "UnderlyingPaymentMethod", "schema": [ { "name": "bankTransfer", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "BankTransfer", "description": "", "modelRef": "#/components/schemas/BankTransfer", "schema": [ { "name": "accountHolderFirstName", "kind": "optional", "type": "string", "description": "Bank account holder first name", "example": "", "default": "John" }, { "name": "accountHolderLastName", "kind": "optional", "type": "string", "description": "Bank account holder last name", "example": "", "default": "Smith" }, { "name": "achProcessingType", "kind": "optional", "type": "string", "description": "Type of ACH processing used in the transaction", "example": "", "default": "SAME_DAY_ACH" }, { "name": "bankAccountIdentifier", "kind": "optional", "type": "string", "description": "Bank account unique identifier (IBAN or equivalent)", "example": "", "default": "TEST63TEST1212121212" }, { "name": "bankAccountType", "kind": "optional", "type": "string", "description": "Type of bank account payment is made from (e.g. savings/checking, etc.)", "example": "", "default": "Savings" }, { "name": "bankName", "kind": "optional", "type": "string", "description": "Name of bank payment is made from", "example": "", "default": "Citigroup" }, { "name": "paymentGatewayData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "PaymentGatewayData", "description": "", "modelRef": "#/components/schemas/PaymentGatewayData", "schema": [ { "name": "", "description": "", "customType": "Max depth limit reached" } ] } ], "schema": [] }, { "name": "paymentSuccessStatus", "kind": "optional", "type": "string", "description": "Response text as received from the service provider", "example": "", "default": "Payment Successful" }, { "name": "serviceName", "kind": "optional", "type": "string", "description": "Payment method name", "example": "", "default": "Direct Debit" } ] } ], "schema": [] }, { "name": "bitcoin", "kind": "optional", "type": "boolean", "description": "Bitcoin payment details", "example": "", "default": false }, { "name": "cash", "kind": "optional", "type": "boolean", "description": "Payed with cash", "example": "", "default": false }, { "name": "creditCard", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "TokenizedCreditCard", "description": "", "modelRef": "#/components/schemas/TokenizedCreditCard", "schema": [ { "name": "cardBank", "kind": "optional", "type": "string", "description": "Credit card's issuing bank", "example": "", "default": "Chase" }, { "name": "cardBrand", "kind": "optional", "type": "string", "description": "Credit card's issuer brand", "example": "", "default": "VISA" }, { "name": "cardType", "kind": "optional", "type": "string", "description": "Payment card type", "example": "", "default": "CREDIT" }, { "name": "countryOfIssuance", "kind": "optional", "type": "string", "description": "Credit card's issuing country, two-letter ISO 3166-1 alpha-2 country code", "example": "", "default": "US" }, { "name": "creationTime", "kind": "optional", "type": "number", "description": "Time the card was tokenized by the merchant in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1430997968 }, { "name": "creditCardCorrelationId", "kind": "optional", "type": "string", "description": "Credit card - CorrelationId that was recieved by the init 3DS API", "example": "" }, { "name": "expirationMonth", "kind": "required", "type": "string", "description": "Credit card's expiration month, in MM format", "example": "", "default": "03" }, { "name": "expirationYear", "kind": "required", "type": "string", "description": "Credit card's expiration year, in YYYY format", "example": "", "default": "2018" }, { "name": "fullResponsePayload", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "GeneralPayloadMap", "description": "", "modelRef": "#/components/schemas/GeneralPayloadMap", "schema": [ { "name": "", "description": "", "customType": "Max depth limit reached" } ] } ], "schema": [] }, { "name": "lastFourDigits", "kind": "optional", "type": "string", "description": "Credit card's last 4 digits", "example": "", "default": "4242" }, { "name": "nameOnCard", "kind": "optional", "type": "string", "description": "Cardholder's full name", "example": "", "default": "John R. H. Smith" }, { "name": "paymentProcessorData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "PaymentProcessorData", "description": "", "modelRef": "#/components/schemas/PaymentProcessorData", "schema": [ { "name": "", "description": "", "customType": "Max depth limit reached" } ] } ], "schema": [] }, { "name": "threeDSecure", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ThreeDSecureInput", "description": "", "modelRef": "#/components/schemas/ThreeDSecureInput", "schema": [ { "name": "", "description": "", "customType": "Max depth limit reached" } ] } ], "schema": [] }, { "name": "token", "kind": "required", "type": "string", "description": "Credit card token used by the merchant", "example": "", "default": "tkn-77620C360132856A103477D2959967AB" }, { "name": "tokenType", "kind": "optional", "type": "string", "description": "Token type, determined by the party/protocol the token created by", "example": "" }, { "name": "verificationResults", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "CreditCardVerification", "description": "", "modelRef": "#/components/schemas/CreditCardVerification", "schema": [ { "name": "", "description": "", "customType": "Max depth limit reached" } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "underlyingPaymentMethodType", "kind": "required", "type": "string", "description": "Underlying payment method type used in current transaction", "example": "", "default": "UNKNOWN" } ] } ] } ], "schema": [] }, { "name": "giftCard", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "CreditUsed", "description": "", "modelRef": "#/components/schemas/CreditUsed", "schema": [ { "name": "activationTime", "kind": "optional", "type": "number", "description": "Time credit/gift card was activated in the account, in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "creditCurrency", "kind": "optional", "type": "string", "description": "Original transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code", "example": "", "default": "CAD" }, { "name": "creditOrigin", "kind": "optional", "type": "string", "description": "Source which created gift card for customer.", "example": "", "default": "CS Compensation" }, { "name": "merchantPaymentId", "kind": "optional", "type": "string", "description": "unique payment identifier for the merchant reference.", "example": "", "default": "eab12-ba9a-367-60b" }, { "name": "value", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Amount", "description": "", "modelRef": "#/components/schemas/Amount", "schema": [ { "name": "amountLocalCurrency", "kind": "optional", "type": "string", "description": "Transaction amount in currency chosen by the buyer", "example": "", "default": "105.55" }, { "name": "amountUSD", "kind": "optional", "type": "string", "description": "Transaction amount in USD", "example": "", "default": "99.95" }, { "name": "currency", "kind": "optional", "type": "string", "description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code", "example": "", "default": "CAD" } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "installmentService", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "InstallmentService", "description": "", "modelRef": "#/components/schemas/InstallmentService", "schema": [ { "name": "firstName", "kind": "optional", "type": "string", "description": "Account holder's first name", "example": "", "default": "John" }, { "name": "fullResponsePayload", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "GeneralPayloadMap", "description": "", "modelRef": "#/components/schemas/GeneralPayloadMap", "schema": [] } ], "schema": [] }, { "name": "lastName", "kind": "optional", "type": "string", "description": "Account holder's last name", "example": "", "default": "Smith" }, { "name": "paymentId", "kind": "optional", "type": "string", "description": "Installment payment ID", "example": "", "default": "YTZ8IATEGAWRRVVG" }, { "name": "serviceName", "kind": "optional", "type": "string", "description": "Installment service's name", "example": "", "default": "Affirm" }, { "name": "serviceResponseCode", "kind": "optional", "type": "string", "description": "Response code received from installment service", "example": "", "default": "200" } ] } ], "schema": [] }, { "name": "loyaltyPoints", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "LoyaltyPoints", "description": "", "modelRef": "#/components/schemas/LoyaltyPoints", "schema": [ { "name": "loyaltyPointsCount", "kind": "required", "type": "number", "description": "Number of points (miles, stars, etc.)", "example": "", "default": 1506 }, { "name": "loyaltyPointsSource", "kind": "optional", "type": "string", "description": "Source of points (promo, referral, etc.)", "example": "", "default": "IN_ACCOUNT_PURCHASES" }, { "name": "loyaltyPointsValue", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Amount", "description": "", "modelRef": "#/components/schemas/Amount", "schema": [ { "name": "amountLocalCurrency", "kind": "optional", "type": "string", "description": "Transaction amount in currency chosen by the buyer", "example": "", "default": "105.55" }, { "name": "amountUSD", "kind": "optional", "type": "string", "description": "Transaction amount in USD", "example": "", "default": "99.95" }, { "name": "currency", "kind": "optional", "type": "string", "description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code", "example": "", "default": "CAD" } ] } ], "schema": [] }, { "name": "merchantPaymentId", "kind": "optional", "type": "string", "description": "unique payment identifier for the merchant reference.", "example": "", "default": "eab12-ba9a-367-60b" } ] } ], "schema": [] }, { "name": "merchantInitiated", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "MerchantInitiatedPayment", "description": "", "modelRef": "#/components/schemas/MerchantInitiatedPayment", "schema": [ { "name": "initialOrderId", "kind": "optional", "type": "string", "description": "Unique order/transaction identifier of the initial order (CIT).", "example": "", "default": "2356fdse0rr489" }, { "name": "type", "kind": "optional", "type": "string", "description": "Specifies the type of merchant-initiated payment", "example": "" } ] } ], "schema": [] }, { "name": "mobileMoney", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "MobileMoney", "description": "", "modelRef": "#/components/schemas/MobileMoney", "schema": [ { "name": "fullResponsePayload", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "GeneralPayloadMap", "description": "", "modelRef": "#/components/schemas/GeneralPayloadMap", "schema": [] } ], "schema": [] }, { "name": "mobileMoneyNetwork", "kind": "required", "type": "string", "description": "Mobile money provider name", "example": "", "default": "MPESA" }, { "name": "paymentAcquirerData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "AcquirerData", "description": "", "modelRef": "#/components/schemas/AcquirerData", "schema": [ { "name": "acquirerBIN", "kind": "optional", "type": "string", "description": "Bank acquirer BIN (Bank Identification Number)", "example": "", "default": "457173" }, { "name": "acquirerCountry", "kind": "optional", "type": "string", "description": "Acquirer country", "example": "", "default": "US" }, { "name": "acquirerMerchantId", "kind": "optional", "type": "string", "description": "Merchant ID (MID) - merchant ID is a unique code provided to merchants by their payment processor", "example": "", "default": "5245020244654" }, { "name": "acquirerMerchantName", "kind": "optional", "type": "string", "description": "Merchant Name as appearing in processor records", "example": "", "default": "Simple T-shirt" }, { "name": "acquirerName", "kind": "optional", "type": "string", "description": "Bank acquirer Name", "example": "", "default": "Barclays" }, { "name": "merchantCategoryCode", "kind": "optional", "type": "number", "description": "A Merchant Category Code (MCC) is a four-digit number listed in ISO 18245 for retail financial services. MCC is used to classify the business by the type of goods or services it provides.", "example": "", "default": 5655 }, { "name": "merchantCountryCode", "kind": "optional", "type": "number", "description": "Merchant country code", "example": "", "default": 840 } ] } ], "schema": [] }, { "name": "paymentGatewayData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "PaymentGatewayData", "description": "", "modelRef": "#/components/schemas/PaymentGatewayData", "schema": [ { "name": "gatewayName", "kind": "optional", "type": "string", "description": "Payment gateway name", "example": "", "default": "Braintree" }, { "name": "gatewayTransactionId", "kind": "optional", "type": "string", "description": "Unique transaction identifier (sent by gateway)", "example": "", "default": "fjdsS46sdklFd20" } ] } ], "schema": [] }, { "name": "paymentSuccessStatus", "kind": "optional", "type": "string", "description": "Mobile money payment status", "example": "", "default": "success" }, { "name": "phoneNumber", "kind": "required", "type": "string", "description": "Account phone number", "example": "", "default": "15557654321" } ] } ], "schema": [] }, { "name": "numberOfInstallments", "kind": "optional", "type": "integer", "description": "Number of payments if customer chose to pay in several installments", "example": 0, "default": 12 }, { "name": "paymentMethodNickname", "kind": "optional", "type": "string", "description": "Nickname assigned to this payment method by the user", "example": "", "default": "My Work Card" }, { "name": "paypal", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Paypal", "description": "", "modelRef": "#/components/schemas/Paypal", "schema": [ { "name": "authorizationId", "kind": "optional", "type": "string", "description": "PayPal authorization ID", "example": "", "default": "2WC75407LV7300439" }, { "name": "fullPaypalResponsePayload", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "GeneralPayloadMap", "description": "", "modelRef": "#/components/schemas/GeneralPayloadMap", "schema": [] } ], "schema": [] }, { "name": "payerAccountCountry", "kind": "optional", "type": "string", "description": "PayPal account country, two-letter ISO 3166-1 alpha-2 country code", "example": "", "default": "US" }, { "name": "payerAddressStatus", "kind": "optional", "type": "string", "description": "PayPal payer address status", "example": "", "default": "CONFIRMED" }, { "name": "payerEmail", "kind": "required", "type": "string", "description": "PayPal payer Email address", "example": "", "default": "john_s@test.com" }, { "name": "payerId", "kind": "required", "type": "string", "description": "PayPal payer ID", "example": "", "default": "FD000A45P" }, { "name": "payerStatus", "kind": "optional", "type": "string", "description": "PayPal payer status", "example": "", "default": "VERIFIED" }, { "name": "paymentGatewayData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "PaymentGatewayData", "description": "", "modelRef": "#/components/schemas/PaymentGatewayData", "schema": [ { "name": "gatewayName", "kind": "optional", "type": "string", "description": "Payment gateway name", "example": "", "default": "Braintree" }, { "name": "gatewayTransactionId", "kind": "optional", "type": "string", "description": "Unique transaction identifier (sent by gateway)", "example": "", "default": "fjdsS46sdklFd20" } ] } ], "schema": [] }, { "name": "paymentId", "kind": "optional", "type": "string", "description": "PayPal payment ID", "example": "", "default": "PAY-0MB00000KR8073311KZSDEYA" }, { "name": "paymentStatus", "kind": "optional", "type": "string", "description": "PayPal payment status", "example": "", "default": "COMPLETED" }, { "name": "protectionEligibility", "kind": "optional", "type": "string", "description": "PayPal protection eligibility", "example": "", "default": "ELIGIBLE" } ] } ], "schema": [] }, { "name": "recurringPayment", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "RecurringPaymentDetails", "description": "", "modelRef": "#/components/schemas/RecurringPaymentDetails", "schema": [ { "name": "currentPaymentNumber", "kind": "optional", "type": "integer", "description": "The number of payments processed in this recurring event including current transaction (1 for the original transaction)", "example": 0, "default": 1 }, { "name": "initialPaymentOrderId", "kind": "required", "type": "string", "description": "Original order/transaction identifier that started the recurring event (payment number 1)", "example": "", "default": "2356fdse0rr483" }, { "name": "isPaymentAmountIdenticalForAllPayments", "kind": "optional", "type": "boolean", "description": "True if the amount is constant between payments", "example": "", "default": false }, { "name": "recurringPaymentExpirationDate", "kind": "optional", "type": "string", "description": "Date of last expected payment event. Use YYYY-MM-DD format.", "example": "", "default": "1988-06-22" }, { "name": "recurringPaymentFrequency", "kind": "required", "type": "string", "description": "The number of days between transactions.", "example": "", "default": "7" }, { "name": "totalNumberOfPayments", "kind": "optional", "type": "integer", "description": "Expected number of payments processed in this recurring event", "example": 0, "default": 12 } ] } ], "schema": [] }, { "name": "samsungPay", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "TokenizedCreditCard", "description": "", "modelRef": "#/components/schemas/TokenizedCreditCard", "schema": [ { "name": "cardBank", "kind": "optional", "type": "string", "description": "Credit card's issuing bank", "example": "", "default": "Chase" }, { "name": "cardBrand", "kind": "optional", "type": "string", "description": "Credit card's issuer brand", "example": "", "default": "VISA" }, { "name": "cardType", "kind": "optional", "type": "string", "description": "Payment card type", "example": "", "default": "CREDIT" }, { "name": "countryOfIssuance", "kind": "optional", "type": "string", "description": "Credit card's issuing country, two-letter ISO 3166-1 alpha-2 country code", "example": "", "default": "US" }, { "name": "creationTime", "kind": "optional", "type": "number", "description": "Time the card was tokenized by the merchant in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1430997968 }, { "name": "creditCardCorrelationId", "kind": "optional", "type": "string", "description": "Credit card - CorrelationId that was recieved by the init 3DS API", "example": "" }, { "name": "expirationMonth", "kind": "required", "type": "string", "description": "Credit card's expiration month, in MM format", "example": "", "default": "03" }, { "name": "expirationYear", "kind": "required", "type": "string", "description": "Credit card's expiration year, in YYYY format", "example": "", "default": "2018" }, { "name": "fullResponsePayload", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "GeneralPayloadMap", "description": "", "modelRef": "#/components/schemas/GeneralPayloadMap", "schema": [] } ], "schema": [] }, { "name": "lastFourDigits", "kind": "optional", "type": "string", "description": "Credit card's last 4 digits", "example": "", "default": "4242" }, { "name": "nameOnCard", "kind": "optional", "type": "string", "description": "Cardholder's full name", "example": "", "default": "John R. H. Smith" }, { "name": "paymentProcessorData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "PaymentProcessorData", "description": "", "modelRef": "#/components/schemas/PaymentProcessorData", "schema": [ { "name": "processorName", "kind": "optional", "type": "string", "description": "Payment processor name", "example": "", "default": "Chase Paymentech" }, { "name": "processorTransactionId", "kind": "optional", "type": "string", "description": "Unique transaction identifier (sent by processor)", "example": "", "default": "fjdsS46sdklFd20" } ] } ], "schema": [] }, { "name": "threeDSecure", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ThreeDSecureInput", "description": "", "modelRef": "#/components/schemas/ThreeDSecureInput", "schema": [ { "name": "acquirerData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "AcquirerData", "description": "", "modelRef": "#/components/schemas/AcquirerData", "schema": [ { "name": "acquirerBIN", "kind": "optional", "type": "string", "description": "Bank acquirer BIN (Bank Identification Number)", "example": "", "default": "457173" }, { "name": "acquirerCountry", "kind": "optional", "type": "string", "description": "Acquirer country", "example": "", "default": "US" }, { "name": "acquirerMerchantId", "kind": "optional", "type": "string", "description": "Merchant ID (MID) - merchant ID is a unique code provided to merchants by their payment processor", "example": "", "default": "5245020244654" }, { "name": "acquirerMerchantName", "kind": "optional", "type": "string", "description": "Merchant Name as appearing in processor records", "example": "", "default": "Simple T-shirt" }, { "name": "acquirerName", "kind": "optional", "type": "string", "description": "Bank acquirer Name", "example": "", "default": "Barclays" }, { "name": "merchantCategoryCode", "kind": "optional", "type": "number", "description": "A Merchant Category Code (MCC) is a four-digit number listed in ISO 18245 for retail financial services. MCC is used to classify the business by the type of goods or services it provides.", "example": "", "default": 5655 }, { "name": "merchantCountryCode", "kind": "optional", "type": "number", "description": "Merchant country code", "example": "", "default": 840 } ] } ], "schema": [] }, { "name": "challengeIndicator", "kind": "optional", "type": "string", "description": "Request your preference regarding the executing of 3DS challange regardless of Forter's decision and recommendation", "example": "", "default": "NO_PREFERENCE" }, { "name": "execute3ds", "kind": "optional", "type": "string", "description": "Request your preference regarding the execution of 3DS", "example": "", "default": "DYNAMIC_FORTER_DECISION" }, { "name": "forcePsd2Exemption", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ThreeDSecureForcePsd2Exemption", "description": "", "modelRef": "#/components/schemas/ThreeDSecureForcePsd2Exemption", "schema": [ { "name": "channel", "kind": "required", "type": "string", "description": "The channel through which the exemption is requested", "example": "", "default": "THREEDS_RAILS" }, { "name": "type", "kind": "required", "type": "string", "description": "The type of exemption requested", "example": "", "default": "LOW_VALUE" } ] } ], "schema": [] }, { "name": "requestChallenge", "kind": "optional", "type": "boolean", "description": "Indicates if a 3DS challenge should be requested from the Issuer ACS.", "example": "", "default": false }, { "name": "threeDSServerTransID", "kind": "required", "type": "string", "description": "Universally unique transaction identifier assigned by the 3DS Server to identify a single transaction generated by the Init 3DS API and used to link the init call to the order call", "example": "", "default": "26d648a9-da8a-4f8b-a76d-094801d2fd45" }, { "name": "threeDsExecutor", "kind": "optional", "type": "string", "description": "Request your preference regarding the 3DS executor. To be used only for an edge case, where a merchant with 3DS execution demands Forter to not execute 3DS on a limited subset of TXs", "example": "" } ] } ], "schema": [] }, { "name": "token", "kind": "required", "type": "string", "description": "Credit card token used by the merchant", "example": "", "default": "tkn-77620C360132856A103477D2959967AB" }, { "name": "tokenType", "kind": "optional", "type": "string", "description": "Token type, determined by the party/protocol the token created by", "example": "" }, { "name": "verificationResults", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "CreditCardVerification", "description": "", "modelRef": "#/components/schemas/CreditCardVerification", "schema": [ { "name": "authorizationCode", "kind": "optional", "type": "string", "description": "Card authorization code from payment gateway", "example": "", "default": "A33244" }, { "name": "authorizationProcessedWith3DS", "kind": "optional", "type": "boolean", "description": "3DSecure - indicating that the 3DS results were sent to processor and have been used during the authorization", "example": "", "default": true }, { "name": "avsFullResult", "kind": "optional", "type": "string", "description": "Procesor response code for AVS. Only required in cases where all AVS results (zipcode, street address, and name when available) arrive as one string", "example": "", "default": "Y" }, { "name": "avsNameResult", "kind": "optional", "type": "string", "description": "Name portion of card's AVS result (when available)", "example": "", "default": "M" }, { "name": "avsStreetResult", "kind": "optional", "type": "string", "description": "Street address portion of card's AVS result", "example": "", "default": "N" }, { "name": "avsZipResult", "kind": "optional", "type": "string", "description": "Zipcode portion of card's AVS result", "example": "", "default": "M" }, { "name": "cavvResult", "kind": "optional", "type": "string", "description": "3DSecure - Authentication Value (CAVV / AAV for 3DS1) recieved from authorization/Authentication response", "example": "", "default": "VYboNwcsB3F9gTIsbaUjvEuLW0o=" }, { "name": "cvvResult", "kind": "optional", "type": "string", "description": "CVV result (if no data please send the value U)", "example": "", "default": "M" }, { "name": "eciValue", "kind": "optional", "type": "string", "description": "3DSecure - ECI value recieved from authorization/authentication response", "example": "", "default": "05" }, { "name": "liabilityShift", "kind": "optional", "type": "boolean", "description": "3DSecure - liability shift - indicate whether the chargeback liability shifted to the card issuer", "example": "", "default": true }, { "name": "processorResponseCode", "kind": "optional", "type": "string", "description": "Response code received from processor", "example": "", "default": "D23" }, { "name": "processorResponseText", "kind": "optional", "type": "string", "description": "Response text received from processor", "example": "", "default": "Stolen card" }, { "name": "threeDsStatus", "kind": "optional", "type": "string", "description": "3DSecure - Status text received from 3D secure vendor", "example": "", "default": "Cardholder authenticated" }, { "name": "threeDsVersion", "kind": "optional", "type": "string", "description": "3DSecure - Version used in the transaction", "example": "", "default": "2.1.0" } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "savedData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "SavedData", "description": "", "modelRef": "#/components/schemas/SavedData", "schema": [ { "name": "choseToSaveData", "kind": "optional", "type": "boolean", "description": "True if customer chose to save data in the account for future use", "example": "", "default": false }, { "name": "usedSavedData", "kind": "required", "type": "boolean", "description": "True if customer chose to use data saved in the account", "example": "", "default": true } ] } ], "schema": [] }, { "name": "storeCreditUsed", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "CreditUsed", "description": "", "modelRef": "#/components/schemas/CreditUsed", "schema": [ { "name": "activationTime", "kind": "optional", "type": "number", "description": "Time credit/gift card was activated in the account, in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1448549922 }, { "name": "creditCurrency", "kind": "optional", "type": "string", "description": "Original transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code", "example": "", "default": "CAD" }, { "name": "creditOrigin", "kind": "optional", "type": "string", "description": "Source which created gift card for customer.", "example": "", "default": "CS Compensation" }, { "name": "merchantPaymentId", "kind": "optional", "type": "string", "description": "unique payment identifier for the merchant reference.", "example": "", "default": "eab12-ba9a-367-60b" }, { "name": "value", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Amount", "description": "", "modelRef": "#/components/schemas/Amount", "schema": [ { "name": "amountLocalCurrency", "kind": "optional", "type": "string", "description": "Transaction amount in currency chosen by the buyer", "example": "", "default": "105.55" }, { "name": "amountUSD", "kind": "optional", "type": "string", "description": "Transaction amount in USD", "example": "", "default": "99.95" }, { "name": "currency", "kind": "optional", "type": "string", "description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code", "example": "", "default": "CAD" } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "tokenizedCard", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "TokenizedCreditCard", "description": "", "modelRef": "#/components/schemas/TokenizedCreditCard", "schema": [ { "name": "cardBank", "kind": "optional", "type": "string", "description": "Credit card's issuing bank", "example": "", "default": "Chase" }, { "name": "cardBrand", "kind": "optional", "type": "string", "description": "Credit card's issuer brand", "example": "", "default": "VISA" }, { "name": "cardType", "kind": "optional", "type": "string", "description": "Payment card type", "example": "", "default": "CREDIT" }, { "name": "countryOfIssuance", "kind": "optional", "type": "string", "description": "Credit card's issuing country, two-letter ISO 3166-1 alpha-2 country code", "example": "", "default": "US" }, { "name": "creationTime", "kind": "optional", "type": "number", "description": "Time the card was tokenized by the merchant in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1430997968 }, { "name": "creditCardCorrelationId", "kind": "optional", "type": "string", "description": "Credit card - CorrelationId that was recieved by the init 3DS API", "example": "" }, { "name": "expirationMonth", "kind": "required", "type": "string", "description": "Credit card's expiration month, in MM format", "example": "", "default": "03" }, { "name": "expirationYear", "kind": "required", "type": "string", "description": "Credit card's expiration year, in YYYY format", "example": "", "default": "2018" }, { "name": "fullResponsePayload", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "GeneralPayloadMap", "description": "", "modelRef": "#/components/schemas/GeneralPayloadMap", "schema": [] } ], "schema": [] }, { "name": "lastFourDigits", "kind": "optional", "type": "string", "description": "Credit card's last 4 digits", "example": "", "default": "4242" }, { "name": "nameOnCard", "kind": "optional", "type": "string", "description": "Cardholder's full name", "example": "", "default": "John R. H. Smith" }, { "name": "paymentProcessorData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "PaymentProcessorData", "description": "", "modelRef": "#/components/schemas/PaymentProcessorData", "schema": [ { "name": "processorName", "kind": "optional", "type": "string", "description": "Payment processor name", "example": "", "default": "Chase Paymentech" }, { "name": "processorTransactionId", "kind": "optional", "type": "string", "description": "Unique transaction identifier (sent by processor)", "example": "", "default": "fjdsS46sdklFd20" } ] } ], "schema": [] }, { "name": "threeDSecure", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ThreeDSecureInput", "description": "", "modelRef": "#/components/schemas/ThreeDSecureInput", "schema": [ { "name": "acquirerData", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "AcquirerData", "description": "", "modelRef": "#/components/schemas/AcquirerData", "schema": [ { "name": "acquirerBIN", "kind": "optional", "type": "string", "description": "Bank acquirer BIN (Bank Identification Number)", "example": "", "default": "457173" }, { "name": "acquirerCountry", "kind": "optional", "type": "string", "description": "Acquirer country", "example": "", "default": "US" }, { "name": "acquirerMerchantId", "kind": "optional", "type": "string", "description": "Merchant ID (MID) - merchant ID is a unique code provided to merchants by their payment processor", "example": "", "default": "5245020244654" }, { "name": "acquirerMerchantName", "kind": "optional", "type": "string", "description": "Merchant Name as appearing in processor records", "example": "", "default": "Simple T-shirt" }, { "name": "acquirerName", "kind": "optional", "type": "string", "description": "Bank acquirer Name", "example": "", "default": "Barclays" }, { "name": "merchantCategoryCode", "kind": "optional", "type": "number", "description": "A Merchant Category Code (MCC) is a four-digit number listed in ISO 18245 for retail financial services. MCC is used to classify the business by the type of goods or services it provides.", "example": "", "default": 5655 }, { "name": "merchantCountryCode", "kind": "optional", "type": "number", "description": "Merchant country code", "example": "", "default": 840 } ] } ], "schema": [] }, { "name": "challengeIndicator", "kind": "optional", "type": "string", "description": "Request your preference regarding the executing of 3DS challange regardless of Forter's decision and recommendation", "example": "", "default": "NO_PREFERENCE" }, { "name": "execute3ds", "kind": "optional", "type": "string", "description": "Request your preference regarding the execution of 3DS", "example": "", "default": "DYNAMIC_FORTER_DECISION" }, { "name": "forcePsd2Exemption", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ThreeDSecureForcePsd2Exemption", "description": "", "modelRef": "#/components/schemas/ThreeDSecureForcePsd2Exemption", "schema": [ { "name": "channel", "kind": "required", "type": "string", "description": "The channel through which the exemption is requested", "example": "", "default": "THREEDS_RAILS" }, { "name": "type", "kind": "required", "type": "string", "description": "The type of exemption requested", "example": "", "default": "LOW_VALUE" } ] } ], "schema": [] }, { "name": "requestChallenge", "kind": "optional", "type": "boolean", "description": "Indicates if a 3DS challenge should be requested from the Issuer ACS.", "example": "", "default": false }, { "name": "threeDSServerTransID", "kind": "required", "type": "string", "description": "Universally unique transaction identifier assigned by the 3DS Server to identify a single transaction generated by the Init 3DS API and used to link the init call to the order call", "example": "", "default": "26d648a9-da8a-4f8b-a76d-094801d2fd45" }, { "name": "threeDsExecutor", "kind": "optional", "type": "string", "description": "Request your preference regarding the 3DS executor. To be used only for an edge case, where a merchant with 3DS execution demands Forter to not execute 3DS on a limited subset of TXs", "example": "" } ] } ], "schema": [] }, { "name": "token", "kind": "required", "type": "string", "description": "Credit card token used by the merchant", "example": "", "default": "tkn-77620C360132856A103477D2959967AB" }, { "name": "tokenType", "kind": "optional", "type": "string", "description": "Token type, determined by the party/protocol the token created by", "example": "" }, { "name": "verificationResults", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "CreditCardVerification", "description": "", "modelRef": "#/components/schemas/CreditCardVerification", "schema": [ { "name": "authorizationCode", "kind": "optional", "type": "string", "description": "Card authorization code from payment gateway", "example": "", "default": "A33244" }, { "name": "authorizationProcessedWith3DS", "kind": "optional", "type": "boolean", "description": "3DSecure - indicating that the 3DS results were sent to processor and have been used during the authorization", "example": "", "default": true }, { "name": "avsFullResult", "kind": "optional", "type": "string", "description": "Procesor response code for AVS. Only required in cases where all AVS results (zipcode, street address, and name when available) arrive as one string", "example": "", "default": "Y" }, { "name": "avsNameResult", "kind": "optional", "type": "string", "description": "Name portion of card's AVS result (when available)", "example": "", "default": "M" }, { "name": "avsStreetResult", "kind": "optional", "type": "string", "description": "Street address portion of card's AVS result", "example": "", "default": "N" }, { "name": "avsZipResult", "kind": "optional", "type": "string", "description": "Zipcode portion of card's AVS result", "example": "", "default": "M" }, { "name": "cavvResult", "kind": "optional", "type": "string", "description": "3DSecure - Authentication Value (CAVV / AAV for 3DS1) recieved from authorization/Authentication response", "example": "", "default": "VYboNwcsB3F9gTIsbaUjvEuLW0o=" }, { "name": "cvvResult", "kind": "optional", "type": "string", "description": "CVV result (if no data please send the value U)", "example": "", "default": "M" }, { "name": "eciValue", "kind": "optional", "type": "string", "description": "3DSecure - ECI value recieved from authorization/authentication response", "example": "", "default": "05" }, { "name": "liabilityShift", "kind": "optional", "type": "boolean", "description": "3DSecure - liability shift - indicate whether the chargeback liability shifted to the card issuer", "example": "", "default": true }, { "name": "processorResponseCode", "kind": "optional", "type": "string", "description": "Response code received from processor", "example": "", "default": "D23" }, { "name": "processorResponseText", "kind": "optional", "type": "string", "description": "Response text received from processor", "example": "", "default": "Stolen card" }, { "name": "threeDsStatus", "kind": "optional", "type": "string", "description": "3DSecure - Status text received from 3D secure vendor", "example": "", "default": "Cardholder authenticated" }, { "name": "threeDsVersion", "kind": "optional", "type": "string", "description": "3DSecure - Version used in the transaction", "example": "", "default": "2.1.0" } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "venmo", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Venmo", "description": "", "modelRef": "#/components/schemas/Venmo", "schema": [ { "name": "fullVenmoResponsePayload", "kind": "required", "type": "object", "description": "Full Venmo response object", "modelRef": "#/components/schemas/GeneralPayloadMap", "customType": "GeneralPayloadMap", "schema": [] }, { "name": "paymentId", "kind": "optional", "type": "string", "description": "Venmo payment ID", "example": "", "default": "1KZSDEYA" }, { "name": "token", "kind": "required", "type": "string", "description": "Token representing the specific payment method used within the Venmo vault", "example": "", "default": "77620C360132856A103477D2959967AB" }, { "name": "userId", "kind": "required", "type": "string", "description": "Venmo userID", "example": "", "default": "johndoe" }, { "name": "userName", "kind": "required", "type": "string", "description": "Venmo user name", "example": "", "default": "johndoe1987" } ] } ], "schema": [] } ] }, { "name": "phonesInAccount", "kind": "optional", "type": "array", "description": "All phone numbers saved in account", "modelRef": "#/components/schemas/Phone", "customType": "Phone[]", "schema": [ { "name": "phone", "kind": "required", "type": "string", "description": "Phone number including all country and local access codes", "example": "", "default": "15557654321" }, { "name": "smsVerified", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Verification", "description": "", "modelRef": "#/components/schemas/Verification", "schema": [ { "name": "sent", "kind": "required", "type": "boolean", "description": "True if verification email was sent to email address or verification SMS was sent to phone number", "example": "", "default": true }, { "name": "timeSent", "kind": "optional", "type": "number", "description": "Date verification email or SMS was sent in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1389567341 }, { "name": "verified", "kind": "required", "type": "boolean", "description": "True if customer received email verification message to this address and clicked-through back to merchant's site, or received SMS message and enterd code in merchant's site (two-factor authentication)", "example": "", "default": false } ] } ], "schema": [] } ] }, { "name": "ratingAsBuyer", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Rating", "description": "", "modelRef": "#/components/schemas/Rating", "schema": [ { "name": "score", "kind": "required", "type": "string", "description": "Rating score (numeric - 97 or textual - 'Excellent')", "example": "", "default": "4.5" }, { "name": "source", "kind": "required", "type": "string", "description": "Source of rating, for example tripAdvisor, yelp, etc.", "example": "", "default": "yelp" }, { "name": "type", "kind": "required", "type": "string", "description": "Rating type. Internal if rating was generated within the merchant's site or community, otherwise external.", "example": "", "default": "INTERNAL_PEERS" } ] } ], "schema": [] }, { "name": "registrationIP", "kind": "optional", "type": "string", "description": "IP address used by the account owner at the time of registration.", "example": "", "default": "203.12.55.12" }, { "name": "type", "kind": "optional", "type": "string", "description": "Account type (a business account, a private account, a merchant-operated account)", "example": "", "default": "BUSINESS" } ] } ], "schema": [] }, { "name": "accountId", "kind": "required", "type": "string", "description": "Customer's account UID in merchant's site. Should not be the user email. If no account ID is available send NO_ACCOUNT_ID", "example": "", "default": "e520-ba9a-367-60b" }, { "name": "additionalAccountEventIdentifiers", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "AdditionalAccountEventIdentifiers", "description": "", "modelRef": "#/components/schemas/AdditionalAccountEventIdentifiers", "schema": [] } ], "schema": [] }, { "name": "additionalInformation", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "GeneralPayloadMap", "description": "", "modelRef": "#/components/schemas/GeneralPayloadMap", "schema": [] } ], "schema": [] }, { "name": "channelType", "kind": "optional", "type": "string", "description": "The source channel through which the customer conducted the signup. Note that some of the enum values are not relevant for this interaction.", "example": "", "default": "WEB" }, { "name": "connectionInformation", "kind": "required", "type": "object", "description": "Connection information about the customer typically found in the HTTP request header.", "modelRef": "#/components/schemas/ConnectionInformation", "customType": "ConnectionInformation", "schema": [ { "name": "checkoutToolsSessionId", "kind": "optional", "type": "string", "description": "CheckoutToolsSessionId received from the SDK", "example": "", "default": "HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd" }, { "name": "customerIP", "kind": "required", "type": "string", "description": "Customer IP address in IPv4 or IPv6 format. If missing should be populated with 127.0.0.1", "example": "", "default": "10.0.0.127" }, { "name": "forterMobileUID", "kind": "optional", "type": "string", "description": "mobile UID. The device identifier such as IMEI in android or identifier for vendor in iOS. This should match the deviceId sent via the mobile events API (for mobile transactions only)", "example": "", "default": "6429751237891" }, { "name": "forterTokenCookie", "kind": "optional", "type": "string", "description": "Forter token cookie from request headers", "example": "", "default": "249453te8tbf9355186fet0ken547b95_2786972955236__UDE52-n5_8dg" }, { "name": "merchantDeviceIdentifier", "kind": "optional", "type": "string", "description": "A unique device identifier generated by merchant", "example": "", "default": "HGJ7512345H3" }, { "name": "merchantProvidedSessionId", "kind": "optional", "type": "string", "description": "An identifier of the merchant session", "example": "", "default": "HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd" }, { "name": "userAgent", "kind": "required", "type": "string", "description": "Customer's User agent", "example": "", "default": "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36" } ] }, { "name": "customerSignedInUsingSocialNetworkAccount", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "CustomerRegistrationSources", "description": "", "modelRef": "#/components/schemas/CustomerRegistrationSources", "schema": [ { "name": "facebook", "kind": "optional", "type": "boolean", "description": "Facebook", "example": "", "default": false }, { "name": "google", "kind": "optional", "type": "boolean", "description": "Google", "example": "", "default": false }, { "name": "linkedin", "kind": "optional", "type": "boolean", "description": "LinkedIn", "example": "", "default": false }, { "name": "otherSocialNetwork", "kind": "optional", "type": "string", "description": "Other Social Network", "example": "", "default": "VK" }, { "name": "paypal", "kind": "optional", "type": "boolean", "description": "PayPal", "example": "", "default": false }, { "name": "twitter", "kind": "optional", "type": "boolean", "description": "Twitter", "example": "", "default": false } ] } ], "schema": [] }, { "name": "eventTime", "kind": "required", "type": "number", "description": "The time that the trigger event occurred in MILLISECONDS since unix epoch (Jan 1, 1970)", "example": "", "default": 1415287568000 }, { "name": "promotions", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Discount", "description": "", "modelRef": "#/components/schemas/Discount", "schema": [ { "name": "couponCodeUsed", "kind": "required", "type": "string", "description": "Coupon code used", "example": "", "default": "FATHERSDAY2015" }, { "name": "couponDiscountAmount", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Amount", "description": "", "modelRef": "#/components/schemas/Amount", "schema": [ { "name": "amountLocalCurrency", "kind": "optional", "type": "string", "description": "Transaction amount in currency chosen by the buyer", "example": "", "default": "105.55" }, { "name": "amountUSD", "kind": "optional", "type": "string", "description": "Transaction amount in USD", "example": "", "default": "99.95" }, { "name": "currency", "kind": "optional", "type": "string", "description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code", "example": "", "default": "CAD" } ] } ], "schema": [] }, { "name": "couponDiscountPercent", "kind": "optional", "type": "string", "description": "Coupon discount amount", "example": "" } ] } ], "schema": [] }, { "name": "signupStatus", "kind": "optional", "type": "string", "description": "The status of the Signup attempt", "example": "", "default": "SUCCESS" } ], "modelRef": "#/components/schemas/accountSignupRequest", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "basicAuth", "name": "basicAuth", "kind": "optional", "type": "http", "scheme": "basic" } ] }, "responses": [ { "statusCode": "200", "description": "Example adaptiveAuthAccountsResponse", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "description": "Response structure for adaptive auth account requests", "customType": "adaptiveAuthAccountsResponse", "schema": [ { "name": "accountId", "kind": "required", "type": "string", "description": "When applicable, the customer's account UID in merchant's site", "example": "", "default": "e520-ba9a-367-60b" }, { "name": "correlationId", "kind": "required", "type": "string", "description": "A forter unique identifier that should be sent to Forter as part of the AdvancedAuthenticationMethod object to correlate the MFA recommendation given in this response with the relevant additional authentication attempt result", "example": "", "default": "HGJ7512345H3DE" }, { "name": "decisionReason", "kind": "required", "type": "string", "description": "The main reason behind the Forter decision", "example": "", "default": "" }, { "name": "forterDecision", "kind": "required", "type": "string", "description": "The latest Forter decision regarding the attempted action", "example": "", "default": "APPROVE" }, { "name": "merchantPolicyId", "kind": "required", "type": "string", "description": "UID of the custom policy created in Forter's Policies tool that resulted in this decision", "example": "", "default": "0ee8ba28a8654c659addbae9253b707c" }, { "name": "recommendation", "kind": "required", "type": "string", "description": "A specific recommendation for an action that might help the customer to complete their transaction/action (e.g. verify phone via SMS, verify via push notification, verify email, perform a 3DS check, etc.)", "example": "", "default": "" }, { "name": "verificationMethod", "kind": "required", "type": "object", "description": "The specific verification method to be used when verification is required according to \"recommendation\" field", "modelRef": "#/components/schemas/VerificationMethod", "customType": "VerificationMethod", "schema": [ { "name": "correlationId", "kind": "required", "type": "string", "description": "A forter unique identifier that was provided as part of a Forter API response recommending additional authentication measures. Used to correlate between the user action which triggered the recommendation and the authentication attempt result. Required when the additional authentication was triggered by Forter's recommendation.", "example": "", "default": "HGJ7512345H3DE" }, { "name": "status", "kind": "required", "type": "string", "description": "Verification status", "example": "", "default": "FRICTIONLESS" }, { "name": "statusCode", "kind": "required", "type": "string", "description": "Verification status code", "example": "", "default": "100" }, { "name": "statusMessage", "kind": "required", "type": "string", "description": "Text describes the verification status", "example": "", "default": "Verification code sent" }, { "name": "type", "kind": "required", "type": "string", "description": "Verification method type", "example": "", "default": "THREE_DS" }, { "name": "verificationId", "kind": "required", "type": "string", "description": "A unique identifier assigned to that specific verification", "example": "", "default": "345H3DEHGJ7512" }, { "name": "verificationSpecificData", "kind": "required", "type": "object", "description": "Data specific to the verification type performed", "modelRef": "#/components/schemas/VerificationData", "customType": "VerificationData", "schema": [ { "name": "ThreeDS", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "ThreeDSecureResponse", "description": "", "modelRef": "#/components/schemas/ThreeDSecureResponse", "schema": [ { "name": "ACSUrl", "kind": "required", "type": "string", "description": "In case of challange, this url is needed to be passed to client side and trigger ftr__.init3DS function", "example": "", "default": "https:/ /acs-us-east-1.nd.nds-sandbox-issuer.com/api/v1/acs/browser_sdk_challenges" }, { "name": "ECIValue", "kind": "required", "type": "string", "description": "Electronic Commerce Indicator (ECI) is a value that is returned from the Directory Server (Visa, MasterCard, etc) to indicate the authentication results of your customer's credit card payment on 3D Secure. ECI only available when the challenge is not needed or after challenge had been completed. Possible values: 00, 01, 02, 04, 05, 06, 07", "example": "", "default": "02" }, { "name": "acsChallengeMandated", "kind": "required", "type": "string", "description": "Indication of whether a challenge is required for the transaction to be authorised due to local/regional mandates or other variable (Y - Challenge is mandated, N - Challenge is not mandated)", "example": "", "default": "Y" }, { "name": "acsReferenceNumber", "kind": "required", "type": "string", "description": "Unique identifier assigned by the EMVCo Secretariat = required for mobile app implementation", "example": "", "default": "ftr-internal-acs-approval" }, { "name": "acsSignedContent", "kind": "required", "type": "string", "description": "ACS Signed Content required for mobile app implementation", "example": "", "default": "" }, { "name": "acsTransID", "kind": "required", "type": "string", "description": "Universally Unique transaction identifier assigned by the ACS to identify a single transaction - required for mobile app implementation", "example": "", "default": "6fd30e89-8171-4cc3-b86e-3d59582af2f6" }, { "name": "authenticationType", "kind": "required", "type": "string", "description": "Optional authentication type (01 - Static, 02 - Dynamic, 03 - OOB, 04 - Decoupled)", "example": "", "default": "01" }, { "name": "authenticationValue", "kind": "required", "type": "string", "description": "3DS Authentication value (AV) should be sent to the payment gateway in the authorization call", "example": "", "default": "tSvPDt3PINNaoL+ERXdg0jVrmWc=" }, { "name": "bankLiabilityShift", "kind": "required", "type": "boolean", "description": "Indicates whether transaction is supposed to get liability shift from issuer", "example": "", "default": true }, { "name": "cardEnrolled", "kind": "required", "type": "string", "description": "3DS transaction card Enrolled status - should be sent to the payment gateway in the authorization call in some payment gateways", "example": "", "default": "Y" }, { "name": "cavvAlgorithm", "kind": "required", "type": "string", "description": "3DS Authentication value algorithm - should be sent to the payment gateway in the authorization call in some payment gateways. Possible values (3DS1 only): 0, 1, 2, 3, 4, 7", "example": "", "default": "3" }, { "name": "challengeCancel", "kind": "required", "type": "string", "description": "Indicator informing the ACS and the DS that the authentication has been canceled. Possible values: 01-99", "example": "", "default": "01" }, { "name": "challengeStatus", "kind": "required", "type": "string", "description": "Ares transStatus value (Possible values: U, N, Y, A, C, D, R, I)", "example": "", "default": "Y" }, { "name": "dsTransID", "kind": "required", "type": "string", "description": "Universally unique transaction identifier assigned by the DS to identify a single transaction", "example": "", "default": "38bbf46f-c023-4f4c-ae2c-35fb301632a5" }, { "name": "encodedChallengeRequest", "kind": "required", "type": "string", "description": "This value will only be available when challenge is needed, in the challenge flow - this must be passed to browser in order to trigger the challenge", "example": "", "default": "eyJhY3NUcmFuc0lEIjoiMTEyY2RiNWItMGFlYy00MTY5LThjMWYtYWMyN2JlNjAxMjhhIiwiY2hhbGxlbmdlV2luZG93U2l6ZSI6IjA0IiwibWVzc2FnZVZlcnNpb24iOiIyLjEuMCIsIm1lc3NhZ2VUeXBlIjoiQ1JlcSIsInRocmVlRFNTZXJ2ZXJUcmFuc0lEIjoiZWRhM2MwMzYtZWMyYS00NmZkLTlmYWItNzBlZTgyYjJjNzQ5In0=" }, { "name": "exemption", "kind": "optional", "type": "string", "description": "Exemption that should be used during the authorization process", "example": "", "default": "TRANSACTION_RISK_ANALYSIS" }, { "name": "interactionCounter", "kind": "required", "type": "string", "description": "Indicates the number of authentication cycles attempted by the Cardholder", "example": "", "default": "01" }, { "name": "isFallback", "kind": "required", "type": "boolean", "description": "Indication of whether a 3DS1 challenge was performed as a fallback to 3DS2 error", "example": "", "default": false }, { "name": "messageCategory", "kind": "required", "type": "string", "description": "Identifies the category of the message for a specific use case (01 - PA, 02 - NPA)", "example": "", "default": "01" }, { "name": "outOfScopeForPSD2", "kind": "optional", "type": "string", "description": "This field indicate if transaction is out of scope for PSD2 and exclusion should be requested", "example": "", "default": "ANONYMOUS_PREPAID_CARD" }, { "name": "threeDSServerTransID", "kind": "required", "type": "string", "description": "Universally unique transaction identifier assigned by the 3DS Server to identify a single transaction (in 3DS1 equal to XID)", "example": "", "default": "26d648a9-da8a-4f8b-a76d-094801d2fd45" }, { "name": "threeDSecureMode", "kind": "required", "type": "string", "description": "Indicate if the transaction is Frictionless or SCA. Being used by some payment gateways. Possible values: sca, frictionless", "example": "", "default": "sca" }, { "name": "threeDSecurePreference", "kind": "required", "type": "string", "description": "The challenge indicator used. Being used by some payment gateways. Possible values: nopref, frictionless, sca, scamandate", "example": "", "default": "nopref" }, { "name": "threeDSecureResult", "kind": "required", "type": "string", "description": "This field is relevant for 3DS1 and being used by some payment gateways", "example": "", "default": "590040" }, { "name": "transStatus", "kind": "required", "type": "string", "description": "3DS transStatus value - Indicates whether a transaction qualifies as an authenticated transaction or account verification. should be sent to the payment gateway in the authorization call (Possible values: U, N, Y, A, C, D, R, I)", "example": "", "default": "Y" }, { "name": "transStatusReason", "kind": "required", "type": "string", "description": "Provides information on why the Transaction Status field has the specified value. Possible values: 01-99", "example": "", "default": "01" }, { "name": "verifyStatus", "kind": "required", "type": "string", "description": "Cres transStatus value (Possible values: U, N, Y, A, C, D, R, I, null)", "example": "", "default": "Y" }, { "name": "version", "kind": "required", "type": "string", "description": "Version. Possible values: 1.0.2, 2.1.0, 2.2.0", "example": "", "default": "2.1.0" } ] } ], "schema": [] }, { "name": "email", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Email", "description": "", "modelRef": "#/components/schemas/Email", "schema": [ { "name": "email", "kind": "required", "type": "string", "description": "Email address", "example": "", "default": "john_s@test.com" }, { "name": "emailVerification", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Verification", "description": "", "modelRef": "#/components/schemas/Verification", "schema": [ { "name": "sent", "kind": "required", "type": "boolean", "description": "True if verification email was sent to email address or verification SMS was sent to phone number", "example": "", "default": true }, { "name": "timeSent", "kind": "optional", "type": "number", "description": "Date verification email or SMS was sent in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1389567341 }, { "name": "verified", "kind": "required", "type": "boolean", "description": "True if customer received email verification message to this address and clicked-through back to merchant's site, or received SMS message and enterd code in merchant's site (two-factor authentication)", "example": "", "default": false } ] } ], "schema": [] } ] } ], "schema": [] }, { "name": "phone", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Phone", "description": "", "modelRef": "#/components/schemas/Phone", "schema": [ { "name": "phone", "kind": "required", "type": "string", "description": "Phone number including all country and local access codes", "example": "", "default": "15557654321" }, { "name": "smsVerified", "kind": "optional", "type": "object", "complexType": "allOf", "complexItems": [ { "name": "Verification", "description": "", "modelRef": "#/components/schemas/Verification", "schema": [ { "name": "sent", "kind": "required", "type": "boolean", "description": "True if verification email was sent to email address or verification SMS was sent to phone number", "example": "", "default": true }, { "name": "timeSent", "kind": "optional", "type": "number", "description": "Date verification email or SMS was sent in seconds since unix epoch (UTC, Jan 1, 1970)", "example": "", "default": 1389567341 }, { "name": "verified", "kind": "required", "type": "boolean", "description": "True if customer received email verification message to this address and clicked-through back to merchant's site, or received SMS message and enterd code in merchant's site (two-factor authentication)", "example": "", "default": false } ] } ], "schema": [] } ] } ], "schema": [] } ] } ] } ], "modelRef": "#/components/schemas/adaptiveAuthAccountsResponse", "isExpanded": true } ] }, { "statusCode": "400", "description": "Bad Request (Often missing a required parameter)", "jsonExample": "", "isExpanded": true }, { "statusCode": "401", "description": "Unauthorized (No valid API key provided)", "jsonExample": "", "isExpanded": true }, { "statusCode": "404", "description": "Not Found (The requested item doesn't exist)", "jsonExample": "", "isExpanded": true }, { "statusCode": "500", "description": "Server Error (Something went wrong on Forter's end)", "jsonExample": "", "isExpanded": true } ], "hasXCodeSamples": false, "examples": { "languages": [ { "id": "example-0-curl", "language": "curl", "label": "cURL", "code": "curl --request POST \\\n --url https://api.forter-secure.com/v2/accounts/signup/{id} \\\n --header 'accept: application/json' \\\n --header 'content-type: application/json' \\\n --header 'api-version: 10.1' \\\n --header 'x-forter-siteid: 8b47c6d423ba' \\\n --header 'authorization: Basic ' \\\n --data-raw '{\n \"accountData\": {\n \"additionalVerificationDocuments\": {\n \"documentDateOfBirth\": \"1991-01-09\",\n \"documentExpiration\": \"2017-01-15\",\n \"documentFirstName\": \"John\",\n \"documentIssuingState\": \"NY\",\n \"documentLastName\": \"Smith\",\n \"documentNumber\": \"20439190\",\n \"documentSource\": \"UPLOADED_FILE\",\n \"documentStatus\": \"SENT_TO_CLIENT\",\n \"documentType\": \"Passport\",\n \"documentVerificationServiceAnswer\": \"APPROVED\",\n \"documentVerificationServiceName\": \"IDVerification.com\",\n \"documentVerificationServiceResponsePayload\": {},\n \"documentVerified\": true,\n \"eventTime\": 1420070400,\n \"nationality\": \"US\"\n },\n \"addressesInAccount\": [\n {\n \"address1\": \"235 Montgomery st.\",\n \"address2\": \"Ste. 1110\",\n \"city\": \"San Francisco\",\n \"company\": \"Generic Corp. ltd.\",\n \"country\": \"US\",\n \"region\": \"CA\",\n \"savedData\": {\n \"usedSavedData\": true\n },\n \"zip\": \"94104\"\n }\n ],\n \"customerEngagement\": {\n \"communityPostsWritten\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"followersCount\": 105,\n \"followingCount\": 230,\n \"invites\": [\n {\n \"invitationCounterpartyPhone\": \"+12126667777\",\n \"sent\": 1420955538,\n \"type\": \"SENT\"\n }\n ],\n \"likedItems\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"messagesReceived\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"messagesSent\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"newsletters\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"profilePicture\": true,\n \"requestedDemo\": true,\n \"reviewsWritten\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"savedLocations\": [\n {\n \"latitude\": 32.07332,\n \"longitude\": 34.79675,\n \"source\": \"MOBILE\"\n }\n ],\n \"sharedItems\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"signedUpForPushNotifications\": true,\n \"signedUpForSMSUpdates\": true,\n \"wishlist\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n }\n },\n \"emailsInAccount\": [\n {\n \"email\": \"john_s@test.com\",\n \"emailVerification\": {\n \"sent\": true,\n \"timeSent\": 1389567341,\n \"verified\": false\n }\n }\n ],\n \"paymentMethodsInAccount\": [\n {\n \"amount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"androidPay\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"applePay\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"bankTransfer\": {\n \"accountHolderFirstName\": \"John\",\n \"accountHolderLastName\": \"Smith\",\n \"achProcessingType\": \"SAME_DAY_ACH\",\n \"bankAccountIdentifier\": \"TEST63TEST1212121212\",\n \"bankAccountType\": \"Savings\",\n \"bankName\": \"Citigroup\",\n \"paymentGatewayData\": {\n \"gatewayName\": \"Braintree\",\n \"gatewayTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"paymentSuccessStatus\": \"Payment Successful\",\n \"serviceName\": \"Direct Debit\"\n },\n \"billingDetails\": {\n \"address\": {\n \"address1\": \"235 Montgomery st.\",\n \"address2\": \"Ste. 1110\",\n \"city\": \"San Francisco\",\n \"company\": \"Generic Corp. ltd.\",\n \"country\": \"US\",\n \"region\": \"CA\",\n \"savedData\": {\n \"usedSavedData\": true\n },\n \"zip\": \"94104\"\n },\n \"allAdditionalVerificationDocuments\": [\n {\n \"documentDateOfBirth\": \"1991-01-09\",\n \"documentExpiration\": \"2017-01-15\",\n \"documentFirstName\": \"John\",\n \"documentIssuingState\": \"NY\",\n \"documentLastName\": \"Smith\",\n \"documentNumber\": \"20439190\",\n \"documentSource\": \"UPLOADED_FILE\",\n \"documentStatus\": \"SENT_TO_CLIENT\",\n \"documentType\": \"Passport\",\n \"documentVerificationServiceAnswer\": \"APPROVED\",\n \"documentVerificationServiceName\": \"IDVerification.com\",\n \"documentVerificationServiceResponsePayload\": {},\n \"documentVerified\": true,\n \"eventTime\": 1420070400,\n \"nationality\": \"US\"\n }\n ],\n \"employmentInformation\": [\n {\n \"employerAddress\": {\n \"address1\": \"235 Montgomery st.\",\n \"address2\": \"Ste. 1110\",\n \"city\": \"San Francisco\",\n \"company\": \"Generic Corp. ltd.\",\n \"country\": \"US\",\n \"region\": \"CA\",\n \"savedData\": {},\n \"zip\": \"94104\"\n },\n \"employerCompanySizeRange\": \"20\",\n \"employerIndustry\": \"Retail\",\n \"employerName\": \"Forter\",\n \"employerPhone\": \"+12126667777\",\n \"income\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"jobTitle\": \"Fraud Analyst\"\n }\n ],\n \"personalDetails\": {\n \"birthdate\": \"1987-05-22\",\n \"email\": \"john_s@test.com\",\n \"firstName\": \"John\",\n \"fullName\": \"John Smith\",\n \"gender\": \"MALE\",\n \"lastName\": \"Smith\"\n },\n \"phone\": [\n {\n \"phone\": \"15557654321\",\n \"smsVerified\": {\n \"sent\": true,\n \"timeSent\": 1389567341,\n \"verified\": false\n }\n }\n ]\n },\n \"cameraCaptured\": true,\n \"creditCard\": {\n \"bin\": \"42424242\",\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fingerprint\": \"Xt5EWLLDS7FJjR1c\",\n \"fullCreditCard\": \"2424242424242424\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"creditLineDetails\": {\n \"askedToIncreaseCreditLineLimit\": false,\n \"creditLineLimitIncreaseMethod\": \"AT_PURCHASE\",\n \"currentCreditLineLimit\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"originalCreditLineLimit\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"cryptoWallet\": {\n \"cryptoWalletName\": \"CryptoWallet\",\n \"cryptoWalletPaymentId\": \"3JQiwG88SQvwihDAHg9M2EnqEisharz49c\",\n \"cryptoWalletType\": \"EXTERNAL\"\n },\n \"digitalWallet\": {\n \"digitalWalletName\": \"ALIPAY\",\n \"digitalWalletPayerEmail\": \"john_s@test.com\",\n \"digitalWalletPayerId\": \"FD000A45P\",\n \"digitalWalletpaymentId\": \"PAY-0MB00000KR8073311KZSDEYA\",\n \"freeTextDigitalWalletName\": \"ALIBABA\",\n \"fullDigitalWalletResponsePayload\": {},\n \"payerAccountCountry\": \"US\",\n \"paymentSuccessStatus\": \"COMPLETED\",\n \"underlyingPaymentMethod\": {\n \"bankTransfer\": {\n \"accountHolderFirstName\": \"John\",\n \"accountHolderLastName\": \"Smith\",\n \"achProcessingType\": \"SAME_DAY_ACH\",\n \"bankAccountIdentifier\": \"TEST63TEST1212121212\",\n \"bankAccountType\": \"Savings\",\n \"bankName\": \"Citigroup\",\n \"paymentGatewayData\": {},\n \"paymentSuccessStatus\": \"Payment Successful\",\n \"serviceName\": \"Direct Debit\"\n },\n \"creditCard\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {},\n \"threeDSecure\": {},\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {}\n },\n \"underlyingPaymentMethodType\": \"UNKNOWN\"\n }\n },\n \"giftCard\": {\n \"activationTime\": 1448549922,\n \"creditCurrency\": \"CAD\",\n \"creditOrigin\": \"CS Compensation\",\n \"merchantPaymentId\": \"eab12-ba9a-367-60b\",\n \"value\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"installmentService\": {\n \"firstName\": \"John\",\n \"fullResponsePayload\": {},\n \"lastName\": \"Smith\",\n \"paymentId\": \"YTZ8IATEGAWRRVVG\",\n \"serviceName\": \"Affirm\",\n \"serviceResponseCode\": \"200\"\n },\n \"loyaltyPoints\": {\n \"loyaltyPointsCount\": 1506,\n \"loyaltyPointsSource\": \"IN_ACCOUNT_PURCHASES\",\n \"loyaltyPointsValue\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"merchantPaymentId\": \"eab12-ba9a-367-60b\"\n },\n \"merchantInitiated\": {\n \"initialOrderId\": \"2356fdse0rr489\"\n },\n \"mobileMoney\": {\n \"fullResponsePayload\": {},\n \"mobileMoneyNetwork\": \"MPESA\",\n \"paymentAcquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"paymentGatewayData\": {\n \"gatewayName\": \"Braintree\",\n \"gatewayTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"paymentSuccessStatus\": \"success\",\n \"phoneNumber\": \"15557654321\"\n },\n \"numberOfInstallments\": 12,\n \"paymentMethodNickname\": \"My Work Card\",\n \"paypal\": {\n \"authorizationId\": \"2WC75407LV7300439\",\n \"fullPaypalResponsePayload\": {},\n \"payerAccountCountry\": \"US\",\n \"payerAddressStatus\": \"CONFIRMED\",\n \"payerEmail\": \"john_s@test.com\",\n \"payerId\": \"FD000A45P\",\n \"payerStatus\": \"VERIFIED\",\n \"paymentGatewayData\": {\n \"gatewayName\": \"Braintree\",\n \"gatewayTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"paymentId\": \"PAY-0MB00000KR8073311KZSDEYA\",\n \"paymentStatus\": \"COMPLETED\",\n \"protectionEligibility\": \"ELIGIBLE\"\n },\n \"recurringPayment\": {\n \"currentPaymentNumber\": 1,\n \"initialPaymentOrderId\": \"2356fdse0rr483\",\n \"recurringPaymentExpirationDate\": \"1988-06-22\",\n \"recurringPaymentFrequency\": \"7\",\n \"totalNumberOfPayments\": 12\n },\n \"samsungPay\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"savedData\": {\n \"usedSavedData\": true\n },\n \"storeCreditUsed\": {\n \"activationTime\": 1448549922,\n \"creditCurrency\": \"CAD\",\n \"creditOrigin\": \"CS Compensation\",\n \"merchantPaymentId\": \"eab12-ba9a-367-60b\",\n \"value\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"tokenizedCard\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"venmo\": {\n \"fullVenmoResponsePayload\": \"\",\n \"paymentId\": \"1KZSDEYA\",\n \"token\": \"77620C360132856A103477D2959967AB\",\n \"userId\": \"johndoe\",\n \"userName\": \"johndoe1987\"\n }\n }\n ],\n \"phonesInAccount\": [\n {\n \"phone\": \"15557654321\",\n \"smsVerified\": {\n \"sent\": true,\n \"timeSent\": 1389567341,\n \"verified\": false\n }\n }\n ],\n \"ratingAsBuyer\": {\n \"score\": \"4.5\",\n \"source\": \"yelp\",\n \"type\": \"INTERNAL_PEERS\"\n },\n \"registrationIP\": \"203.12.55.12\",\n \"type\": \"BUSINESS\"\n },\n \"accountId\": \"e520-ba9a-367-60b\",\n \"additionalAccountEventIdentifiers\": {},\n \"additionalInformation\": {},\n \"channelType\": \"WEB\",\n \"connectionInformation\": {\n \"checkoutToolsSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"customerIP\": \"10.0.0.127\",\n \"forterMobileUID\": \"6429751237891\",\n \"forterTokenCookie\": \"249453te8tbf9355186fet0ken547b95_2786972955236__UDE52-n5_8dg\",\n \"merchantDeviceIdentifier\": \"HGJ7512345H3\",\n \"merchantProvidedSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"userAgent\": \"Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36\"\n },\n \"customerSignedInUsingSocialNetworkAccount\": {\n \"otherSocialNetwork\": \"VK\"\n },\n \"eventTime\": 1415287568000,\n \"promotions\": {\n \"couponCodeUsed\": \"FATHERSDAY2015\",\n \"couponDiscountAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"signupStatus\": \"SUCCESS\"\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\");\nmyHeaders.append(\"api-version\", \"10.1\");\nmyHeaders.append(\"x-forter-siteid\", \"8b47c6d423ba\");\nmyHeaders.append(\"authorization\", \"Basic \");\n\nvar raw = JSON.stringify({\n \"accountData\": {\n \"additionalVerificationDocuments\": {\n \"documentDateOfBirth\": \"1991-01-09\",\n \"documentExpiration\": \"2017-01-15\",\n \"documentFirstName\": \"John\",\n \"documentIssuingState\": \"NY\",\n \"documentLastName\": \"Smith\",\n \"documentNumber\": \"20439190\",\n \"documentSource\": \"UPLOADED_FILE\",\n \"documentStatus\": \"SENT_TO_CLIENT\",\n \"documentType\": \"Passport\",\n \"documentVerificationServiceAnswer\": \"APPROVED\",\n \"documentVerificationServiceName\": \"IDVerification.com\",\n \"documentVerificationServiceResponsePayload\": {},\n \"documentVerified\": true,\n \"eventTime\": 1420070400,\n \"nationality\": \"US\"\n },\n \"addressesInAccount\": [\n {\n \"address1\": \"235 Montgomery st.\",\n \"address2\": \"Ste. 1110\",\n \"city\": \"San Francisco\",\n \"company\": \"Generic Corp. ltd.\",\n \"country\": \"US\",\n \"region\": \"CA\",\n \"savedData\": {\n \"usedSavedData\": true\n },\n \"zip\": \"94104\"\n }\n ],\n \"customerEngagement\": {\n \"communityPostsWritten\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"followersCount\": 105,\n \"followingCount\": 230,\n \"invites\": [\n {\n \"invitationCounterpartyPhone\": \"+12126667777\",\n \"sent\": 1420955538,\n \"type\": \"SENT\"\n }\n ],\n \"likedItems\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"messagesReceived\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"messagesSent\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"newsletters\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"profilePicture\": true,\n \"requestedDemo\": true,\n \"reviewsWritten\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"savedLocations\": [\n {\n \"latitude\": 32.07332,\n \"longitude\": 34.79675,\n \"source\": \"MOBILE\"\n }\n ],\n \"sharedItems\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"signedUpForPushNotifications\": true,\n \"signedUpForSMSUpdates\": true,\n \"wishlist\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n }\n },\n \"emailsInAccount\": [\n {\n \"email\": \"john_s@test.com\",\n \"emailVerification\": {\n \"sent\": true,\n \"timeSent\": 1389567341,\n \"verified\": false\n }\n }\n ],\n \"paymentMethodsInAccount\": [\n {\n \"amount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"androidPay\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"applePay\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"bankTransfer\": {\n \"accountHolderFirstName\": \"John\",\n \"accountHolderLastName\": \"Smith\",\n \"achProcessingType\": \"SAME_DAY_ACH\",\n \"bankAccountIdentifier\": \"TEST63TEST1212121212\",\n \"bankAccountType\": \"Savings\",\n \"bankName\": \"Citigroup\",\n \"paymentGatewayData\": {\n \"gatewayName\": \"Braintree\",\n \"gatewayTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"paymentSuccessStatus\": \"Payment Successful\",\n \"serviceName\": \"Direct Debit\"\n },\n \"billingDetails\": {\n \"address\": {\n \"address1\": \"235 Montgomery st.\",\n \"address2\": \"Ste. 1110\",\n \"city\": \"San Francisco\",\n \"company\": \"Generic Corp. ltd.\",\n \"country\": \"US\",\n \"region\": \"CA\",\n \"savedData\": {\n \"usedSavedData\": true\n },\n \"zip\": \"94104\"\n },\n \"allAdditionalVerificationDocuments\": [\n {\n \"documentDateOfBirth\": \"1991-01-09\",\n \"documentExpiration\": \"2017-01-15\",\n \"documentFirstName\": \"John\",\n \"documentIssuingState\": \"NY\",\n \"documentLastName\": \"Smith\",\n \"documentNumber\": \"20439190\",\n \"documentSource\": \"UPLOADED_FILE\",\n \"documentStatus\": \"SENT_TO_CLIENT\",\n \"documentType\": \"Passport\",\n \"documentVerificationServiceAnswer\": \"APPROVED\",\n \"documentVerificationServiceName\": \"IDVerification.com\",\n \"documentVerificationServiceResponsePayload\": {},\n \"documentVerified\": true,\n \"eventTime\": 1420070400,\n \"nationality\": \"US\"\n }\n ],\n \"employmentInformation\": [\n {\n \"employerAddress\": {\n \"address1\": \"235 Montgomery st.\",\n \"address2\": \"Ste. 1110\",\n \"city\": \"San Francisco\",\n \"company\": \"Generic Corp. ltd.\",\n \"country\": \"US\",\n \"region\": \"CA\",\n \"savedData\": {},\n \"zip\": \"94104\"\n },\n \"employerCompanySizeRange\": \"20\",\n \"employerIndustry\": \"Retail\",\n \"employerName\": \"Forter\",\n \"employerPhone\": \"+12126667777\",\n \"income\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"jobTitle\": \"Fraud Analyst\"\n }\n ],\n \"personalDetails\": {\n \"birthdate\": \"1987-05-22\",\n \"email\": \"john_s@test.com\",\n \"firstName\": \"John\",\n \"fullName\": \"John Smith\",\n \"gender\": \"MALE\",\n \"lastName\": \"Smith\"\n },\n \"phone\": [\n {\n \"phone\": \"15557654321\",\n \"smsVerified\": {\n \"sent\": true,\n \"timeSent\": 1389567341,\n \"verified\": false\n }\n }\n ]\n },\n \"cameraCaptured\": true,\n \"creditCard\": {\n \"bin\": \"42424242\",\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fingerprint\": \"Xt5EWLLDS7FJjR1c\",\n \"fullCreditCard\": \"2424242424242424\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"creditLineDetails\": {\n \"askedToIncreaseCreditLineLimit\": false,\n \"creditLineLimitIncreaseMethod\": \"AT_PURCHASE\",\n \"currentCreditLineLimit\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"originalCreditLineLimit\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"cryptoWallet\": {\n \"cryptoWalletName\": \"CryptoWallet\",\n \"cryptoWalletPaymentId\": \"3JQiwG88SQvwihDAHg9M2EnqEisharz49c\",\n \"cryptoWalletType\": \"EXTERNAL\"\n },\n \"digitalWallet\": {\n \"digitalWalletName\": \"ALIPAY\",\n \"digitalWalletPayerEmail\": \"john_s@test.com\",\n \"digitalWalletPayerId\": \"FD000A45P\",\n \"digitalWalletpaymentId\": \"PAY-0MB00000KR8073311KZSDEYA\",\n \"freeTextDigitalWalletName\": \"ALIBABA\",\n \"fullDigitalWalletResponsePayload\": {},\n \"payerAccountCountry\": \"US\",\n \"paymentSuccessStatus\": \"COMPLETED\",\n \"underlyingPaymentMethod\": {\n \"bankTransfer\": {\n \"accountHolderFirstName\": \"John\",\n \"accountHolderLastName\": \"Smith\",\n \"achProcessingType\": \"SAME_DAY_ACH\",\n \"bankAccountIdentifier\": \"TEST63TEST1212121212\",\n \"bankAccountType\": \"Savings\",\n \"bankName\": \"Citigroup\",\n \"paymentGatewayData\": {},\n \"paymentSuccessStatus\": \"Payment Successful\",\n \"serviceName\": \"Direct Debit\"\n },\n \"creditCard\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {},\n \"threeDSecure\": {},\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {}\n },\n \"underlyingPaymentMethodType\": \"UNKNOWN\"\n }\n },\n \"giftCard\": {\n \"activationTime\": 1448549922,\n \"creditCurrency\": \"CAD\",\n \"creditOrigin\": \"CS Compensation\",\n \"merchantPaymentId\": \"eab12-ba9a-367-60b\",\n \"value\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"installmentService\": {\n \"firstName\": \"John\",\n \"fullResponsePayload\": {},\n \"lastName\": \"Smith\",\n \"paymentId\": \"YTZ8IATEGAWRRVVG\",\n \"serviceName\": \"Affirm\",\n \"serviceResponseCode\": \"200\"\n },\n \"loyaltyPoints\": {\n \"loyaltyPointsCount\": 1506,\n \"loyaltyPointsSource\": \"IN_ACCOUNT_PURCHASES\",\n \"loyaltyPointsValue\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"merchantPaymentId\": \"eab12-ba9a-367-60b\"\n },\n \"merchantInitiated\": {\n \"initialOrderId\": \"2356fdse0rr489\"\n },\n \"mobileMoney\": {\n \"fullResponsePayload\": {},\n \"mobileMoneyNetwork\": \"MPESA\",\n \"paymentAcquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"paymentGatewayData\": {\n \"gatewayName\": \"Braintree\",\n \"gatewayTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"paymentSuccessStatus\": \"success\",\n \"phoneNumber\": \"15557654321\"\n },\n \"numberOfInstallments\": 12,\n \"paymentMethodNickname\": \"My Work Card\",\n \"paypal\": {\n \"authorizationId\": \"2WC75407LV7300439\",\n \"fullPaypalResponsePayload\": {},\n \"payerAccountCountry\": \"US\",\n \"payerAddressStatus\": \"CONFIRMED\",\n \"payerEmail\": \"john_s@test.com\",\n \"payerId\": \"FD000A45P\",\n \"payerStatus\": \"VERIFIED\",\n \"paymentGatewayData\": {\n \"gatewayName\": \"Braintree\",\n \"gatewayTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"paymentId\": \"PAY-0MB00000KR8073311KZSDEYA\",\n \"paymentStatus\": \"COMPLETED\",\n \"protectionEligibility\": \"ELIGIBLE\"\n },\n \"recurringPayment\": {\n \"currentPaymentNumber\": 1,\n \"initialPaymentOrderId\": \"2356fdse0rr483\",\n \"recurringPaymentExpirationDate\": \"1988-06-22\",\n \"recurringPaymentFrequency\": \"7\",\n \"totalNumberOfPayments\": 12\n },\n \"samsungPay\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"savedData\": {\n \"usedSavedData\": true\n },\n \"storeCreditUsed\": {\n \"activationTime\": 1448549922,\n \"creditCurrency\": \"CAD\",\n \"creditOrigin\": \"CS Compensation\",\n \"merchantPaymentId\": \"eab12-ba9a-367-60b\",\n \"value\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"tokenizedCard\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"venmo\": {\n \"fullVenmoResponsePayload\": \"\",\n \"paymentId\": \"1KZSDEYA\",\n \"token\": \"77620C360132856A103477D2959967AB\",\n \"userId\": \"johndoe\",\n \"userName\": \"johndoe1987\"\n }\n }\n ],\n \"phonesInAccount\": [\n {\n \"phone\": \"15557654321\",\n \"smsVerified\": {\n \"sent\": true,\n \"timeSent\": 1389567341,\n \"verified\": false\n }\n }\n ],\n \"ratingAsBuyer\": {\n \"score\": \"4.5\",\n \"source\": \"yelp\",\n \"type\": \"INTERNAL_PEERS\"\n },\n \"registrationIP\": \"203.12.55.12\",\n \"type\": \"BUSINESS\"\n },\n \"accountId\": \"e520-ba9a-367-60b\",\n \"additionalAccountEventIdentifiers\": {},\n \"additionalInformation\": {},\n \"channelType\": \"WEB\",\n \"connectionInformation\": {\n \"checkoutToolsSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"customerIP\": \"10.0.0.127\",\n \"forterMobileUID\": \"6429751237891\",\n \"forterTokenCookie\": \"249453te8tbf9355186fet0ken547b95_2786972955236__UDE52-n5_8dg\",\n \"merchantDeviceIdentifier\": \"HGJ7512345H3\",\n \"merchantProvidedSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"userAgent\": \"Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36\"\n },\n \"customerSignedInUsingSocialNetworkAccount\": {\n \"otherSocialNetwork\": \"VK\"\n },\n \"eventTime\": 1415287568000,\n \"promotions\": {\n \"couponCodeUsed\": \"FATHERSDAY2015\",\n \"couponDiscountAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"signupStatus\": \"SUCCESS\"\n});\n\nvar requestOptions = {\n method: 'POST',\n headers: myHeaders,\n body: raw,\n redirect: 'follow'\n};\n\nfetch(\"https://api.forter-secure.com/v2/accounts/signup/{id}\", 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.forter-secure.com/v2/accounts/signup/{id}\")\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[\"api-version\"] = \"10.1\"\nrequest[\"x-forter-siteid\"] = \"8b47c6d423ba\"\nrequest[\"authorization\"] = \"Basic \"\nrequest.body = JSON.dump({\n \"accountData\": {\n \"additionalVerificationDocuments\": {\n \"documentDateOfBirth\": \"1991-01-09\",\n \"documentExpiration\": \"2017-01-15\",\n \"documentFirstName\": \"John\",\n \"documentIssuingState\": \"NY\",\n \"documentLastName\": \"Smith\",\n \"documentNumber\": \"20439190\",\n \"documentSource\": \"UPLOADED_FILE\",\n \"documentStatus\": \"SENT_TO_CLIENT\",\n \"documentType\": \"Passport\",\n \"documentVerificationServiceAnswer\": \"APPROVED\",\n \"documentVerificationServiceName\": \"IDVerification.com\",\n \"documentVerificationServiceResponsePayload\": {},\n \"documentVerified\": true,\n \"eventTime\": 1420070400,\n \"nationality\": \"US\"\n },\n \"addressesInAccount\": [\n {\n \"address1\": \"235 Montgomery st.\",\n \"address2\": \"Ste. 1110\",\n \"city\": \"San Francisco\",\n \"company\": \"Generic Corp. ltd.\",\n \"country\": \"US\",\n \"region\": \"CA\",\n \"savedData\": {\n \"usedSavedData\": true\n },\n \"zip\": \"94104\"\n }\n ],\n \"customerEngagement\": {\n \"communityPostsWritten\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"followersCount\": 105,\n \"followingCount\": 230,\n \"invites\": [\n {\n \"invitationCounterpartyPhone\": \"+12126667777\",\n \"sent\": 1420955538,\n \"type\": \"SENT\"\n }\n ],\n \"likedItems\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"messagesReceived\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"messagesSent\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"newsletters\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"profilePicture\": true,\n \"requestedDemo\": true,\n \"reviewsWritten\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"savedLocations\": [\n {\n \"latitude\": 32.07332,\n \"longitude\": 34.79675,\n \"source\": \"MOBILE\"\n }\n ],\n \"sharedItems\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"signedUpForPushNotifications\": true,\n \"signedUpForSMSUpdates\": true,\n \"wishlist\": {\n \"inUse\": true,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n }\n },\n \"emailsInAccount\": [\n {\n \"email\": \"john_s@test.com\",\n \"emailVerification\": {\n \"sent\": true,\n \"timeSent\": 1389567341,\n \"verified\": false\n }\n }\n ],\n \"paymentMethodsInAccount\": [\n {\n \"amount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"androidPay\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"applePay\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"bankTransfer\": {\n \"accountHolderFirstName\": \"John\",\n \"accountHolderLastName\": \"Smith\",\n \"achProcessingType\": \"SAME_DAY_ACH\",\n \"bankAccountIdentifier\": \"TEST63TEST1212121212\",\n \"bankAccountType\": \"Savings\",\n \"bankName\": \"Citigroup\",\n \"paymentGatewayData\": {\n \"gatewayName\": \"Braintree\",\n \"gatewayTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"paymentSuccessStatus\": \"Payment Successful\",\n \"serviceName\": \"Direct Debit\"\n },\n \"billingDetails\": {\n \"address\": {\n \"address1\": \"235 Montgomery st.\",\n \"address2\": \"Ste. 1110\",\n \"city\": \"San Francisco\",\n \"company\": \"Generic Corp. ltd.\",\n \"country\": \"US\",\n \"region\": \"CA\",\n \"savedData\": {\n \"usedSavedData\": true\n },\n \"zip\": \"94104\"\n },\n \"allAdditionalVerificationDocuments\": [\n {\n \"documentDateOfBirth\": \"1991-01-09\",\n \"documentExpiration\": \"2017-01-15\",\n \"documentFirstName\": \"John\",\n \"documentIssuingState\": \"NY\",\n \"documentLastName\": \"Smith\",\n \"documentNumber\": \"20439190\",\n \"documentSource\": \"UPLOADED_FILE\",\n \"documentStatus\": \"SENT_TO_CLIENT\",\n \"documentType\": \"Passport\",\n \"documentVerificationServiceAnswer\": \"APPROVED\",\n \"documentVerificationServiceName\": \"IDVerification.com\",\n \"documentVerificationServiceResponsePayload\": {},\n \"documentVerified\": true,\n \"eventTime\": 1420070400,\n \"nationality\": \"US\"\n }\n ],\n \"employmentInformation\": [\n {\n \"employerAddress\": {\n \"address1\": \"235 Montgomery st.\",\n \"address2\": \"Ste. 1110\",\n \"city\": \"San Francisco\",\n \"company\": \"Generic Corp. ltd.\",\n \"country\": \"US\",\n \"region\": \"CA\",\n \"savedData\": {},\n \"zip\": \"94104\"\n },\n \"employerCompanySizeRange\": \"20\",\n \"employerIndustry\": \"Retail\",\n \"employerName\": \"Forter\",\n \"employerPhone\": \"+12126667777\",\n \"income\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"jobTitle\": \"Fraud Analyst\"\n }\n ],\n \"personalDetails\": {\n \"birthdate\": \"1987-05-22\",\n \"email\": \"john_s@test.com\",\n \"firstName\": \"John\",\n \"fullName\": \"John Smith\",\n \"gender\": \"MALE\",\n \"lastName\": \"Smith\"\n },\n \"phone\": [\n {\n \"phone\": \"15557654321\",\n \"smsVerified\": {\n \"sent\": true,\n \"timeSent\": 1389567341,\n \"verified\": false\n }\n }\n ]\n },\n \"cameraCaptured\": true,\n \"creditCard\": {\n \"bin\": \"42424242\",\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fingerprint\": \"Xt5EWLLDS7FJjR1c\",\n \"fullCreditCard\": \"2424242424242424\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"creditLineDetails\": {\n \"askedToIncreaseCreditLineLimit\": false,\n \"creditLineLimitIncreaseMethod\": \"AT_PURCHASE\",\n \"currentCreditLineLimit\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"originalCreditLineLimit\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"cryptoWallet\": {\n \"cryptoWalletName\": \"CryptoWallet\",\n \"cryptoWalletPaymentId\": \"3JQiwG88SQvwihDAHg9M2EnqEisharz49c\",\n \"cryptoWalletType\": \"EXTERNAL\"\n },\n \"digitalWallet\": {\n \"digitalWalletName\": \"ALIPAY\",\n \"digitalWalletPayerEmail\": \"john_s@test.com\",\n \"digitalWalletPayerId\": \"FD000A45P\",\n \"digitalWalletpaymentId\": \"PAY-0MB00000KR8073311KZSDEYA\",\n \"freeTextDigitalWalletName\": \"ALIBABA\",\n \"fullDigitalWalletResponsePayload\": {},\n \"payerAccountCountry\": \"US\",\n \"paymentSuccessStatus\": \"COMPLETED\",\n \"underlyingPaymentMethod\": {\n \"bankTransfer\": {\n \"accountHolderFirstName\": \"John\",\n \"accountHolderLastName\": \"Smith\",\n \"achProcessingType\": \"SAME_DAY_ACH\",\n \"bankAccountIdentifier\": \"TEST63TEST1212121212\",\n \"bankAccountType\": \"Savings\",\n \"bankName\": \"Citigroup\",\n \"paymentGatewayData\": {},\n \"paymentSuccessStatus\": \"Payment Successful\",\n \"serviceName\": \"Direct Debit\"\n },\n \"creditCard\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {},\n \"threeDSecure\": {},\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {}\n },\n \"underlyingPaymentMethodType\": \"UNKNOWN\"\n }\n },\n \"giftCard\": {\n \"activationTime\": 1448549922,\n \"creditCurrency\": \"CAD\",\n \"creditOrigin\": \"CS Compensation\",\n \"merchantPaymentId\": \"eab12-ba9a-367-60b\",\n \"value\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"installmentService\": {\n \"firstName\": \"John\",\n \"fullResponsePayload\": {},\n \"lastName\": \"Smith\",\n \"paymentId\": \"YTZ8IATEGAWRRVVG\",\n \"serviceName\": \"Affirm\",\n \"serviceResponseCode\": \"200\"\n },\n \"loyaltyPoints\": {\n \"loyaltyPointsCount\": 1506,\n \"loyaltyPointsSource\": \"IN_ACCOUNT_PURCHASES\",\n \"loyaltyPointsValue\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"merchantPaymentId\": \"eab12-ba9a-367-60b\"\n },\n \"merchantInitiated\": {\n \"initialOrderId\": \"2356fdse0rr489\"\n },\n \"mobileMoney\": {\n \"fullResponsePayload\": {},\n \"mobileMoneyNetwork\": \"MPESA\",\n \"paymentAcquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"paymentGatewayData\": {\n \"gatewayName\": \"Braintree\",\n \"gatewayTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"paymentSuccessStatus\": \"success\",\n \"phoneNumber\": \"15557654321\"\n },\n \"numberOfInstallments\": 12,\n \"paymentMethodNickname\": \"My Work Card\",\n \"paypal\": {\n \"authorizationId\": \"2WC75407LV7300439\",\n \"fullPaypalResponsePayload\": {},\n \"payerAccountCountry\": \"US\",\n \"payerAddressStatus\": \"CONFIRMED\",\n \"payerEmail\": \"john_s@test.com\",\n \"payerId\": \"FD000A45P\",\n \"payerStatus\": \"VERIFIED\",\n \"paymentGatewayData\": {\n \"gatewayName\": \"Braintree\",\n \"gatewayTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"paymentId\": \"PAY-0MB00000KR8073311KZSDEYA\",\n \"paymentStatus\": \"COMPLETED\",\n \"protectionEligibility\": \"ELIGIBLE\"\n },\n \"recurringPayment\": {\n \"currentPaymentNumber\": 1,\n \"initialPaymentOrderId\": \"2356fdse0rr483\",\n \"recurringPaymentExpirationDate\": \"1988-06-22\",\n \"recurringPaymentFrequency\": \"7\",\n \"totalNumberOfPayments\": 12\n },\n \"samsungPay\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"savedData\": {\n \"usedSavedData\": true\n },\n \"storeCreditUsed\": {\n \"activationTime\": 1448549922,\n \"creditCurrency\": \"CAD\",\n \"creditOrigin\": \"CS Compensation\",\n \"merchantPaymentId\": \"eab12-ba9a-367-60b\",\n \"value\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"tokenizedCard\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": true,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": true,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"venmo\": {\n \"fullVenmoResponsePayload\": \"\",\n \"paymentId\": \"1KZSDEYA\",\n \"token\": \"77620C360132856A103477D2959967AB\",\n \"userId\": \"johndoe\",\n \"userName\": \"johndoe1987\"\n }\n }\n ],\n \"phonesInAccount\": [\n {\n \"phone\": \"15557654321\",\n \"smsVerified\": {\n \"sent\": true,\n \"timeSent\": 1389567341,\n \"verified\": false\n }\n }\n ],\n \"ratingAsBuyer\": {\n \"score\": \"4.5\",\n \"source\": \"yelp\",\n \"type\": \"INTERNAL_PEERS\"\n },\n \"registrationIP\": \"203.12.55.12\",\n \"type\": \"BUSINESS\"\n },\n \"accountId\": \"e520-ba9a-367-60b\",\n \"additionalAccountEventIdentifiers\": {},\n \"additionalInformation\": {},\n \"channelType\": \"WEB\",\n \"connectionInformation\": {\n \"checkoutToolsSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"customerIP\": \"10.0.0.127\",\n \"forterMobileUID\": \"6429751237891\",\n \"forterTokenCookie\": \"249453te8tbf9355186fet0ken547b95_2786972955236__UDE52-n5_8dg\",\n \"merchantDeviceIdentifier\": \"HGJ7512345H3\",\n \"merchantProvidedSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"userAgent\": \"Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36\"\n },\n \"customerSignedInUsingSocialNetworkAccount\": {\n \"otherSocialNetwork\": \"VK\"\n },\n \"eventTime\": 1415287568000,\n \"promotions\": {\n \"couponCodeUsed\": \"FATHERSDAY2015\",\n \"couponDiscountAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"signupStatus\": \"SUCCESS\"\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.forter-secure.com/v2/accounts/signup/{id}\"\n\npayload = json.dumps({\n \"accountData\": {\n \"additionalVerificationDocuments\": {\n \"documentDateOfBirth\": \"1991-01-09\",\n \"documentExpiration\": \"2017-01-15\",\n \"documentFirstName\": \"John\",\n \"documentIssuingState\": \"NY\",\n \"documentLastName\": \"Smith\",\n \"documentNumber\": \"20439190\",\n \"documentSource\": \"UPLOADED_FILE\",\n \"documentStatus\": \"SENT_TO_CLIENT\",\n \"documentType\": \"Passport\",\n \"documentVerificationServiceAnswer\": \"APPROVED\",\n \"documentVerificationServiceName\": \"IDVerification.com\",\n \"documentVerificationServiceResponsePayload\": {},\n \"documentVerified\": True,\n \"eventTime\": 1420070400,\n \"nationality\": \"US\"\n },\n \"addressesInAccount\": [\n {\n \"address1\": \"235 Montgomery st.\",\n \"address2\": \"Ste. 1110\",\n \"city\": \"San Francisco\",\n \"company\": \"Generic Corp. ltd.\",\n \"country\": \"US\",\n \"region\": \"CA\",\n \"savedData\": {\n \"usedSavedData\": True\n },\n \"zip\": \"94104\"\n }\n ],\n \"customerEngagement\": {\n \"communityPostsWritten\": {\n \"inUse\": True,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"followersCount\": 105,\n \"followingCount\": 230,\n \"invites\": [\n {\n \"invitationCounterpartyPhone\": \"+12126667777\",\n \"sent\": 1420955538,\n \"type\": \"SENT\"\n }\n ],\n \"likedItems\": {\n \"inUse\": True,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"messagesReceived\": {\n \"inUse\": True,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"messagesSent\": {\n \"inUse\": True,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"newsletters\": {\n \"inUse\": True,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"profilePicture\": True,\n \"requestedDemo\": True,\n \"reviewsWritten\": {\n \"inUse\": True,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"savedLocations\": [\n {\n \"latitude\": 32.07332,\n \"longitude\": 34.79675,\n \"source\": \"MOBILE\"\n }\n ],\n \"sharedItems\": {\n \"inUse\": True,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n },\n \"signedUpForPushNotifications\": True,\n \"signedUpForSMSUpdates\": True,\n \"wishlist\": {\n \"inUse\": True,\n \"itemInListCount\": 4,\n \"updateTimes\": {\n \"creationTime\": 1448549922,\n \"lastModifiedTime\": 1448549922,\n \"lastUsed\": 1448560456,\n \"removalTime\": 1448895522\n }\n }\n },\n \"emailsInAccount\": [\n {\n \"email\": \"john_s@test.com\",\n \"emailVerification\": {\n \"sent\": True,\n \"timeSent\": 1389567341,\n \"verified\": False\n }\n }\n ],\n \"paymentMethodsInAccount\": [\n {\n \"amount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"androidPay\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": True,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": True,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"applePay\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": True,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": True,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"bankTransfer\": {\n \"accountHolderFirstName\": \"John\",\n \"accountHolderLastName\": \"Smith\",\n \"achProcessingType\": \"SAME_DAY_ACH\",\n \"bankAccountIdentifier\": \"TEST63TEST1212121212\",\n \"bankAccountType\": \"Savings\",\n \"bankName\": \"Citigroup\",\n \"paymentGatewayData\": {\n \"gatewayName\": \"Braintree\",\n \"gatewayTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"paymentSuccessStatus\": \"Payment Successful\",\n \"serviceName\": \"Direct Debit\"\n },\n \"billingDetails\": {\n \"address\": {\n \"address1\": \"235 Montgomery st.\",\n \"address2\": \"Ste. 1110\",\n \"city\": \"San Francisco\",\n \"company\": \"Generic Corp. ltd.\",\n \"country\": \"US\",\n \"region\": \"CA\",\n \"savedData\": {\n \"usedSavedData\": True\n },\n \"zip\": \"94104\"\n },\n \"allAdditionalVerificationDocuments\": [\n {\n \"documentDateOfBirth\": \"1991-01-09\",\n \"documentExpiration\": \"2017-01-15\",\n \"documentFirstName\": \"John\",\n \"documentIssuingState\": \"NY\",\n \"documentLastName\": \"Smith\",\n \"documentNumber\": \"20439190\",\n \"documentSource\": \"UPLOADED_FILE\",\n \"documentStatus\": \"SENT_TO_CLIENT\",\n \"documentType\": \"Passport\",\n \"documentVerificationServiceAnswer\": \"APPROVED\",\n \"documentVerificationServiceName\": \"IDVerification.com\",\n \"documentVerificationServiceResponsePayload\": {},\n \"documentVerified\": True,\n \"eventTime\": 1420070400,\n \"nationality\": \"US\"\n }\n ],\n \"employmentInformation\": [\n {\n \"employerAddress\": {\n \"address1\": \"235 Montgomery st.\",\n \"address2\": \"Ste. 1110\",\n \"city\": \"San Francisco\",\n \"company\": \"Generic Corp. ltd.\",\n \"country\": \"US\",\n \"region\": \"CA\",\n \"savedData\": {},\n \"zip\": \"94104\"\n },\n \"employerCompanySizeRange\": \"20\",\n \"employerIndustry\": \"Retail\",\n \"employerName\": \"Forter\",\n \"employerPhone\": \"+12126667777\",\n \"income\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"jobTitle\": \"Fraud Analyst\"\n }\n ],\n \"personalDetails\": {\n \"birthdate\": \"1987-05-22\",\n \"email\": \"john_s@test.com\",\n \"firstName\": \"John\",\n \"fullName\": \"John Smith\",\n \"gender\": \"MALE\",\n \"lastName\": \"Smith\"\n },\n \"phone\": [\n {\n \"phone\": \"15557654321\",\n \"smsVerified\": {\n \"sent\": True,\n \"timeSent\": 1389567341,\n \"verified\": False\n }\n }\n ]\n },\n \"cameraCaptured\": True,\n \"creditCard\": {\n \"bin\": \"42424242\",\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fingerprint\": \"Xt5EWLLDS7FJjR1c\",\n \"fullCreditCard\": \"2424242424242424\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": True,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": True,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"creditLineDetails\": {\n \"askedToIncreaseCreditLineLimit\": False,\n \"creditLineLimitIncreaseMethod\": \"AT_PURCHASE\",\n \"currentCreditLineLimit\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"originalCreditLineLimit\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"cryptoWallet\": {\n \"cryptoWalletName\": \"CryptoWallet\",\n \"cryptoWalletPaymentId\": \"3JQiwG88SQvwihDAHg9M2EnqEisharz49c\",\n \"cryptoWalletType\": \"EXTERNAL\"\n },\n \"digitalWallet\": {\n \"digitalWalletName\": \"ALIPAY\",\n \"digitalWalletPayerEmail\": \"john_s@test.com\",\n \"digitalWalletPayerId\": \"FD000A45P\",\n \"digitalWalletpaymentId\": \"PAY-0MB00000KR8073311KZSDEYA\",\n \"freeTextDigitalWalletName\": \"ALIBABA\",\n \"fullDigitalWalletResponsePayload\": {},\n \"payerAccountCountry\": \"US\",\n \"paymentSuccessStatus\": \"COMPLETED\",\n \"underlyingPaymentMethod\": {\n \"bankTransfer\": {\n \"accountHolderFirstName\": \"John\",\n \"accountHolderLastName\": \"Smith\",\n \"achProcessingType\": \"SAME_DAY_ACH\",\n \"bankAccountIdentifier\": \"TEST63TEST1212121212\",\n \"bankAccountType\": \"Savings\",\n \"bankName\": \"Citigroup\",\n \"paymentGatewayData\": {},\n \"paymentSuccessStatus\": \"Payment Successful\",\n \"serviceName\": \"Direct Debit\"\n },\n \"creditCard\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {},\n \"threeDSecure\": {},\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {}\n },\n \"underlyingPaymentMethodType\": \"UNKNOWN\"\n }\n },\n \"giftCard\": {\n \"activationTime\": 1448549922,\n \"creditCurrency\": \"CAD\",\n \"creditOrigin\": \"CS Compensation\",\n \"merchantPaymentId\": \"eab12-ba9a-367-60b\",\n \"value\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"installmentService\": {\n \"firstName\": \"John\",\n \"fullResponsePayload\": {},\n \"lastName\": \"Smith\",\n \"paymentId\": \"YTZ8IATEGAWRRVVG\",\n \"serviceName\": \"Affirm\",\n \"serviceResponseCode\": \"200\"\n },\n \"loyaltyPoints\": {\n \"loyaltyPointsCount\": 1506,\n \"loyaltyPointsSource\": \"IN_ACCOUNT_PURCHASES\",\n \"loyaltyPointsValue\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"merchantPaymentId\": \"eab12-ba9a-367-60b\"\n },\n \"merchantInitiated\": {\n \"initialOrderId\": \"2356fdse0rr489\"\n },\n \"mobileMoney\": {\n \"fullResponsePayload\": {},\n \"mobileMoneyNetwork\": \"MPESA\",\n \"paymentAcquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"paymentGatewayData\": {\n \"gatewayName\": \"Braintree\",\n \"gatewayTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"paymentSuccessStatus\": \"success\",\n \"phoneNumber\": \"15557654321\"\n },\n \"numberOfInstallments\": 12,\n \"paymentMethodNickname\": \"My Work Card\",\n \"paypal\": {\n \"authorizationId\": \"2WC75407LV7300439\",\n \"fullPaypalResponsePayload\": {},\n \"payerAccountCountry\": \"US\",\n \"payerAddressStatus\": \"CONFIRMED\",\n \"payerEmail\": \"john_s@test.com\",\n \"payerId\": \"FD000A45P\",\n \"payerStatus\": \"VERIFIED\",\n \"paymentGatewayData\": {\n \"gatewayName\": \"Braintree\",\n \"gatewayTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"paymentId\": \"PAY-0MB00000KR8073311KZSDEYA\",\n \"paymentStatus\": \"COMPLETED\",\n \"protectionEligibility\": \"ELIGIBLE\"\n },\n \"recurringPayment\": {\n \"currentPaymentNumber\": 1,\n \"initialPaymentOrderId\": \"2356fdse0rr483\",\n \"recurringPaymentExpirationDate\": \"1988-06-22\",\n \"recurringPaymentFrequency\": \"7\",\n \"totalNumberOfPayments\": 12\n },\n \"samsungPay\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": True,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": True,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"savedData\": {\n \"usedSavedData\": True\n },\n \"storeCreditUsed\": {\n \"activationTime\": 1448549922,\n \"creditCurrency\": \"CAD\",\n \"creditOrigin\": \"CS Compensation\",\n \"merchantPaymentId\": \"eab12-ba9a-367-60b\",\n \"value\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"tokenizedCard\": {\n \"cardBank\": \"Chase\",\n \"cardBrand\": \"VISA\",\n \"cardType\": \"CREDIT\",\n \"countryOfIssuance\": \"US\",\n \"creationTime\": 1430997968,\n \"expirationMonth\": \"03\",\n \"expirationYear\": \"2018\",\n \"fullResponsePayload\": {},\n \"lastFourDigits\": \"4242\",\n \"nameOnCard\": \"John R. H. Smith\",\n \"paymentProcessorData\": {\n \"processorName\": \"Chase Paymentech\",\n \"processorTransactionId\": \"fjdsS46sdklFd20\"\n },\n \"threeDSecure\": {\n \"acquirerData\": {\n \"acquirerBIN\": \"457173\",\n \"acquirerCountry\": \"US\",\n \"acquirerMerchantId\": \"5245020244654\",\n \"acquirerMerchantName\": \"Simple T-shirt\",\n \"acquirerName\": \"Barclays\",\n \"merchantCategoryCode\": 5655,\n \"merchantCountryCode\": 840\n },\n \"challengeIndicator\": \"NO_PREFERENCE\",\n \"execute3ds\": \"DYNAMIC_FORTER_DECISION\",\n \"forcePsd2Exemption\": {\n \"channel\": \"THREEDS_RAILS\",\n \"type\": \"LOW_VALUE\"\n },\n \"threeDSServerTransID\": \"26d648a9-da8a-4f8b-a76d-094801d2fd45\"\n },\n \"token\": \"tkn-77620C360132856A103477D2959967AB\",\n \"verificationResults\": {\n \"authorizationCode\": \"A33244\",\n \"authorizationProcessedWith3DS\": True,\n \"avsFullResult\": \"Y\",\n \"avsNameResult\": \"M\",\n \"avsStreetResult\": \"N\",\n \"avsZipResult\": \"M\",\n \"cavvResult\": \"VYboNwcsB3F9gTIsbaUjvEuLW0o=\",\n \"cvvResult\": \"M\",\n \"eciValue\": \"05\",\n \"liabilityShift\": True,\n \"processorResponseCode\": \"D23\",\n \"processorResponseText\": \"Stolen card\",\n \"threeDsStatus\": \"Cardholder authenticated\",\n \"threeDsVersion\": \"2.1.0\"\n }\n },\n \"venmo\": {\n \"fullVenmoResponsePayload\": \"\",\n \"paymentId\": \"1KZSDEYA\",\n \"token\": \"77620C360132856A103477D2959967AB\",\n \"userId\": \"johndoe\",\n \"userName\": \"johndoe1987\"\n }\n }\n ],\n \"phonesInAccount\": [\n {\n \"phone\": \"15557654321\",\n \"smsVerified\": {\n \"sent\": True,\n \"timeSent\": 1389567341,\n \"verified\": False\n }\n }\n ],\n \"ratingAsBuyer\": {\n \"score\": \"4.5\",\n \"source\": \"yelp\",\n \"type\": \"INTERNAL_PEERS\"\n },\n \"registrationIP\": \"203.12.55.12\",\n \"type\": \"BUSINESS\"\n },\n \"accountId\": \"e520-ba9a-367-60b\",\n \"additionalAccountEventIdentifiers\": {},\n \"additionalInformation\": {},\n \"channelType\": \"WEB\",\n \"connectionInformation\": {\n \"checkoutToolsSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"customerIP\": \"10.0.0.127\",\n \"forterMobileUID\": \"6429751237891\",\n \"forterTokenCookie\": \"249453te8tbf9355186fet0ken547b95_2786972955236__UDE52-n5_8dg\",\n \"merchantDeviceIdentifier\": \"HGJ7512345H3\",\n \"merchantProvidedSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"userAgent\": \"Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36\"\n },\n \"customerSignedInUsingSocialNetworkAccount\": {\n \"otherSocialNetwork\": \"VK\"\n },\n \"eventTime\": 1415287568000,\n \"promotions\": {\n \"couponCodeUsed\": \"FATHERSDAY2015\",\n \"couponDiscountAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"signupStatus\": \"SUCCESS\"\n})\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json',\n 'api-version': '10.1',\n 'x-forter-siteid': '8b47c6d423ba',\n 'authorization': 'Basic '\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": "// Example adaptiveAuthAccountsResponse\n{\n \"accountId\": \"\",\n \"correlationId\": \"\",\n \"decisionReason\": \"\",\n \"forterDecision\": \"\",\n \"merchantPolicyId\": \"\",\n \"recommendation\": \"\",\n \"verificationMethod\": {\n \"correlationId\": \"\",\n \"status\": \"\",\n \"statusCode\": \"\",\n \"statusMessage\": \"\",\n \"type\": \"\",\n \"verificationId\": \"\",\n \"verificationSpecificData\": {\n \"ThreeDS\": {},\n \"email\": {},\n \"phone\": {}\n }\n }\n}" }, { "id": "response-1-400", "language": "400", "code": "// Bad Request (Often missing a required parameter)\n" }, { "id": "response-2-401", "language": "401", "code": "// Unauthorized (No valid API key provided)\n" }, { "id": "response-3-404", "language": "404", "code": "// Not Found (The requested item doesn't exist)\n" }, { "id": "response-4-500", "language": "500", "code": "// Server Error (Something went wrong on Forter's end)\n" } ], "selectedLanguageId": "response-0-200" } }, "children": [ { "id": "-NwCviZMNbW-Q7Woh6EG2", "type": "paragraph", "children": [ { "text": "サインアップ時にアカウント登録情報を送信して、詐欺または悪用の判断を受け取ります。" } ] } ] }