デジタルカードAPI
A JWT using the Bearer schema.\nThe server checks the validity of the provided token to control access to this protected resource.
The id of the issuer
The id of the digital card
^[A-Za-z0-9_-]{1,64}$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.
There is no strong guarantee of the uniqueness of this identifier, so please refrain from using it for other purpose than logging and troubleshooting.
The following object represent the account
The reason why the action is performed.
^[a-zA-Z0-9 ]{1,64}$The reason code why the action is performed.
If not provided , default reason code is ISSUER_DECISION
Successful card suspension request
Operation information.
Unique identifier of the operation
^[A-Za-z0-9_-]{1,64}$Status of the operation
Malformed request
The provided Authorization header is missing or invalid
Forbidden action, check the state of the linked consumer or account or digital card
Resource not found, Unknown issuerId or consumerId or accountId or digital card id
Internal Server Error
A JWT using the Bearer schema.\nThe server checks the validity of the provided token to control access to this protected resource.
The id of the issuer
The id of the digital card
^[A-Za-z0-9_-]{1,64}$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.
There is no strong guarantee of the uniqueness of this identifier, so please refrain from using it for other purpose than logging and troubleshooting.
The following object represent the request body of the resume operation
The reason why the action is performed.
^[a-zA-Z0-9 ]{1,64}$The reason code why the action is performed.
If not provided , default reason code is ISSUER_DECISION
Successful card resumption
Operation information.
Unique identifier of the operation
^[A-Za-z0-9_-]{1,64}$Status of the operation
Malformed request
The provided Authorization header is missing or invalid
Forbidden action, check the state of the linked consumer or account or digital card
Resource not found, Unknown issuerId or consumerId or accountId or digital card id
Internal Server Error
A JWT using the Bearer schema.\nThe server checks the validity of the provided token to control access to this protected resource.
The id of the issuer
The id of the digital card
^[A-Za-z0-9_-]{1,64}$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.
There is no strong guarantee of the uniqueness of this identifier, so please refrain from using it for other purpose than logging and troubleshooting.
The following object represent the account
The reason why the action is performed.
^[a-zA-Z0-9 ]{1,64}$The reason code why the action is performed.
If not provided , default reason code is ISSUER_DECISION
Successful card deletion request
Operation information.
Unique identifier of the operation
^[A-Za-z0-9_-]{1,64}$Status of the operation
Malformed request
The provided Authorization header is missing or invalid
Forbidden action, check the state of the linked consumer or account or digital card
Resource not found, Unknown issuerId or consumerId or accountId or digital card id
Internal Server Error
A JWT using the Bearer schema.\nThe server checks the validity of the provided token to control access to this protected resource.
The id of the issuer
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.
There is no strong guarantee of the uniqueness of this identifier, so please refrain from using it for other purpose than logging and troubleshooting.
Ciphered digital PAN, this DPAN is encrypted using the JWE encryption (please refer to the Encrypt sensitive data for more details)
Content
Once deciphered, the plaintext contains:
| JSON field parameter name | type | description | MOC | Length |
|---|---|---|---|---|
| pan | String | The digital pan value. | M | Up to 19 |
^(?:[A-Za-z0-9+\/]{4})*(?:[A-Za-z0-9+\/]{2}==|[A-Za-z0-9+\/]{3}=)?$The search type
Search Result
Malformed request
The provided Authorization header is missing or invalid
Forbidden action, check the state of the linked consumer or account or digital card
Resource not found, Unknown issuerId or consumerId or accountId or digital card id
Internal Server Error
A JWT using the Bearer schema.\nThe server checks the validity of the provided token to control access to this protected resource.
The id of the issuer
The id of the digital card
^[A-Za-z0-9_-]{1,64}$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.
^[A-Za-z0-9_-]{1,64}$OK
Provides information about the token. Note that this data is available only if the tokenization is successful or pending.
Unique identifier of the card.
^[A-Za-z0-9_-]{1,48}$Unique identifier of the token specified by the TSP
Last four digits of the token
the state of the digital card (token)
ACTIVE可能な値: The type of the token. Following values are supported:
- SE
- HCE
- COF
- ECOM
- QRC
List of all devices bound to this token. A device is represented by its binding reference.
The provisioning time of the token. Format ISO 8601 YYYY-MM-DDThh:mm:ssTZD
The last time the token keys have been replenished. Format ISO 8601 YYYY-MM-DDThh:mm:ssTZD
The last time the token status has been changed. Format ISO 8601 YYYY-MM-DDThh:mm:ssTZD
Malformed request
The provided Authorization header is missing or invalid
Forbidden action, check the state of the linked consumer or account or digital card
Resource not found, Unknown issuerId or consumerId or accountId or digital card id
Internal Server Error
A JWT using the Bearer schema.\nThe server checks the validity of the provided token to control access to this protected resource.
The id of the issuer
The id of the digital card
^[A-Za-z0-9_-]{1,64}$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.
There is no strong guarantee of the uniqueness of this identifier, so please refrain from using it for other purpose than logging and troubleshooting.
OK
The field is the json (cf http://www.json.org/ ) representation of the DIGITAL card. JWE encryption is used to secure the field (please refer to the Encrypt sensitive data for more details) Details:
{
"pan":"...",
"exp":"..."
}
The PAN is Mandatory, up to 19 digits.
The expiry date in the format MMYY. It is not provided for UPI scheme.
Malformed request
The provided Authorization header is missing or invalid
Forbidden action, check the state of the linked consumer or account or digital card
Resource not found, Unknown issuerId or consumerId or accountId or digital card id
Internal Server Error
A JWT using the Bearer schema.\nThe server checks the validity of the provided token to control access to this protected resource.
The id of the issuer
Unique identifier of the operation
^[A-Za-z0-9_-]{1,64}$The id of the digital card
^[A-Za-z0-9_-]{1,64}$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.
^[A-Za-z0-9_-]{1,64}$OK
Operation details related to a specific operationId
Unique identifier of the operation
^[A-Za-z0-9_-]{1,64}$The operation type.
Status of the operation
The time the request has been processed. Format ISO 8601 YYYY-MM-DDThh:mm:ssTZD
The time the request has been processed. Format ISO 8601 YYYY-MM-DDThh:mm:ssTZD
Identifier of the principal who initiates the operation - consumerId if USER - issuerId if ISSUER - cci user id if CCI
Human readable string representing the error, only present in case of operation failure
Malformed request
The provided Authorization header is missing or invalid
Resource not found, Unknown issuerId or consumerId or accountId or digital card id
Internal Server Error
A JWT using the Bearer schema.\nThe server checks the validity of the provided token to control access to this protected resource.
The id of the issuer
The id of the digital card
^[A-Za-z0-9_-]{1,64}$Index from which the query starts returning operations (default value: 0)
Upper limit of the query
10Random 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.
^[A-Za-z0-9_-]{1,64}$OK
Malformed request
The provided Authorization header is missing or invalid
Resource not found, Unknown issuerId or consumerId or accountId or digital card id
Internal Server Error
StepUp Auth Result
A JWT using the Bearer schema.\nThe server checks the validity of the provided token to control access to this protected resource.
The id of the issuer
The id of the digital card
^[A-Za-z0-9_-]{1,64}$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.
There is no strong guarantee of the uniqueness of this identifier, so please refrain from using it for other purpose than logging and troubleshooting.
Step-Up Authentication Result request
this will be the "lifeCycleTraceId" for Visa or the "authenticationCorrelationId" for Mastercard
Successful Step-up authentication
Operation result information.
Unique identifier of the operation
^[A-Za-z0-9_-]{1,64}$Status of the operation
Malformed request
The provided Authorization header is missing or invalid
Forbidden action, check the state of the linked consumer or account or digital card
Resource not found, Unknown issuerId or consumerId or accountId or digital card id
Internal Server Error
最終更新
役に立ちましたか？