Entrante (desde el emisor)
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.
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
Unique identifier used to identify the issuer
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.
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.
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" }
Identifier of the key used to encrypt fpanDetails.Provided by Thales to Issuer during onboarding.
updateCard response payload
Bad Request, Invalid request URI or header, or unsupported nonstandard parameter
Error Information Response
Error Response code to the request
| Error code | Description |
|---|---|
| 111 | Missing mandatory parameter |
| 112 | Bad parameter format |
| 113 | Unknown issuer |
| 115 | Unknown product |
| 116 | Unknown card |
| 119 | Unknown Token |
| 163 | Product not supported for mobile payment |
| 164 | FPAN Provisioning Count Exceeded |
| 166 | Invalid FPAN |
| 167 | Card already enrolled |
| 321 | Operation on token already on-going |
| 322 | Time to live of the operation expired |
| 431 | Invalid perso data |
| 432 | Current token state does not allow this operation |
| 911 | Operation failed |
| 921 | Unexpected server error |
Textual error message
Internal Server Error
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"
}{
"responseCode": 1,
"errorMessage": "text"
}This method can be used to retrieve the list of virtual card(s) that belongs to a funding card.
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
Unique identifier used to identify the issuer
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.
getCardInfo response payload
Bad Request, Invalid request URI or header, or unsupported nonstandard parameter
Error Information Response
Error Response code to the request
| Error code | Description |
|---|---|
| 111 | Missing mandatory parameter |
| 112 | Bad parameter format |
| 113 | Unknown issuer |
| 115 | Unknown product |
| 116 | Unknown card |
| 119 | Unknown Token |
| 163 | Product not supported for mobile payment |
| 164 | FPAN Provisioning Count Exceeded |
| 166 | Invalid FPAN |
| 167 | Card already enrolled |
| 321 | Operation on token already on-going |
| 322 | Time to live of the operation expired |
| 431 | Invalid perso data |
| 432 | Current token state does not allow this operation |
| 911 | Operation failed |
| 921 | Unexpected server error |
Textual error message
Internal Server Error
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"
}{
"responseCode": 1,
"errorMessage": "text"
}This method is used by the Issuer to monitor TSH health
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
Unique identifier used to identify the issuer
Successful
Bad Request, Invalid request URI or header, or unsupported nonstandard parameter
Sin contenido
Internal Server Error
GET /gtep/igwauxapi/healthCheck HTTP/1.1
Host: api.dbp.thalescloud.io
x-correlation-id: text
x-issuer-id: text
Accept: */*
Sin contenido
Última actualización
¿Te fue útil?