Create decision

Attributes of the request

The request of Firstoken Decision Manager request, has the following attributes

transaction_info {object}

Required: true

Represents the information details of the request in a JSON object. The object has the following attributes:

• type: string Type value represent the type of request that is sent.

  Example: “authorization”

  Required: true

card {object}

Required: true

Represents the credit card JSON object. The object has the attributes:

• number: int Represents a Luhm compliant credit card value. Example: "4242424242424242" Required: true

• expiration_date: string Represents the expiration date of the card. Example: "01/27" | "01/2027" Required: true

order_info {object}

Required: true

This object represents the order information details with the attributes:

• amount_details: {object} Represents the amount information details for the transaction, must contain these attributes:

  • total_amount: integer Represents the total of the transaction. Example: 1000 Required: true

  • currency: string Represents the currency. Use the three-character ISO Standard Currency Codes. Example: "COP" Required: true

bill_to {object}

Required: true

Represents the billing JSON object with the following the attributes:

• first_name: string

  Example: “Steve”

  Required: true.

• last_name: string

  Example: “Jobs”

  Required: true.

• country: string

  Example: “United States”

  Required: true.

• address_1: string

  Example: “412 W, Flower Village”

  Required: true.

• address_2: string

  Example: “apartment 54”

  Required: true.

• city: string

  Example: “Miami”

  Required: true.

• states: string

  Example: “Florida”

  Required: true.

• phone_number: string

  Example: “2561234567”

  Required: true.

• email: string

  Example: “[e-mail]”

  Required: true.

• postal_code: string

  Example: “33125”

  Required: true

device_info {object}

Required: false

Represents the device information JSON object, provide information about the device like the following attribute:

• fingerprint_session_id: string A unique identifier for the session associated with the device (received in the capture data step).

  Example: “577686797679”

  Required: false

• ip_address: string IP address of the device.

  Example: “181.98.78.6”

  Required: false

• http_browser_color_depth: string The color depth supported by the browser in bits.

  Example: “24”

  Required: false

• http_browser_java_enabled: string Indicates whether Java is enabled in the browser (true/false).

  Example: “false”

  Required: false

• http_browser_js_enabled: string Indicates whether JavaScript is enabled in the browser (true/false). Example: “true” Required: false

• http_browser_screen_height: string The height of the browser screen in pixels. Example: “1080" Required: false

• http_browser_screen_width: string Indicates whether JavaScript is enabled in the browser (true/false). Example: “1920” Required: false

• http_browser_time_offset: string The time offset in minutes from UTC. Example: “300” Required: false

• user_agent: string The user agent string that identifies the browser and operating system. Example: “Mozilla/5.0” Required: false

• cookies_accepted: string Indicates whether cookies are accepted by the browser (true/false). Example: “true” Required: false

• http_browser_language: string The language preference of the browser. Example: “en-US” Required: false

device_info [array]

Required: false

Represents custom merchant information array of objects of key/value defined by the merchant for additional information.

Attributes of the response

• status: string The status is a string result that only has three possible values. "Success", "Fail" or “error”.

• message: string The message value represents a short description about the status received.

• data: {object} The data variable represents the information expected from the request made. This contains the payment information and the decision of the transaction

Example of the JSON response

{
  "status": "success",
  "message": "Transaction rejected",
  "data": {
    "transaction_info": {
      "type": "create_decision_response",
      "reference_code": "80caa37c-da4f-476a-950b-7679e2f45bb9",
      "transaction_id": "0001711566838525825990",
      "request_id": "7115668389676468804951",
      "status": "Rejected",
      "created_at": "2024-03-27T19:13:59Z"
    },
    "payment_information": {
      "scheme": "VISA DEBIT",
      "bin": "462294",
      "accountType": "Visa Classic",
      "issuer": "INTL HDQTRS-CENTER OWNED",
      "binCountry": "US"
    },
    "risk_info": {
      "score": "82",
      "model_used": "default",
      "info_codes": {
        "address": [
          "COR-BA"
        ],
        "phone": [
          "UNV-PH"
        ],
        "globalVelocity": [
          "VEL-ADDR",
          "VEL-NAME",
          "VELI-CC",
          "VELL-CC",
          "VELL-FP",
          "VELL-TIP",
          "VELS-CC",
          "VELS-FP",
          "VELS-TIP",
          "VELV-CC"
        ],
        "suspicious": [
          "MUL-EM"
        ],
        "identityChange": [
          "ID-X-NEG",
          "MORPH-C",
          "MORPH-FE"
        ],
        "internet": [
          "INTL-IPCO",
          "MM-IPBCO"
        ]
      },
      "profile": {
        "earlyDecision": "REJECT"
      },
      "providers": {
        "fingerprint": {
          "first_encounter": "03/12/2024",
          "smart_id": "53994e7085084e218ab52635913e5035",
          "true_ipaddress_country": "PA",
          "device_match": "success",
          "true_ipaddress_city": "panama",
          "time_on_page": "5012",
          "cookies_enabled": "true",
          "device_match_again": "success",
          "flash_enabled": "false",
          "profile_duration": "68",
          "screen_resolution": "1920x1080",
          "true_ipaddress": "190.123.237.237",
          "test_risk_rating": "neutral",
          "agent_type": "browser_computer",
          "images_enabled": "true",
          "javascript_enabled": "true",
          "date_time": "2024-03-27T191354Z",
          "strong_id": "bd55bc3065d5bc45390b298dfd16e2ef9c7ce418",
          "browser_language": "en-US,en;q=0.9",
          "hash": "7c66d47f14024a1080dc19d4e18a13ed",
          "smart_id_confidence_level": "100.00"
        }
      },
      "case_priority": "1"
    }
  }
}}