コンシューマーAPI

Get Consumer Information

get

This request is used by the D1 backend to request the details of an end user (consumer) from the issuer backend.

If the end user information is associated with the card, it is possible to activate "cardId" query parameter via an onboarding flag.

認可

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

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

Unique identifier of the consumer.

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

クエリパラメータ

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

Unique identifier of the card.

Example: cardId=crd_h2otddwm5uwujlye3qyxmjkphaPattern: ^[A-Za-z0-9_-]{1,48}$

ヘッダーパラメータ

x-correlation-idstringオプション

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 other purpose than logging and troubleshooting.

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

レスポンス

200

All needed information related to the requested end user (consumer).

application/json

403

Forbidden (Invalid state)

404

End user (consumer) was not found

application/json

500

Internal server error

application/json

get

/banking/d1/v1/issuers/{issuerId}/consumers/{consumerId}?cardId=<cardId>

HTTPcURLJavaScriptPython

GET /banking/d1/v1/issuers/{issuerId}/consumers/{consumerId}?cardId=<cardId> HTTP/1.1
Host: YOUR_DOMAIN_NAME
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "language": "en-US",
  "firstName": "John",
  "middleName": "John",
  "lastName": "Smith",
  "dateOfBirth": "1990-01-25",
  "title": "Mr.",
  "email": "[e-mail]",
  "mobilePhoneNumber": {
    "countryCode": "+420",
    "phoneNumber": "777222333"
  },
  "residencyAddress": {
    "line1": "Street#1",
    "line2": "Street #2",
    "city": "Prague",
    "state": "CZ",
    "zipCode": "140 00",
    "countryCode": "CZ"
  }
}

Deliver OTP

post

This request is used by D1 during the tokenization flow for a card in case it is required to send an OTP to the end user (consumer) "consumerId".

The parameter 'threeDSDetails' is available in the scenario :

• 3DS Authentication

Note

This is applicable only if the issuer decides to rely on its own messaging system to send messages to their customers and not on the D1 platform.

認可

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

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

Unique identifier of the consumer.

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

ヘッダーパラメータ

x-correlation-idstringオプション

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 other purpose than logging and troubleshooting.

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

本文

application/json

deliveryChannelstring · enum必須

The channel on which the end user has decided to receive the OTP.

可能な値:

panSuffixstring · 最小: 4 · 最大: 4必須

Last 4 digits of the PAN of the card to be tokenized (digitized)

レスポンス

204

No Content

400

Bad request

application/json

401

Authorization missing or invalid

application/json

403

Action forbidden

application/json

404

Resource not found

application/json

500

Internal Server Error

application/json

post

/banking/d1/v1/issuers/{issuerId}/consumers/{consumerId}/otp

HTTPcURLJavaScriptPython

POST /banking/d1/v1/issuers/{issuerId}/consumers/{consumerId}/otp HTTP/1.1
Host: YOUR_DOMAIN_NAME
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 457

{
  "otp": {
    "value": "text",
    "expirationDate": "text",
    "reason": "CARD-DIGITIZATION"
  },
  "deliveryChannel": "SMS",
  "digitalCardRequestor": {
    "id": "text",
    "walletId": "text",
    "name": "text",
    "tspId": "text",
    "originalDigitalCardRequestorId": "text"
  },
  "deviceInformation": {
    "digitalCardStorageType": "text",
    "phoneNumber": "text",
    "deviceName": "text"
  },
  "panSuffix": "text",
  "threeDSDetails": {
    "acsTransactionId": "text",
    "purchase": {
      "merchantName": "text",
      "amount": "text",
      "currencyCode": "text"
    }
  }
}

コンテンツなし