Docs
Guides
Explanatory and how-to content
API Reference
Technical documentation
Changelog
Release notes
Dashboard
Manage your account
Status
Service status
API Reference
Real-Time Decisions

Real Time Decisions are created when your application needs to take action in real-time to some event such as a card authorization. For more information, see our Real-Time Decisions guide.

The Real-Time Decision object
{
  "card_authentication": null,
  "card_authentication_challenge": null,
  "card_authorization": {
    "account_id": "account_in71c4amph0vgo2qllky",
    "card_id": "card_oubs0hwk5rn6knuecxg2",
    "decision": "approve",
    "digital_wallet_token_id": null,
    "direction": "settlement",
    "merchant_acceptor_id": "5665270011000168",
    "merchant_category_code": "5734",
    "merchant_city": "New York",
    "merchant_country": "US",
    "merchant_descriptor": "AMAZON.COM",
    "merchant_postal_code": "10045",
    "merchant_state": "NY",
    "network_details": {
      "category": "visa",
      "visa": {
        "electronic_commerce_indicator": "secure_electronic_commerce",
        "point_of_service_entry_mode": "manual",
        "stand_in_processing_reason": null
      }
    },
    "network_identifiers": {
      "retrieval_reference_number": "785867080153",
      "trace_number": "487941",
      "transaction_id": "627199945183184"
    },
    "network_risk_score": 10,
    "physical_card_id": null,
    "presentment_amount": 100,
    "presentment_currency": "USD",
    "processing_category": "purchase",
    "request_details": {
      "category": "initial_authorization",
      "incremental_authorization": null,
      "initial_authorization": {}
    },
    "settlement_amount": 100,
    "settlement_currency": "USD",
    "terminal_id": "RCN5VNXS",
    "upcoming_card_payment_id": "card_payment_nd3k2kacrqjli8482ave",
    "verification": {
      "card_verification_code": {
        "result": "match"
      },
      "cardholder_address": {
        "actual_line1": "33 Liberty Street",
        "actual_postal_code": "94131",
        "provided_line1": "33 Liberty Street",
        "provided_postal_code": "94132",
        "result": "postal_code_no_match_address_match"
      }
    }
  },
  "category": "card_authorization_requested",
  "created_at": "2020-01-31T23:59:59Z",
  "digital_wallet_authentication": null,
  "digital_wallet_token": null,
  "id": "real_time_decision_j76n2e810ezcg3zh5qtn",
  "status": "pending",
  "timeout_at": "2020-01-31T23:59:59Z",
  "type": "real_time_decision"
}
Attributes
card_authentication
dictionary
Nullable

Fields related to a 3DS authentication attempt.

card_authentication_challenge
dictionary
Nullable

Fields related to a 3DS authentication attempt.

card_authorization
dictionary
Nullable

Fields related to a card authorization.

category
enum

The category of the Real-Time Decision.

created_at
string

The ISO 8601 date and time at which the Real-Time Decision was created.

digital_wallet_authentication
dictionary
Nullable

Fields related to a digital wallet authentication attempt.

digital_wallet_token
dictionary
Nullable

Fields related to a digital wallet token provisioning attempt.

id
string

The Real-Time Decision identifier.

status
enum

The status of the Real-Time Decision.

timeout_at
string

The ISO 8601 date and time at which your application can no longer respond to the Real-Time Decision.

type
string

A constant representing the object's type. For this resource it will always be real_time_decision.

Retrieve a Real-Time Decision
curl \
  --url "${INCREASE_URL}/real_time_decisions/real_time_decision_j76n2e810ezcg3zh5qtn" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"
Parameters
real_time_decision_id
string
Required

The identifier of the Real-Time Decision.

Action a Real-Time Decision
curl -X "POST" \
  --url "${INCREASE_URL}/real_time_decisions/real_time_decision_j76n2e810ezcg3zh5qtn/action" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d $'{
    "card_authorization": {
      "decision": "approve"
    }
  }'
Parameters
real_time_decision_id
string
Required

The identifier of the Real-Time Decision.

card_authentication
dictionary

If the Real-Time Decision relates to a 3DS card authentication attempt, this object contains your response to the authentication.

card_authentication_challenge
dictionary

If the Real-Time Decision relates to 3DS card authentication challenge delivery, this object contains your response.

card_authorization
dictionary

If the Real-Time Decision relates to a card authorization attempt, this object contains your response to the authorization.

digital_wallet_authentication
dictionary

If the Real-Time Decision relates to a digital wallet authentication attempt, this object contains your response to the authentication.

digital_wallet_token
dictionary

If the Real-Time Decision relates to a digital wallet token provisioning attempt, this object contains your response to the attempt.