Tratar os erros aplicativos

Tratar os erros aplicativos

Mensagens de erros aplicativos normalizados podem ser enviadas na mensagem SOAP resposta vinculada a uma chamada.

Apresentam-se na forma de um código de erro junto com uma descrição do problema encontrado.

O quadro abaixo lista os códigos de erros que podem ser retornados no atributo responseCode :

Código de erro responseCodeDetail Descrição
0 Action successfully completed O formato da solicitação é válido. Não indica necessariamente que o pagamento esteja aceito.
1 Unauthorized request Ação não autorizada.
2 Bad Parameter Atributo inválido.
3 Bad Request A solicitação não pôde ser processada.
10 Transaction was not found Transação não encontrada.
11 Bad transaction status Status da transação incorreto.
12 Transaction already exists A transação já existe.
13 Date is too far from current UTC date Data incorreta (o valor do atributo 'submissionDate' está distante demais da data atual).
14 Nothing has changed Nenhuma mudança.
15 Too much results Há resultados demais.
16 Duplicate forbidden A transação inicial foi recusada por uma razão que proíbe a duplicação. Peça ao portador pagar com um outro meio de pagamento.
20 Bad amount Valor inválido no atributo 'amount'.
21 Unknown currency Moeda inválida no atributo 'currency'.
22 Unknown card type Tipo de cartão desconhecido.
23 Invalid Expiration Date Data inválida nos atributos 'expiryMonth' e/ou 'expiryYear'.
24 CVV Mandatory O 'cvv' é obrigatório.
25 Contract not found Número de contrato desconhecido.
26 Invalid card number O número de cartão é inválido.
30 Payment token not found O Token Cartão não foi encontrado.
31 Invalid payment token (cancelled, …) O Token Cartão é inválido (Rescindido, vazio...).
32 SubscriptionID was not found Atributo 'subscriptionId' não encontrado.
33 Invalid Subscription Atributo 'rrule' inválido

ou

A rescisão da assinatura já foi feita

34 Payment token already exists O Token Cartão já existe.
35 Payment token creation declined Criação do Token Cartão recusada.
36 Payment token purged Atributo 'paymentToken' tratado.
40 Amount not authorized Atributo 'amount' não autorizado.
41 Card range not found Números do cartão não encontrados
42 Not enough credit O saldo do meio de pagamento não é suficiente.
43 No credit O reembolso não é autorizado para este contrato.
50 Brand not found Nenhuma marca localizada.
51 Merchant not enrolled Estabelecimento comercial não alistado.
52 Invalid ACS Signature Assinatura do ACS inválida
53 Technical error 3DS Erro técnico 3DS.
54 Wrong Parameter 3DS Parâmetro 3DS incorreto.
55 3DS Disabled 3DS desativado.
56 PAN not found PAN não encontrado.
57 Acquirer transient data not valid Os dados específicos que devem ser enviados ao adquirente são inválidos.
75 Cancel operation not available anymore, try a refund Cancelamento impossível, favor tentar um reembolso.
76 Refund operation not yet available, try a cancel Reembolso impossível, favor tentar um cancelamento
77 In order to refund this transaction, please contact RBM at the following address: solicitudes@rbm.com.co O adquirente Redeban não autoriza o reembolso para um cartão MAESTRO. Favor entrar em contato com RBM no endereço e-mail: solicitudes@rbm.com.co
78 In order to refund this transaction, please contact Credibanco at the following address: atrecom@credibanco.com O adquirente Credibanco não autoriza o reembolso para os cartões AMEX. Favor entrar em contato com Credibanco no endereço e-mail: atrecom@credibanco.com
79 In order to refund this transaction, please contact Davivienda at the following adress: cempresarial@davivienda.com O adquirente Redeban não autoriza o reembolso para os cartões Diners. Favor entrar em contato com Davivienda no endereço e-mail: cempresarial@davivienda.com
80 Transaction(s) not sent yet in CNAB/Remessa file Captura não autorizada porque a transação não foi salva em um arquivo CNAB/Remessa (Pagamento por Boleto).
81 Manual capture not allowed for this type of contract Captura manual não suportada nesta rede.
82 Refund not allowed on this transaction type Crédito não autorizado para este tipo de transação (VERIFICATION, CREDIT).
83 Refund not allowed on unpaid transaction Reembolso impossível para uma transação pendente.
97 OneyWsError Erro OneyWs.
98 Bad request Id Atributo RequestId inválido.
99 Undefined Error Erro desconhecido.

