Register

Register APIs.

Register consumer

put

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

/issuers/{issuerId}/consumers/{consumerId}

This request is used by the issuer backend to request the registration of the end user (consumer). As an input only the consumerId and the state are needed.

Authorizations

bearerAuth

AuthorizationstringRequired

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.

Path parameters

issuerIdstring · min: 10 · max: 10Required

The id of the issuer

consumerIdstring · min: 1 · max: 64Required

Unique identifier of the end user.

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

Header parameters

x-correlation-idstring · min: 1 · max: 64Optional

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}

Body

application/json

The following object represent the consumer

statestring · enumOptionalDeprecated

The state of the end user (consumer)
Note: Consumer state is deprecated, Thales will no more check the consumer's state. You can still pass it but it will be ignored.

Possible values:

Responses

204

Successful end user registration

No content

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, Unknown issuerId.

application/json

500

Internal Server Error

application/json

put

/issuers/{issuerId}/consumers/{consumerId}

HTTPcURLJavaScriptPython

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

{}

No content

Register consumer with cards

put

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

/issuers/{issuerId}/consumers/{consumerId}/cards

This request is used by the issuer backend to register an end user (consumer) with his associated set of cards. The cards must be already created on the Issuer CMS side. This allows D1 to make this end user (consumer) and his or her cards eligible to other D1 services like tokenisation, secure card display, push porvisioning... If not provided in this API (in the encryptedData parameter), D1 manages to retrieve useful card information from the issuer backend based on the cardId provided by calling get card credentials API.

Authorizations

bearerAuth

AuthorizationstringRequired

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.

Path parameters

issuerIdstring · min: 10 · max: 10Required

The id of the issuer

consumerIdstring · min: 1 · max: 64Required

Unique identifier of the end user.

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

Header parameters

x-correlation-idstring · min: 1 · max: 64Optional

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}

Body

application/json

Responses

204

Successful end user (consumer) & cards registration

No content

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

500

Internal Server Error

application/json

put

/issuers/{issuerId}/consumers/{consumerId}/cards

HTTPcURLJavaScriptPython

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

{
  "cards": [
    {
      "cardId": "text",
      "cardProductId": "text",
      "state": "INACTIVE",
      "encryptedData": "encryptedData with card pan and card exp"
    }
  ],
  "consumerInfo": {
    "firstName": "Alexandre",
    "middleName": "Andrew",
    "lastName": "Doe",
    "language": "en-US",
    "mobilePhoneNumber": {
      "countryCode": "+33",
      "phoneNumber": "624302941"
    },
    "email": "[e-mail]",
    "residencyAddress": {
      "line1": "1230 Rue de Rivoli",
      "line2": "text",
      "line3": "text",
      "city": "Paris",
      "state": "75",
      "zipCode": "75000",
      "countryCode": "FR"
    }
  }
}

No content