Hosted Pages status messages

Error and status reporting from the HP are consistent with the codes listed in Payment initiation status (payments v1). However, in the case of the Token.io HP, transfer/transaction status includes both the error code and the bank-transmitted message text ("NSF," canceled by user," "Account Closed," etc.).

Invalid bank ID error messages

When the HP 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 default Bank ID passed does not support the specified payment rail.
`Merchant DEF has restricted the permission to access XYZ Bank.`	The default Bank ID passed is not configured by the merchant.
`Merchant DEF is not set up to connect to XYZ Bank.`	The default Bank ID passed is not configured for the merchant from the platform.
`Bank ID: XYZ is invalid.`	The default Bank ID passed is not supported

The response payload takes the following form:

{
    "error": "access_denied",
    "message": "Selected payment scheme: ABC is not supported by XYZ Bank.",
    "requestId": "rq:44mQvLm38qyagkb7Wwi7p6T8UA9V:5zKtXEAq"
}

Error response fields defined:

error is the server error.
message explains the reason for the error.
requestId is generated and returned with the token payload in response to your token request submission.

If you have any feedback about the developer documentation, please contact devdocs@token.io