Precisões sobre os códigos de erros.

  • 0 - Ação efetuada com sucesso.

    Indica que o formato da solicitação está correto.

    ADVERTÊNCIA: Mesmo se responseCode tiver o valor 0, você deve analisar os campos seguintes para determinar se o pagamento foi realizado com sucesso:

    1. commonResponse.transactionStatusLabel para saber o status da transação,
    2. authorizationResponse.result para saber a razão da recusa da solicitação de autorização,
    3. paymentResponse.paymentError para saber quais são as outras razões da recusa.

  • 1 - Ação não autorizada.

    Indica que sua loja não tem autorização para criar transações em modo PRODUCTION.

  • 2 - Parâmetro inválido

    Este código é retornado quando um atributo for inválido. A mensagem de informação menciona que um erro de tipo param e fornece um complemento de informações sobre o atributo em questão.

    Código de erro Descrição Explicação
    33 Parâmetro 'paymentSource' inválido no caso de uma assinatura. Origem da transação inválida para uma assinatura.

    Os valores possíveis são "EC", MOTO", "CC" ou "OTHER".

    34 Parâmetro 'scheme' inválido no caso de uma criação de um Token Cartão. Tipo de cartão inválido durante a criação de um Token Cartão.
    35 Parâmetro phoneNumber' inválido Número de telefone do comprador inválido.
    36 Parâmetro 'email' inválido E-mail do comprado inválido.
    37 Parâmetro 'zipCode' inválido CEP do comprador inválido.
    38 Parâmetro 'cellPhoneNumber' inválido Número de telefone celular do comprador inválido.
    50 Parâmetro 'shopId' inválido Código loja não foi devidamente informado.
    51 Parâmetro 'submissionDate' inválido Data e hora UTC da transação não informadas.
    66 Parâmetro 'contractNumber' inválido Número de contrato comerciante inválido.
    82 Parâmetro 'initialAmount' inválido Valor inicial da assinatura inválido (inferior a 0).
    83 Parâmetro 'initialAmountNumber' inválido

    Quantidade de parcelas para as quais haverá que aplicar o valor initialAmount.

    Este atributo é obrigatório se initialAmount for valorizado.

    84 Parâmetro effectDate' inválido Data de início da assinatura inválida. A data não pode ser vencida.
    85 Parâmetro commission' inválido Parâmetro não informado e obrigatório para o Boleto no Brasil.
    90 Parâmetro 'enrolled' inválido Status do alistamento do portador é inválido.
    92 Parâmetro 'eci' inválido Indicador de Comércio Eletrônico inválido.
    93 Parâmetro 'xid' inválido Número de transação 3DS inválido.
    94 Parâmetro 'cavv' inválido Certificado do ACS inválido
    95 Parâmetro 'cavvAlgorithm' inválido Algorítmo de verificação da autenticação do portador (cavv) inválido.
    96 Parâmetro 'brand' inválido Rede do cartão inválida.
    101 Parâmetro 'paymentOptionCode' inválido Código da opção inválido.
    102 Parâmetro 'paymentOptionCode (invalid date)' inválido Data de vencimento da opção de pagamento inválida.
    103 Parâmetro 'amount/optionCode (inconsistency)' inválido Código da opção de pagamento não conforme ao valor.
    104 Parâmetro 'optionCode (not found) ' inválido Código da opção de pagamento desconhecido.
Exemplo: Endereço e-mail faltando para uma operação onde deve ser informado.
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">   
	<env:Header xmlns:env="http://www.w3.org/2003/05/soap-envelope">
		<shopId xmlns="http://v5.ws.vads.lyra.com/Header/">12345678</shopId>
		<requestId xmlns="http://v5.ws.vads.lyra.com/Header/">222e970d-9c8b-466f-b672-7d830af18a8c</requestId>
		<timestamp xmlns="http://v5.ws.vads.lyra.com/Header/">2015-04-01T09:41:11Z</timestamp>
		<mode xmlns="http://v5.ws.vads.lyra.com/Header/">TEST</mode>
		<authToken xmlns="http://v5.ws.vads.lyra.com/Header/">HW4+kJDlErT3g2z5KnUEjFxBPsg9NTjR6QOsXjfsKvk=</authToken>
	</env:Header>
	<soap:Body>
		<ns2:createTokenResponse xmlns:ns2="http://v5.ws.vads.lyra.com/">
			<createTokenResult>
				<requestId>222e970d-9c8b-466f-b672-7d830af18a8c</requestId>
				<commonResponse>
					<responseCode>2</responseCode>
					<responseCodeDetail>Error param 36: email</responseCodeDetail>
				</commonResponse>
				<authorizationResponse/>
			</createTokenResult>
		</ns2:createTokenResponse>
	</soap:Body>
