Error management

Error scenarios in a resource response will return an object as an example below, where the status_code field will contain the error_code value from the tables below and description will contain the error message:
json
{ "status_code": 400, "name": "ValidationError", "message": "Bad Request", "details": [ { "status": "DENIED", "error_code": "GENERIC-400", "description": "data,card,expiration_year is invalid", "description_detail": "expiration_year is required" } ] }

Credit/Debit - 400 Bad Request

error\_codedescription
PAYMENTS-012Input amount greater than or equal to the transaction amount
PAYMENTS-013Invalid portion amount
PAYMENTS-015Contact issuer
PAYMENTS-016Invalid NSU
PAYMENTS-019Date of issue of the invalid card
PAYMENTS-020Invalid expiration date
PAYMENTS-024Transaction undone
PAYMENTS-025Invalid authentication
PAYMENTS-026Invalid authorization
PAYMENTS-029Invalid pre-authorization
PAYMENTS-044Format error
PAYMENTS-050Contact the institution
PAYMENTS-051Parameterized negative response
PAYMENTS-054Pending confirmation
PAYMENTS-055Transaction cancelled
PAYMENTS-056Transaction not allowed in this cycle
PAYMENTS-058Reverse transaction
PAYMENTS-060Card required in the transaction
PAYMENTS-061Generic rejection
PAYMENTS-066Invalid payment method
PAYMENTS-068Invalid card digit
PAYMENTS-069Repeated transaction
PAYMENTS-070Card number does not check
PAYMENTS-072Non-cancellable transaction
PAYMENTS-073Transaction already cancelled
PAYMENTS-078Invalid data on cancellation
PAYMENTS-079Invalid cancellation amount
PAYMENTS-080Invalid card
PAYMENTS-081Exceeds date
PAYMENTS-082Invalid cancellation
PAYMENTS-083Use debit function
PAYMENTS-084Use credit function
PAYMENTS-085Transaction already made
PAYMENTS-090Transaction not authorized by the card
PAYMENTS-091Outside the allowed deadline
PAYMENTS-093Authorization is already in process
PAYMENTS-094Authorization to confirm receipt
PAYMENTS-098Unregistered customer
PAYMENTS-117Ask the porter to call the sender
PAYMENTS-118Invalid card or product not enabled
PAYMENTS-999Unprocessed transaction
GENERIC-400Invalid credit card
Validation Error
Header Validation
Error Requesting a Cancel
Service error
Parameter invalid
Argument invalid
Brand code not enabled
Query Validation Error

Credit/Debit - 401 Unauthorized

error_codedescription
GENERIC-401Unauthorized

Credit/Debit - 402 Business Error

error\_codedescription
PAYMENTS-001Value not reported
PAYMENTS-002Invalid card
PAYMENTS-003Expired card
PAYMENTS-004Invalid parameter
PAYMENTS-005Invalid security code
PAYMENTS-006Invalid flag
PAYMENTS-007Operation not allowed
PAYMENTS-008Invalid data
PAYMENTS-009Minimum value of the invalid installment
PAYMENTS-010Invalid number of plots
PAYMENTS-011Number of plots exceeds limit
PAYMENTS-014Installment payment not allowed
PAYMENTS-022Invalid currency code
PAYMENTS-023Flag does not belong to the network
PAYMENTS-030Error in user authentication
PAYMENTS-032Denied by the issuer
PAYMENTS-033Invalid establishment
PAYMENTS-034Unauthorized request
PAYMENTS-036Request identification
PAYMENTS-037Transaction in progress
PAYMENTS-038Invalid transaction
PAYMENTS-039Invalid transaction amount
PAYMENTS-041Redo the transaction
PAYMENTS-045Restricted card
PAYMENTS-046Lost card
PAYMENTS-047Stolen card
PAYMENTS-048Card without registration
PAYMENTS-049Transaction not allowed to this customer
PAYMENTS-052Duplicate transaction
PAYMENTS-053Card locked
PAYMENTS-067Threshold value exceeded
PAYMENTS-077Invalid card number
PAYMENTS-096Credit exceeded
PAYMENTS-101Offline Authorizer
PAYMENTS-102Customer with no credit limit
PAYMENTS-103Transaction not authorized by the authorizing network
PAYMENTS-104Integration error
PAYMENTS-105Unauthorized transaction
PAYMENTS-109There is a transaction to be confirmed
PAYMENTS-112Non-existent document to cancel
PAYMENTS-113Insufficient Balance
PAYMENTS-114Exceeds the Approval Value Threshold
PAYMENTS-115Exceeds the Withdrawal Frequency Limit
PAYMENTS-116Authorisation refused
SERVICE-402Error capturing credit transaction
Error adjusting credit pre authorization transaction
GENERIC-402Error on creating postponed transaction
Postponed payment is expired
Antifraud Denied
Document invalid
Error canceling credit transaction
Error validating business requirements

