Durante o envio de requisições via deep link, o uso de parâmetros incorretos ou incompletos pode resultar em falhas. Quando isso ocorre, o sistema retorna mensagens de erro como resposta, com o objetivo de ajudar na identificação e correção do problema. Aqui, reunimos os principais códigos de erro que podem surgir durante o uso de deep links e suas causas.

Pagamento

Os erros retornados referentes a pagamentos aparecem no formato Base64, como no exemplo abaixo:

order://response?response=eyJjb2RlIjoxLCJyZWFzb24iOiJDQU5DRUxBRE8gUEVMTyBVU1XDgVJJTyJ9&responsecode=0

Após a decodificação da string Base64, o conteúdo é convertido em um objeto JSON estruturado, que facilita a interpretação do erro:

{ 
   "code":1, 
   "reason":"CANCELADO PELO USUÁRIO" 
}

Próximo ao código numérico de erro code, a chave reason explica de forma mais específica o que causou o erro.

Entre os principais códigos de erro identificados na integração via deep link, destacam-se os seguintes:

Impressão

Se houver algum erro na impressão, o campo response retornará um Base64 com o motivo do erro. Após a decodificação da string Base64, o conteúdo é convertido em um objeto JSON estruturado, que facilita a interpretação do erro.

Confira os exemplos de retorno de erro e de sucesso.