Error and status reporting from the Hosted Pages are consistent with the codes listed in Payment initiation status (payments v1) and Payment status (payments v2). However, in the case of the Token.io Hosted Pages, payment status includes both the status code and the bank-transmitted message text, e.g., 'NSF', 'canceled by user', 'Account Closed', etc.
When Hosted Pages are invoked and a bank ID is not supported, the following error messages are sent to the TPP:
| Message | Explanation |
|---|---|
Selected payment scheme: ABC is not supported by XYZ Bank. | The selected bank does not support the payment rail specified in the payment request. |
Merchant DEF has restricted the permission to access XYZ Bank. | Access to the pre-selected bank has been restricted by the TPP. |
Merchant DEF is not set up to connect to XYZ Bank. | The pre-seclected bank has not been configured by the TPP. |
Bank ID: XYZ is invalid. | The selected bank may be down. |
{
"error": "access_denied",
"message": "Selected payment scheme: ABC is not supported by XYZ Bank.",
"requestId": "rq:44mQvLm38qyagkb7Wwi7p6T8UA9V:5zKtXEAq"
}For the error response fields defined:
erroris the server error.messageexplains the reason for the error.requestIdis generated and returned with the token payload in response to your token payment initiation.
If you have any feedback about the developer documentation, please contact devdocs@token.io