Credit/Debit - 403 Forbidden

error\_codedescription
GENERIC-403Payment method is not allowed
Brand Type is not allowed
Service is not enabled
Invalid Token Or Previously Used Token
Unauthorized error
PIX product not enabled

Credit/Debit - 404 Not Found

error\_codedescription
PAYMENTS-043Record not found
PAYMENTS-057Transaction does not exist
PAYMENTS-076Transaction not available
PAYMENTS-095Authorization not found
GENERIC-404Error on creating postponed transaction
Transaction not found
Register was not found

Credit/Debit - 409 Conflict

error_codedescription
GENERIC-409The request could not be processed because of conflicting parameters

Credit/Debit - 412 Precondition Failed

error\_codedescription
GENERIC-412Parameter was not found
Parameter was not defined

Credit/Debit - 422 Unprocessable Content

error\_codedescription
GENERIC-422Unprocessable Entity
No refunds of partial sales, only full refunds allowed.
Canceled or denied payments cannot be canceled
Partial cancel can only be made after the capture day
CANCEL-124Denied, violation of law
CANCEL-070Denied. Operation refund not avaiable for authorized transaction
CANCEL-088Denied. Insufficient balance for this transaction

Credit/Debit - 500 Internal Server Error

error_codedescription
PAYMENTS-042Invalid response
PAYMENTS-059Local network problem
PAYMENTS-062Institution temporarily out of operation
PAYMENTS-063System malfunction
PAYMENTS-064Database error
PAYMENTS-071Temporarily blocked authorizer
PAYMENTS-086Transaction error
PAYMENTS-099Uninitialized authorizer
PAYMENTS-100Disconnected channel
PAYMENTS-107Communication error
PAYMENTS-500Internal Server Error
GENERIC-500The server encountered an unexpected error

Credit/Debit - 501 Not Implemented

error_codedescription
GENERIC-501Invalid response from the upstream server

Credit/Debit - 503 Service Unavailable

error_codedescription
PAYMENTS-021Issuer System Unavailable - Please Try Again
GENERIC-503The server is currently unable to handle the request, try again later

Credit/Debit - 504 Gateway Timeout

error_codedescription
PAYMENTS-031Timeout
PAYMENTS-089Internal timeout
GENERIC-504Connection timeout

Boleto - 402 Business Error

error\_codedescription\_detail
PAYMENTS -40200001 - Our invalid/incompatible number
00007 - Invalid document species
00016 - Invalid expiration date
00057 - Incorrect drawdown ZIP code
00058 - Incorrect CPF/CNPJ
00093 - Title value not reported
00098 - Invalid Issue Date
00100 - Issue date greater than due date
00102 - Address of the drawee not informed
00103 - Municipality of the drawee not informed
00107 - Incorrect federation unit
00113 - Invalid discount amount
00124 - Zip code of the drawdown not found
00128 - Invalid protest code
00145 - Invalid document type
00147 - Number of days for invalid protest
00160 - Neighborhood of the drawn-out not informed
00176 - Record not found
00422 - Inconsistent certificate
00423 - Station is not of the covenant
00424 - Agreement not marked for message exchange for online entry
00425 - Environment marked as test and NSU is not test
00426 - Environment marked as production with test NSU
00427 - Station code does not belong to the agreement
00428 - Covenant is not active
00429 - Invalid discount type
00430 - Exempt with discount value
00431 - Field our non-numeric number
00432 - Client does not have online entry
00433 - Invalid discount deadline

Transactions Denied by Anti-Fraud

error\_codedescription
fraudTransaction denied by Anti-Fraud system security rule
200
250
0700
2000
480
481
0150Transaction sent with the "amount" field filled with the null or invalid amount
0902Transaction sent with the "required" field filled with the null or invalid amount
101
102
231Incorrectly filled in credit card details
0400
202
400Credit card issuer did not approve the transaction.
0330
0500
0600
1300
0800
234Unavailability in the Anti-Fraud system. Contact GetNet.
0901
0000
0903
150
151
121
500

On this page

Error management
Credit/Debit - 400 Bad Request
Credit/Debit - 401 Unauthorized
Credit/Debit - 402 Business Error
Credit/Debit - 403 Forbidden
Credit/Debit - 404 Not Found
Credit/Debit - 409 Conflict
Credit/Debit - 412 Precondition Failed
Credit/Debit - 422 Unprocessable Content
Credit/Debit - 500 Internal Server Error
Credit/Debit - 501 Not Implemented
Credit/Debit - 503 Service Unavailable
Credit/Debit - 504 Gateway Timeout
Boleto - 402 Business Error
Transactions Denied by Anti-Fraud