Order cards API

Download D1-Public-IN-v1-Physical-Issuance-Cards.oas3.json

Order cards

post

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

/issuers/{issuerId}/physicalCards/batch

This API is used by the issuer backend to order a batch of physical cards.

Authorizations

bearerAuth

AuthorizationstringRequired

Requires OAuth2 access token obtained via the D1 OAuth2 API.

Path parameters

issuerIdstring · min: 10 · max: 10Required

The id of the issuer

Header parameters

x-correlation-idstringOptional

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}$

Body

application/json

List of cards to be produced in a single request

Responses

202

Successful card orders

application/json

400

Bad request due to invalid URI, headers, parameters, or payload.

application/json

401

Unauthorized request due to missing or invalid access token.

List of errorCode / error:

• AUTHORIZER_UNAUTHORIZED - Unauthorized message

application/json

403

Request forbidden by authorization rules or business constraints.

List of errorCode / error:

• AUTHORIZER_FORBIDDEN - not authorized error message
• OPERATION_NOT_ALLOWED - Name of the operation/field that is not allowed in this operation

application/json

404

Requested resource not found.

application/json

500

Internal server error while processing the request.

List of errorCode / error:

• INTERNAL_ERROR - Error details (if any)

application/json

503

The service is temporarily unavailable. You may retry your request later.

application/json

post

/issuers/{issuerId}/physicalCards/batch

HTTPcURLJavaScriptPython

POST /banking/v1/issuers/{issuerId}/physicalCards/batch HTTP/1.1
Host: api.d1.thalescloud.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1213

{
  "cards": [
    {
      "cardId": "text",
      "distributionChannel": "THALES",
      "consumerId": "text",
      "cardProductId": "text",
      "issuerRequestId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "services": {
        "issuance": "RENEWAL",
        "priority": "P1",
        "delivery": "DHL",
        "packaging": "welcome_pack_red",
        "cardCarrier": "NO_CARRIER",
        "pinMailer": false,
        "alphaCard": false
      },
      "encryptedData": "text",
      "cardDesign": {
        "images": [
          "image_1",
          "image_2"
        ],
        "customLines": [
          "Custom text 1",
          "Custom text 2"
        ],
        "cardImage": "3krr0g1r5",
        "artworkId": "text",
        "memberId": "123456789"
      },
      "paymentApplication": {
        "config": "default",
        "odaKeyIndex": "01",
        "derivationKeyIndex": "01",
        "pvKeyIndex": "01",
        "cvKeyIndex": "01"
      },
      "cardCarrierConfig": {
        "language": "EN",
        "images": [
          "image_1",
          "image_2"
        ],
        "customLines": [
          "Custom text 1",
          "Custom text 2"
        ],
        "multiCardId": "cmp7m3zdf12qj",
        "multiCardOrder": "1"
      },
      "packagingConfig": {
        "inserts": [
          "promo_card",
          "manual_v2"
        ]
      },
      "shipment": {
        "type": "INDIVIDUAL",
        "deliveryAddress": {
          "title": "Mr.",
          "firstName": "John",
          "lastName": "Smith",
          "companyName": "Thales",
          "line1": "Street #1",
          "line2": "Street #2",
          "line3": "Street #3",
          "city": "London",
          "state": "text",
          "zipCode": "WC2N 5DU",
          "countryCode": "GB",
          "mobilePhoneNumber": {
            "countryCode": "+420",
            "phoneNumber": "777222333"
          },
          "email": "[e-mail]"
        }
      }
    }
  ]
}

{
  "operationId": "text"
}

encryptedData