インバウンド（イシュアから）

Update funding card information

post

This method is used by the issuer to update funding card information:

• new expiry date value in case of card renewal
• new PAN and expiry date in case of card replacement

The issuer receives a notifyVirtualCardChange per virtualCard (active or suspended) linked to the funding card that is updated.

ヘッダーパラメータ

x-correlation-idstring · 最小: 1 · 最大: 64必須

Unique identifier of a give session (enrolment session or Life Cycle Management session), used to link inbound and outbound requests of the same session together

x-issuer-idstring · 最小: 10 · 最大: 10必須

Unique identifier used to identify the issuer

本文

application/json

issuerCardRefIdstring · 最大: 48必須

The unique identifier of the funding card. This value is generated and managed by the issuer. This value can be updated in case of funding PAN replacement by the issuer.

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

New issuerCardRefId to be updated, provided only if the issuerCardRefId change after a PAN, exp or productId replacement. Note, the newIssuerCardRefId is not mandatory and it is preferable to keep the same issuerCardRefId after updateCard This field has been added to the API for issuers that are not able to manage the same identifier following a PAN/exp date update.

fpanDetailsstring · 最大: 8192オプション

Old and new FPAN details (for example in case of card renewal).

This value is encrypted using the PKCS#7 encryption scheme defined in RFC 2315/5652 using following encryption parameters:

• The content encryption algorithm used is AES256/CBC/PKCS7Padding using a randomly generated AES key.
• The key encryption algorithm is RSA/NONE/OAEPWithSHA256AndMGF1Padding (with MGF1 using SHA-256) using the TSH certificate provided during onboarding.
• The encryption result shall be provided as hexadecimal string.

The format of the data is: { "oldFPAN": "[0-9]{16,19}", "oldExpDate": "MMYY", "newFPAN": "[0-9]{16,19}", "newExpDate": "MMYY" }

publicKeyIdentifierstring · 最小: 1 · 最大: 32オプション

Identifier of the key used to encrypt fpanDetails.Provided by Thales to Issuer during onboarding.

レスポンス

200

updateCard response payload

コンテンツなし

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter

application/json

500

Internal Server Error

post/updateCard

HTTPcURLJavaScriptPython

POST /gtep/igwauxapi/updateCard HTTP/1.1
Host: api.dbp.thalescloud.io
x-correlation-id: text
x-issuer-id: text
Content-Type: application/json
Accept: */*
Content-Length: 104

{
  "issuerCardRefId": "text",
  "newIssuerCardRefId": "text",
  "fpanDetails": "text",
  "publicKeyIdentifier": "text"
}

コンテンツなし

Get virtual card list information

post

This method can be used to retrieve the list of virtual card(s) that belongs to a funding card.

ヘッダーパラメータ

x-correlation-idstring · 最小: 1 · 最大: 64必須

Unique identifier of a give session (enrolment session or Life Cycle Management session), used to link inbound and outbound requests of the same session together

x-issuer-idstring · 最小: 10 · 最大: 10必須

Unique identifier used to identify the issuer

本文

application/json

issuerCardRefIdstring · 最大: 48必須

The unique identifier of the funding card. This value is generated and managed by the issuer. This value can be updated in case of funding PAN replacement by the issuer.

レスポンス

200

getCardInfo response payload

application/json

issuerCardRefIdstring · 最大: 48必須

The unique identifier of the funding card. This value is generated and managed by the issuer. This value can be updated in case of funding PAN replacement by the issuer.

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter

application/json

500

Internal Server Error

post/getCardInfo

HTTPcURLJavaScriptPython

POST /gtep/igwauxapi/getCardInfo HTTP/1.1
Host: api.dbp.thalescloud.io
x-correlation-id: text
x-issuer-id: text
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "issuerCardRefId": "text"
}

{
  "issuerCardRefId": "text",
  "virtualCardList": [
    {
      "virtualCardId": "text",
      "issuerCardRefId": "text",
      "walletProviderId": "text",
      "walletCardRefId": "text",
      "walletVirtualCardId": "text",
      "deviceInformation": {
        "tokenStorageId": "text",
        "tokenStorageTyoe": "text"
      },
      "provisioningTime": "text",
      "status": "DEPLOYMENT_ONGOING"
    }
  ]
}

check if TSH is healthy

get

This method is used by the Issuer to monitor TSH health

ヘッダーパラメータ

x-correlation-idstring · 最小: 1 · 最大: 64必須

Unique identifier of a give session (enrolment session or Life Cycle Management session), used to link inbound and outbound requests of the same session together

x-issuer-idstring · 最小: 10 · 最大: 10必須

Unique identifier used to identify the issuer

レスポンス

204

Successful

コンテンツなし

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter

500

Internal Server Error

get/healthCheck

HTTPcURLJavaScriptPython

GET /gtep/igwauxapi/healthCheck HTTP/1.1
Host: api.dbp.thalescloud.io
x-correlation-id: text
x-issuer-id: text
Accept: */*

コンテンツなし