Mensagens de Erro

No caso de erro, a API retorna uma mensagem de erro. Assim é possível identificar o erro ocorrido e realizar o tratamento através do código e/ou mensagem retornada.

Abaixo segue os detalhes de cada nó do JSON de resposta:

{
    "message_response": {
        "message": "error"
    },
    "error_response": {
        "general_errors": [
            {
                "code": "003039",
                "message": "Vendedor inválido ou não encontrado"
            }
        ]
    }
}

As mensagens de erros retornados pela API estão listadas na tabela abaixo:

CódigoMensagemSolução
001001Token inválido ou não encontradoVerificar o token_account
003003Forma de Pagamento InválidoVerificar o parâmetro transaction[payment_method_id]
003004Número da Parcela InválidoVerificar o parâmetro transaction[split]
003011Numero do cartão inválidoVerificar o parâmetro transaction[card_number]
003012Nome do cartão em brancoVerificar o parâmetro** transaction[card_name]**
003014Código de segurança inválidoVerificar o parâmetro** transaction[card_cvv]**
003015Mês de vencimento do cartão inválidoVerificar o parâmetro transaction[card_expdate_month]
003020Ano de vencimento do cartão inválidoVerificar o parâmetro transaction[card_expdate_year]
003021O vendedor não pode ser igual ao compradorVerificar os parâmetros token_account, costumer[email] e costumer[cpf]. Os dados não podem ser iguais
003039Vendedor inválido ou não encontradoVerificar o token_account
003065Valor menor que mínimo permitidoVerificar os transaction[split] e (transaction_product[price_unit] x transaction_product[quantity]). Somando os valores transaction[shipping_price] + (transaction_product[price_unit] x transaction_product[quantity]) o valor mínimo da parcela deve ser R$ 10,00
009006Número da parcela maior que o permitidoVerificar os parâmetros** transaction[payment_method_id]** e transaction[split] se a quantidade de parcelas é aceita pelo Meio de Pagamento.
058001Revendedor inválido.Verifique o parâmetro reseller_token. Deve estar devidamente configurado na Vindi Pagamentos como Revendedor
037010E-mail do afiliado informado deve ser diferente do vendedorO email enviado como cliente não pode ser o mesmo que o e-mail do vendedor (token_account)
3Comissão Valor da comissão é maior que o valor do pedidoO valor da comissão está sendo enviado maior que o valor da comissão do afiliado.
037022Afiliado não possui conta. Email: email_informadoO e-mail enviado no parâmetro affiliates[account_email] não tem cadastro na Vindi Pagamentos. TODAS as contas de afiliados devem ter conta cadastrada.

Os erros de validações de parâmetros serão retornados STATUS CODE 422 - Unprocessable Entity.

Exemplo:

{
    "message_response": {
        "message": "error"
    },
    "error_response": {
        "validation_errors": [
            {
                "code": "3",
                "message": "não é válido",
                "field": "price_discount",
                "message_complete": "Valor Desconto não é válido"
            }
        ]
    },
    "additional_data": {
        "transaction_id": null,
        "order_number": null,
        "status_id": null,
        "status_name": null,
        "token_transaction": null
    }
}