Inbound (from issuer)

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.

Header parameters

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

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 · min: 10 · max: 10Required

Unique identifier used to identify the issuer

Body

application/json

issuerCardRefIdstring · max: 48Required

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 · min: 1 · max: 48Optional

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 · max: 8192Optional

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 · min: 1 · max: 32Optional

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

Responses

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

No content

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.

Header parameters

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

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 · min: 10 · max: 10Required

Unique identifier used to identify the issuer

Body

application/json

issuerCardRefIdstring · max: 48Required

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.

Responses

200

getCardInfo response payload

application/json

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

Header parameters

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

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 · min: 10 · max: 10Required

Unique identifier used to identify the issuer

Responses

204

Successful

No content

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: */*

No content