3 D Secure Operations

Different operations linked to 3-D secure.

Get all 3-D Secure operations

get

https://api.d1.thalescloud.io/banking/v1https://api.d1-stg.thalescloud.io/banking/v1

/issuers/{issuerId}/cards/{cardId}/3ds/operations

This request is used by the issuer backend to retrieve all operations related to a card. The API specifies the starting point (offset) and the number of operations (limit) to be retrieved. Offset 0 (the default) corresponds to the most recent operation. For example a limit of 5 and an offset of 2 would return the five most recent operations before the most recent two”.

If no operations are available for the given cardId, an empty list is returned.

Operations that are older than one year are removed.

認可

bearerAuth

Authorizationstring必須

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.

パスパラメータ

issuerIdstring · 最小: 10 · 最大: 10必須

The id of the issuer

cardIdstring · 最小: 1 · 最大: 48必須

Unique identifier of the card.

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

クエリパラメータ

offsetintegerオプション

Index from which the query starts returning operations – Offset 0 (the default) corresponds to the most recent operation.

limitinteger · 最小: 1 · 最大: 50オプション

Number of operations to be returned

Default: 10

ヘッダーパラメータ

x-correlation-idstring · 最小: 1 · 最大: 64オプション

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.

Warning: This identifier should not be derived from sensitive personal data, as its value will be logged in clear.

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

Pattern: [a-zA-Z0-9_\-\. ]{1,64}

レスポンス

200

Successful

application/json

remainingOperationsintegerオプション

400

Bad Request, Invalid request URI or header, or unsupported non-standard parameter

application/json

401

The provided Authorization header is missing or invalid

application/json

404

Resource not found

application/json

500

Internal Server Error

application/json

get

/issuers/{issuerId}/cards/{cardId}/3ds/operations

HTTPcURLJavaScriptPython

GET /banking/v1/issuers/{issuerId}/cards/{cardId}/3ds/operations HTTP/1.1
Host: api.d1.thalescloud.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "operations": [
    {
      "operationId": "text",
      "operation": "3DS_FRICTIONLESS",
      "status": "SUCCESSFUL",
      "startTime": "2022-06-16T06:28:02.492Z",
      "consumerId": "text",
      "details": {
        "acsTransactionId": "text",
        "threeDSServerTransId": "text",
        "dsTransId": "text",
        "purchase": {
          "merchantName": "text",
          "merchantType": "text",
          "amount": "text",
          "currencyCode": "text",
          "merchantId": "text",
          "countryCode": "text",
          "merchantUrl": "https://example.com"
        },
        "acquirer": {
          "bin": "text",
          "countryCode": "text"
        },
        "device": {
          "deviceChannel": "01",
          "appInstanceId": "text",
          "authnType": "BIOMETRIC"
        },
        "eci": "text",
        "authenticationMethod": "02",
        "transStatus": "Y",
        "transStatusReason": "text",
        "rba": {
          "evaluatedRule": [],
          "selectedRule": [],
          "appliedExemption": []
        },
        "protocolVersion": "text"
      },
      "error": "text"
    }
  ],
  "remainingOperations": 1
}

Get 3-D Secure operation

get

https://api.d1.thalescloud.io/banking/v1https://api.d1-stg.thalescloud.io/banking/v1

/issuers/{issuerId}/cards/{cardId}/3ds/operations/{operationId}

This request is used by the issuer backend to retrieve the information related to a 3-D Secure operation on a card.

Getting an operation older than one year will return an error.

認可

bearerAuth

Authorizationstring必須

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.

パスパラメータ

issuerIdstring · 最小: 10 · 最大: 10必須

The id of the issuer

cardIdstring · 最小: 1 · 最大: 48必須

Unique identifier of the card.

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

operationIdstring · 最小: 1 · 最大: 64必須

Unique identifier of the operation

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

ヘッダーパラメータ

x-correlation-idstring · 最小: 1 · 最大: 64オプション

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.

Warning: This identifier should not be derived from sensitive personal data, as its value will be logged in clear.

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

Pattern: [a-zA-Z0-9_\-\. ]{1,64}

レスポンス

200

Successful

application/json

Details about a 3-D Secure operation.

operationIdstring · 最小: 1 · 最大: 64必須

Unique identifier of the operation

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

operationstring · enum必須

The operation type.

可能な値:

statusstring · enum必須

Status of the operation

可能な値:

startTimestring · 最小: 1 · 最大: 64必須

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

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

consumerIdstring · 最小: 1 · 最大: 64オプション

Unique identifier of the end user.

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

detailsone ofオプション

errorstringオプション

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

400

Bad Request, Invalid request URI or header, or unsupported non-standard parameter

application/json

401

The provided Authorization header is missing or invalid

application/json

404

Resource not found

application/json

500

Internal Server Error

application/json

get

/issuers/{issuerId}/cards/{cardId}/3ds/operations/{operationId}

HTTPcURLJavaScriptPython

GET /banking/v1/issuers/{issuerId}/cards/{cardId}/3ds/operations/{operationId} HTTP/1.1
Host: api.d1.thalescloud.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "operationId": "text",
  "operation": "3DS_FRICTIONLESS",
  "status": "SUCCESSFUL",
  "startTime": "2022-06-16T06:28:02.492Z",
  "consumerId": "text",
  "details": {
    "acsTransactionId": "text",
    "threeDSServerTransId": "text",
    "dsTransId": "text",
    "purchase": {
      "merchantName": "text",
      "merchantType": "text",
      "amount": "text",
      "currencyCode": "text",
      "merchantId": "text",
      "countryCode": "text",
      "merchantUrl": "https://example.com"
    },
    "acquirer": {
      "bin": "text",
      "countryCode": "text"
    },
    "device": {
      "deviceChannel": "01",
      "appInstanceId": "text",
      "authnType": "BIOMETRIC"
    },
    "eci": "text",
    "authenticationMethod": "02",
    "transStatus": "Y",
    "transStatusReason": "text",
    "rba": {
      "evaluatedRule": [],
      "selectedRule": [],
      "appliedExemption": []
    },
    "protocolVersion": "text"
  },
  "error": "text"
}