API de 3DS

Notify 3-D Secure Card Operation

post

This request is used by D1 to notify the issuer backend about all 3-D Secure operations done on a card.

Autorizaciones

bearerAuth

AuthorizationstringRequerido

A JWT generated by the Get Authorization Token API.
The server checks the validity of the provided token to control access to this protected resource. Please refer to Get OAuth 2.0 access token for more details on the flow and on how to get this JWT.

Parámetros de ruta

issuerIdstring · mín: 10 · máx: 10Requerido

The id of the issuer

cardIdstring · mín: 1 · máx: 48Requerido

Unique identifier of the card.

Pattern: ^[A-Za-z0-9_-]{1,48}$

Parámetros de encabezado

x-correlation-idstringOpcional

Random identifier which can be used to correlate the different API calls done as part of a single use-case. This identifier will be the one primarily used for troubleshooting.

There is no strong guarantee of the uniqueness of this identifier, so please refrain from using it for other purpose than logging and troubleshooting.

Cuerpo

application/json

Details about a 3-D Secure operation.

operationIdstring · mín: 1 · máx: 64Requerido

Unique identifier of the operation

Pattern: ^[A-Za-z0-9_-]{1,64}$

operationstring · enumRequerido

The operation type.

Valores posibles:

statusstring · enumRequerido

Status of the operation

Valores posibles:

startTimestring · mín: 1 · máx: 64Requerido

The time the request has been processed. Format ISO 8601 YYYY-MM-DDThh:mm:ssTZD

Example: 2022-06-16T06:28:02.492Z

consumerIdstring · mín: 1 · máx: 64Opcional

Unique identifier of the consumer.

Pattern: ^[A-Za-z0-9_-]{1,64}$

detailsone ofOpcional

errorstringOpcional

Human readable string representing the error, only present in case of operation failure

Respuestas

204

Successful

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter

application/json

401

The provided Authorization header is missing or invalid

404

Resource not found. Unknown issuerId or consumerId or accountId or cardId

application/json

500

Internal server error

application/json

post

/notifications/d1/v1/issuers/{issuerId}/cards/{cardId}/3ds/notifications

HTTPcURLJavaScriptPython

POST /notifications/d1/v1/issuers/{issuerId}/cards/{cardId}/3ds/notifications HTTP/1.1
Host: YOUR_DOMAIN_NAME
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 492

{
  "operationId": "text",
  "operation": "3DS_FRICTIONLESS",
  "status": "SUCCESSFUL",
  "startTime": "2022-06-16T06:28:02.492Z",
  "consumerId": "text",
  "details": {
    "acsTransactionId": "text",
    "purchase": {
      "merchantName": "text",
      "amount": "text",
      "currencyCode": "text"
    },
    "device": {
      "deviceChannel": "01",
      "appInstanceId": "text",
      "authnType": "BIOMETRIC"
    },
    "eci": "text",
    "authenticationMethod": "02",
    "transStatus": "Y",
    "transStatusReason": "text",
    "rba": {
      "evaluatedRule": [],
      "selectedRule": [],
      "appliedExemption": []
    }
  },
  "error": "text"
}

Sin contenido