</soap:Envelope>

  • 3 - Solicitação não processada

    Indica que a solicitação não pôde ser processada.

    Para maior detalhes,um complemento de informação é retornado na resposta.

    Exemplo:

    <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
    	<env:Header xmlns:env="http://www.w3.org/2003/05/soap-envelope"/>
    	<soap:Body>
    		<ns2:updatePaymentDetailsResponse xmlns:ns2="http://v5.ws.vads.lyra.com/">
    			<updatePaymentDetailsResult>
    				<requestId>024a5593-8537-46cf-afc3-fabb7c76bc97</requestId>
    				<commonResponse>
    					<responseCode>3</responseCode>
    						<responseCodeDetail>Bad Request[Detalhes do não processamento da solicitação]</responseCodeDetail>
    				</commonResponse>
    				<paymentResponse/>
    				<orderResponse/>
    				<cardResponse/>
    				<authorizationResponse/>
    				<captureResponse/>
    				<customerResponse/>
    				<markResponse/>
    				<threeDSResponse/>
    				<extraResponse/>
    				<fraudManagementResponse/>
    				<shoppingCartResponse/>
    			</updatePaymentDetailsResult>
    		</ns2:updatePaymentDetailsResponse>
    	</soap:Body>
    </soap:Envelope>

  • 25 - Número de contrato desconhecido.

    Indica que há um defeito no contrato comerciante.

    Diferentes casos são possíveis:

    • O valor transmitido na solicitação não corresponde a nenhum contrato registrado na loja (shopId),
    • Não há contrato associado na loja,
    • O contrato mencionado venceu,
    • Nenhum contrato corresponde ao tipo de contrato necessário para efetuar o pagamento. Este é o caso se você não possuir um contrato que aceita pagamento manual e se paymentSource tiver o valor de MOTO, CC ou OTHER na sua solicitação.

  • 35 - Token Cartão não criado.

    Indica que o Token Cartão não foi criado.

    O motivo da recusa é mencionado no atributo result do objeto authorizationResponse.

    Consultar o capítulo Gerenciar os códigos de retorno de uma solicitação de autorização para maiores detalhes.

    Exemplo :
    <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
    	<env:Header xmlns:env="http://www.w3.org/2003/05/soap-envelope">
    		<shopId xmlns="http://v5.ws.vads.lyra.com/Header/">12345678</shopId>
    		<requestId xmlns="http://v5.ws.vads.lyra.com/Header/">8fbf0b7a-c5bd-419d-b14d-23bf557c6139</requestId>
    		<timestamp xmlns="http://v5.ws.vads.lyra.com/Header/">2015-04-01T09:47:58Z</timestamp>
    		<mode xmlns="http://v5.ws.vads.lyra.com/Header/">TEST</mode>
    		<authToken xmlns="http://v5.ws.vads.lyra.com/Header/">DjY7Jr+a+7jzqD4FtYj7MflmVc8o/8QDPZkJdFSNk/k=</authToken>
    	</env:Header>
    	<soap:Body>
    		<ns2:createTokenResponse xmlns:ns2="http://v5.ws.vads.lyra.com/">
    			<createTokenResult>
    				<requestId>8fbf0b7a-c5bd-419d-b14d-23bf557c6139</requestId>
    				<commonResponse>
    					<responseCode>35</responseCode>
    					<responseCodeDetail>PaymentToken creation declined</responseCodeDetail>
    				</commonResponse>
    				<authorizationResponse>
    					<result>51</result>
    				</authorizationResponse>
    			</createTokenResult>
    		</ns2:createTokenResponse>
    	</soap:Body>
    </soap:Envelope>

  • 36 - Atributo 'paymentToken' tratado.

    Após 15 meses sem utilizar um Token Cartão, os dados do titular do meio de pagamento são apagados (referencial de segurança PCI DSS - segurança e proteção dos dados bancários).

  • 40 - Valor não autorizado.

    Indica que o valor da solicitação de criação ou de reembolso do pagamento não é conforme aos valores mínimo /máximo definidos no contrato comerciante.

    Você pode entrar em contato com o serviço ao cliente para conhecer os detalhes do seu contrato.

  • 99 - Erro técnico.

    Este código de erro é retornado no caso de um erro técnico interno.

    Para maiores informações, favor entrar em contato com o suporte técnico.

Exemplo: Endereço e-mail faltando para uma operação onde deve ser informado.
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
	<env:Header xmlns:env="http://www.w3.org/2003/05/soap-envelope">
		<shopId xmlns="http://v5.ws.vads.lyra.com/Header/">12345678</shopId>
		<requestId xmlns="http://v5.ws.vads.lyra.com/Header/">ca3d38d5-0344-461c-9f52-192482e09bda</requestId>
		<timestamp xmlns="http://v5.ws.vads.lyra.com/Header/">2015-04-01T09:47:58Z</timestamp>
		<mode xmlns="http://v5.ws.vads.lyra.com/Header/">TEST</mode>
		<authToken xmlns="http://v5.ws.vads.lyra.com/Header/">d3W/6dtIebGUpReqzrS40KHEImEway6ixrpn05pSGLY=</authToken>
	</env:Header>
	<soap:Body>
		<ns2:createTokenResponse xmlns:ns2="http://v5.ws.vads.lyra.com/">
			<createTokenResult>
				<requestId>ca3d38d5-0344-461c-9f52-192482e09bda</requestId>
				<commonResponse>
					<responseCode>99</responseCode>
				</commonResponse>
				<authorizationResponse>
					<result>96</result>
				</authorizationResponse>
			</createTokenResult>
		</ns2:createTokenResponse>
	</soap:Body>
</soap:Envelope>