Challenge Response

Respond to a Challenge Request

post/v1/three_ds_decisioning/challenge_response

Card program's response to a 3DS Challenge Request. Challenge Request is emitted as a webhook three_ds_authentication.challenge and your Card Program needs to be configured with Out of Band (OOB) Challenges in order to receive it (see https://docs.lithic.com/docs/3ds-challenge-flow for more information).

Body Parameters

tokenstring

Globally unique identifier for 3DS Authentication that resulted in PENDING_CHALLENGE authentication result.

formatuuid

challenge_responseChallengeResult

Whether the Cardholder has approved or declined the issued Challenge

Request example Request

curl https://api.lithic.com/v1/three_ds_decisioning/challenge_response \
    -H 'Content-Type: application/json' \
    -H "Authorization: $LITHIC_API_KEY" \
    -d '{
      "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "challenge_response": "APPROVE"
    }'