increase-test
POST/real_time_decisions/{real_time_decision_id}/action

Submit a response to a real-time decision

Submits your application's response to a real-time decision. Use the real_time_decision_id path parameter to select the decision, then provide the response object that matches its event type. The decision fields accept only the values defined for that event.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 6 body fields
real_time_decision_idstringrequired
The identifier of the real-time decision to respond to.

Your response to the real-time decision. Include the object that corresponds to the decision's event type.

card_authenticationobjectoptional
If the Real-Time Decision relates to a 3DS card authentication attempt, this object contains your response to the authentication.
card_authentication_challengeobjectoptional
If the Real-Time Decision relates to 3DS card authentication challenge delivery, this object contains your response.
card_authorizationobjectoptional
If the Real-Time Decision relates to a card authorization attempt, this object contains your response to the authorization.
card_balance_inquiryobjectoptional
If the Real-Time Decision relates to a card balance inquiry attempt, this object contains your response to the inquiry.
digital_wallet_authenticationobjectoptional
If the Real-Time Decision relates to a digital wallet authentication attempt, this object contains your response to the authentication.
digital_wallet_tokenobjectoptional
If the Real-Time Decision relates to a digital wallet token provisioning attempt, this object contains your response to the attempt.

3 status codes
200Returns the updated real-time decision object, including its status and event-specific details.
card_authenticationobjectrequired
Fields related to a 3DS authentication attempt.
card_authentication_challengeobjectrequired
Fields related to a 3DS authentication attempt.
card_authorizationobjectrequired
Fields related to a card authorization.
card_balance_inquiryobjectrequired
Fields related to a card balance inquiry.
categorystringrequired
The category of the Real-Time Decision.
Allowed:card_authorization_requestedcard_balance_inquiry_requestedcard_authentication_requestedcard_authentication_challenge_requesteddigital_wallet_token_requesteddigital_wallet_authentication_requested
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Real-Time Decision was created.
digital_wallet_authenticationobjectrequired
Fields related to a digital wallet authentication attempt.
digital_wallet_tokenobjectrequired
Fields related to a digital wallet token provisioning attempt.
idstringrequired
The Real-Time Decision identifier.
statusstringrequired
The status of the Real-Time Decision.
Allowed:pendingrespondedtimed_out
timeout_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which your application can no longer respond to the Real-Time Decision.
typestringrequired
A constant representing the object's type. For this resource it will always be `real_time_decision`.
Allowed:real_time_decision
4XXReturned when the request cannot be processed because of a client error.
5XXReturned when the server encounters an error processing the request.

Error handling

The real_time_decision_id path parameter must identify an existing real-time decision. Provide the response object for the event type: card_authorization.decision must be approve or decline, card_authentication.decision must be approve, challenge, or deny, and the other decision fields must use their defined enum values. When reporting successful digital wallet authentication, provide exactly one of phone or email in digital_wallet_authentication.success.