API Error Codes

Error codes returned by the provider, identifying the reason for the error and their respective messages, in the parameters ProviderReturnCode and ProviderReturnMessage.

Provider Return Code	Provider Return Message	Description
0	Internal error	Data sent exceeds field size.
100	RequestId is required	Submitted field is empty or invalid.
101	MerchantId is required	Submitted field is empty or invalid.
102	Payment Type is required	Submitted field is empty or invalid.
103	Payment Type can only contain letters	Special characters not allowed.
104	Customer Identity is required	Submitted field is empty or invalid.
105	Customer Name is required	Submitted field is empty or invalid.
106	Transaction ID is required	Submitted field is empty or invalid.
107	OrderId is invalid or does not exist	Submitted field exceeds size or contains special characters.
108	Amount must be greater or equal to zero	Transaction value must be greater than "0".
109	Payment Type is required	Submitted field is empty or invalid.
110	Invalid Payment Currency	Submitted field is empty or invalid.
111	Payment Country is required	Submitted field is empty or invalid.
112	Invalid Payment Country	Submitted field is empty or invalid.
113	Invalid Payment Currency	Submitted field is empty or invalid.
114	The provided MerchantId is not in correct format	The submitted MerchantId is not a GUID.
115	The provided MerchantId was not found	MerchantID does not exist or belongs to another environment (EX: Sandbox).
116	The provided MerchantId is blocked	Shop locked, contact support Braspag.
117	Credit Card Holder is required	Submitted field is empty or invalid.
118	Credit Card Number is required	Submitted field is empty or invalid.
119	At least one Payment is required	"Payment" node not sent.
120	Request IP not allowed. Check your IP White List	IP blocked for security reasons.
121	Customer is required	"Customer" node not sent.
122	MerchantOrderId is required	Submitted field is empty or invalid.
123	Installations must be greater or equal to one	Number of installments must be greater than 1.
124	Credit Card Number is required	Submitted field is empty or invalid.
125	Credit Card Expiration Date is required	Submitted field is empty or invalid.
126	Credit Card Expiration Date is invalid	Submitted field is empty or invalid.
127	You must provide CreditCard Number	Credit Card Number is required.
128	Card Number length exceeded	Card number over 16 digits.
129	Affiliation not found	Non-store payment method or invalid Provider.
130	Could not get Credit Card	***
131	MerchantKey is required	Submitted field is empty or invalid.
132	MerchantKey is invalid	The submitted Merchantkey is not a valid.
133	Provider is not supported for this Payment Type	Provider submitted does not exist.
134	FingerPrint length exceeded	Data sent exceeds field size.
135	MerchantDefinedFieldValue length exceeded	Submitted data exceeds field size.
136	ItemDataName length exceeded	Submitted data exceeds field size.
137	ItemDataSKU length exceeded	Submitted data exceeds field size.
138	PassengerDataName length exceeded	Data sent exceeds field size.
139	PassengerDataStatus length exceeded	Data sent exceeds field size.
140	PassengerDataEmail length exceeded	Data sent exceeds field size.
141	PassengerDataPhone length exceeded	Data sent exceeds field size.
142	TravelDataRoute length exceeded	Submitted data exceeds field size.
143	TravelDataJourneyType length exceeded	Submitted data exceeds field size.
144	TravelLegDataDestination length exceeded	Submitted data exceeds field size.
145	TravelLegDataOrigin length exceeded	Submitted data exceeds field size.
146	SecurityCode length exceeded	Data sent exceeds field size.
147	Address Street length exceeded	Data sent exceeds field size.
148	Address Number length exceeded	Data sent exceeds field size.
149	Address Complement length exceeded	Data sent exceeds field size.
150	Address ZipCode length exceeded	Data sent exceeds field size.
151	Address City length exceeded	Data sent exceeds field size.
152	Address State length exceeded	Data sent exceeds field size.
153	Address Country length exceeded	Data sent exceeds field size.
154	Address District length exceeded	Data sent exceeds field size.
155	Customer Name length exceeded	Data sent exceeds field size.
156	Customer Identity length exceeded	Data sent exceeds field size.
157	Customer IdentityType length exceeded	Submitted data exceeds field size.
158	Customer Email length exceeded	Data sent exceeds field size.
159	ExtraData Name length exceeded	Data sent exceeds field size.
160	ExtraData Value length exceeded	Submitted data exceeds field size.
161	Boleto Instructions length exceeded	Data sent exceeds field size.
162	Boleto Demostrative length exceeded	Data sent exceeds field size.
163	Return Url is required	Return URL is not valid - Paging or extensions (E.g.:PHP) in the return URL.
166	AuthorizeNow is required	***
167	Antifraud not configured	Antifraud not linked to merchant registration.
168	Recurrent Payment not found	Recurrence not found.
169	Recurrent Payment is not active	Recurrence is not active. Paralyzed Execution.
170	Protected Card not configured	Protected Card not linked to merchant registration.
171	Affiliation data not sent	Order Processing Failed - Contact Braspag Support.
172	Credential Code is required	Validation of submitted credentials failed.
173	Payment method is not enabled	Payment method not linked to merchant registration.
174	Credit Card Number is required	Submitted field is empty or invalid.
175	EAN is required	Submitted field is empty or invalid.
176	Payment Currency is not supported	Submitted field is empty or invalid.
177	Card Number is invalid	Submitted field is empty or invalid.
178	EAN is invalid	Submitted field is empty or invalid.
179	The max number of installments allowed for recurring payment is 1	Submitted field is empty or invalid.
180	The provided Card PaymentToken was not found	Cartão Protegido's token not found.
181	The MerchantIdJustClick is not configured	Cartão Protegido's Token Locked.
182	Brand is required	Card brand not sent.
183	Invalid customer birthdate	Invalid or future date of birth.
184	Request could not be empty	Failed to form this request. Check the code sent.
185	Brand is not supported by selected provider	Flag not supported by Gateway de Pagamento.
186	The selected provider does not support the options provided (Capture, Authenticate, Recurrent or Installments)	Payment method does not support the command sent.
187	ExtraData Collection contains one or more duplicated names	***
188	Avs with CPF invalid	***
189	Avs with length of street exceeded	Submitted data exceeds field size.
190	Avs with length of number exceeded	Data sent exceeds field size.
190	Avs with length of complement exceeded	Data sent exceeds field size.
191	Avs with length of district exceeded	Submitted data exceeds field size.
192	Avs with zip code invalid	Zip code sent is invalid.
193	Split Amount must be greater than zero	Value for Split de Pagamento must be greater than 0.
194	Split Establishment is Required	Split de Pagamentos not enabled for store registration.
195	The PlataformId is required	Platform Not Validated.
196	DeliveryAddress is required	Required field not submitted.
197	Street is required	Required field not submitted.
198	Number is required	Required field not submitted.
199	ZipCode is required	Required field not submitted.
200	City is required	Required field not submitted.
201	State is required	Required field not submitted.
202	District is required	Required field not submitted.
203	Cart item Name is required	Required field not submitted.
204	Cart item Quantity is required	Required field not submitted.
205	Cart item type is required	Required field not submitted.
206	Cart item name length exceeded	Data sent exceeds field size.
207	Cart item description length exceeded	Data sent exceeds field size.
208	Cart item sku length exceeded	Data sent exceeds field size.
209	Shipping address sku length exceeded	Data sent exceeds field size.
210	Shipping data cannot be null	Required field not submitted.
213	Credit Card Number is invalid	Credit card sent is invalid.
214	Credit Card Holder Must Have Only Letters	Cardholder must not contain special characters.
215	Agency is required in Boleto Credential	Required Field Not Submitted.
216	Customer IP address is invalid	IP blocked for security.
300	MerchantId was not found	***
301	Request IP is not allowed	***
302	Sent MerchantOrderId is duplicated	***
303	Sent OrderId does not exist	***
304	Customer Identity is required	***
306	Merchant is blocked	***
307	Transaction not found	Transaction not found or missing in environment.
308	Transaction not available to capture	Transaction cannot be captured - Contact Braspag Support. *Check if the reported amount is less than the total amount of the transaction or if it is available for capture
309	Transaction not available to void	Transaction cannot be canceled - Contact Support Braspag.
310	Payment method do not support this operation	Command sent not supported by payment method.
311	Refund is not enabled for this merchant	Cancellation after 24 hours not released to retailer.
312	Transaction not available to refund	Transaction does not allow cancellation after 24 hours.
313	Recurrent Payment not found	Recurring transaction not found or not available in the environment.
314	Invalid Integration	***
315	Cannot change NextRecurrency with pending payment	***
316	Cannot set NextRecurrency to past date	Not allowed to change recurrence data for a past date.
317	Invalid Recurrency Day	***
318	No transaction found	***
319	Smart recurrency is not enabled	Recurrence not linked to merchant registration.
320	Cannot Update Affiliation Because this Recurrency not Affiliation saved	***
321	Cannot set EndDate to before next recurrency	***
322	Zero Dollar Auth is not enabled	Zero Dollar not linked to merchant registration.
323	Bin Query is not enabled	Bins Query not linked to merchant registration.

Other Error Codes

The following codes are returned in case of communication failure between the API and the acquirer (timeout) or due to some integration failure.

When there is a communication failure with the acquirer, it is possible that the transaction has been approved. In these cases, there is an internal process that queries the transaction with the acquirer and updates the status in case of discrepancies. The merchant must register the webhook to receive notifications on status change.

See some codes below:

Code	Meaning
BP171	Rejected by fraud risk (Velocity)
BP335	Cancel aborted by Split transactional error
BP900	Operation failure
BP901	Operation failure
BP902	Wait for the answer of the previous operation
BP903	Cancellation failure