Register and View

Get card details

get

/issuers/{issuerId}/cards/{cardId}

This request is used by the issuer backend to request card details.

認可

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}

ヘッダーパラメータ

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 get card details

application/json

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

Unique identifier of the end user.

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

accountIdsstring[]オプション非推奨

List of accountIds associated to the card. accountId pattern : [A-Za-z0-9_-]{1,64}
Note: accountIds is deprecated. This optional response parameter will no more be returned.

cardIdstring · 最小: 1 · 最大: 48オプション

Unique identifier of the card.

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

cardProductIdstring · 最小: 1 · 最大: 48オプション

Unique identifier of the type of card (defined during the onboarding of D1)

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

threeDSsupportbooleanオプション

Determines if the card supports EMV 3-D Secure (3DS) flows.

schemestring · enumオプション

The card scheme

Example: VISA可能な値:

panSuffixstringオプション

Last 4 digits of the PAN

Example: 1234Pattern: \d{4}

expstringオプション

Expiry date of the card in MMYY format

Example: 1022Pattern: (0[1-9]|1[0-2])\d{2}

statestring · enumオプション

The state of the card.

Example: ACTIVE可能な値:

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

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

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

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

The time the resource has been last updated. Format ISO 8601 YYYY-MM-DDThh:mm:ssTZD

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

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

403

Forbidden action, check the state of the linked end user (consumer) or account or digital card

application/json

404

Resource not found

application/json

500

Internal Server Error

application/json

get

/issuers/{issuerId}/cards/{cardId}

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

Register card

put

/issuers/{issuerId}/cards/{cardId}

This request is used by the issuer backend to request the registration of a card that has been already created by the issuer without involving D1. This allows D1 to make this card eligible for card tokenization through the D1 SDK. D1 manages to retrieve useful card information from the Issuing Processor CMS based on the cardId provided.

認可

Authorizationstring必須

パスパラメータ

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

The id of the issuer

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

Unique identifier of the card.

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

ヘッダーパラメータ

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}

本文

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

Unique identifier of the end user.

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

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

Unique identifier of the type of card (defined during the onboarding of D1)

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

accountIdstring · 最小: 1 · 最大: 64オプション非推奨

Unique identifier of the account.
Note: accountId is deprecated. You can still pass it but it will be ignored.

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

statestring · enum必須

The state of the card.

Example: ACTIVE可能な値:

レスポンス

204

Successful card registration

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

403

Forbidden action. At least one of the registration could not be done.

Check the state of the linked end user (consumer).

Check that the cardId does not belong to an existing end user (consumer).

Check that the pair "PAN and EXP" was not already registered with another cardId.

Check that the cardId was not already registered with different data.

application/json

404

Resource not found Unknown issuerId or consumerId or accountId.

application/json

500

Internal Server Error

application/json

put

/issuers/{issuerId}/cards/{cardId}

PUT /banking/v1/issuers/{issuerId}/cards/{cardId} HTTP/1.1
Host: api.d1.thalescloud.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "consumerId": "text",
  "cardProductId": "text",
  "state": "ACTIVE"
}

コンテンツなし

前へインバウンド次へOperations

最終更新 12 日前

役に立ちましたか？