SLslashfi

Decline a 3D Secure challenge

Changed on

Reject the purchase on the cardholder's behalf; the purchase is declined. Only a pending challenge can be decided, once, before its expiresAt.

post/v2/three-ds-challenges/{challengeId}/decline

Request

  • Base URL
    https://api.slash.com
  • URL
    https://api.slash.com/v2/three-ds-challenges/{challengeId}/decline
  • Auth
    API key in header X-API-Key

Path parameters

challengeIdstring required

3D Secure challenge id with the three_ds_challenge_ prefix.

Response

The declined 3D Secure challenge.

idstring required

3D Secure challenge id with the three_ds_challenge_ prefix.

cardIdstring required

The card the purchase was made with, with the c_ prefix.

status'pending' | 'approved' | 'declined' | 'expired' | 'failed' required

pending until it is decided. approved and declined record the decision. expired means it was not decided in time and the purchase was declined. failed means the decision could not be reported and the purchase was declined.

expiresAtstring date-time required

The deadline to approve or decline the challenge.

Example response

{
  "id": "three_ds_challenge_2rj4l7hmrrrcv",
  "cardId": "c_2rj4l7hmrrrcv",
  "merchant": {
    "description": "Acme Tickets",
    "location": {
      "country": "USA"
    }
  }
}

Changes