カード注文 API

ダウンロード 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.

認可

bearerAuth

Authorizationstring必須

Requires OAuth2 access token obtained via the D1 OAuth2 API.

パスパラメータ

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

The id of the issuer

ヘッダーパラメータ

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

List of cards to be produced in a single request

レスポンス

202

Successful card orders

application/json

Operation information.

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

Unique identifier of the operation

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

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": "[email protected]"
        }
      }
    }
  ]
}

{
  "operationId": "text"
}

暗号化データ