Return Codes

The return codes are used by client applications as a way to assist in decision-making when integrating with our platform.

For example, upon receiving a return code indicating that the card is Over Limit or Insufficient Funds, there is no need to attempt transaction approval again, as the transaction will be denied once more regardless. Therefore, it is recommended that the client application (you, the API user) maps all return codes and makes decisions accordingly.

For more, see below an example response containing the return code schema:

JSON

{
	"returnCode": "0",
	"returnMessage": "Sucesso."
}

Código de Resposta	Descrição
0, 00, 4, 6	Transaction authorized successfully.
01	Transaction unauthorized. Transaction referred (suspected fraud) by the issuing bank.
02	Transaction not authorized. Transaction referred (suspected fraud) by the issuing bank.
03	Transaction not allowed. TEF code error.
04	Transaction unauthorized. Card blocked by the issuing bank.
05	Transaction unauthorized. Card in default (Do not honor).
06	Transaction unauthorized. Card canceled.
07	Transaction denied. Retain card, special condition.
08	Transaction unauthorized. Invalid security code.
09	Partial transaction cancellation successful.
10	Transaction unauthorized by the issuer.
11	Transaction successfully authorized for card issued abroad.
12	Invalid transaction, card error.
13	Transaction not allowed. Invalid transaction amount.
14	Transaction unauthorized. Invalid card.
15	Issuer bank unavailable or nonexistent.
16	Unauthorized transaction. Trail failure.
19	Redo the transaction or try again later.
21	Cancellation not completed. Transaction not found.
22	Invalid installment. Invalid number of installments.
23	Transaction unauthorized. Invalid installment amount.
24	Invalid number of installments.
25	Transaction unauthorized. Original transaction not found.
26	Transaction unauthorized. Duplicate transaction.
27	Transaction unauthorized. Invalid file.
28	Transaction unauthorized. Invalid file.
29	Transaction unauthorized. Invalid file.