API codes

Transaction status

Code	Name	Description
NOV	New	Transaction just created.
INV	Invalid	Transaction wasn't created successfully. Probably the merchant sent an incorrect parameter, so it wasn't possible to create the transaction correctly.
PPC	Pending confirmation	Payment pending confirmation.
PPN	Undone	Pending payment not confirmed (canceled).
PEN	Awaiting payment	Transaction awaiting answer from the financial institution.
CON	Confirmed	Transaction confirmed by the financial institution.
NEG	Denied	Transaction denied by the financial institution.
ERR	Error authorizing payment	Communication error with the authorizer. Try again.
BLQ	Blocked	Transaction blocked after multiple attempts of card querying.
EXP	Expired	Transaction expired.
EST	Reversed	Payment cancelled.
AGU	Awaiting user	Transaction awating user action.
ABA	Abandoned	Transaction expired due to excessive amount of user inactivity.
CAN	Canceled	Transaction canceled by the user/customer.
RET	Retry	Transaction denied by the financial institution, but scheduled for retry.

Schedule status

Code	Name	Description
NOV	New	Transaction just created.
INV	Invalid	Transaction wasn't created successfully. Probably the merchant sent an incorrect parameter, so it wasn't possible to create the transaction correctly.
PEN	Pending confirmation	Schedule pending confirmation.
DES	Undone	Pending schedule undone.
ATV	Active	Schedule active for executing recurrent transactions.
INA	Inactive	Schedule is inactive and won't execute recurrent payments.
ERR	Error	Error activating schedule.
FIN	Finished	Schedule already executed all recurrent payments and is now finished.
EXP	Expired	Transaction expired.

Storage status

Code	Name	Description
CON	Confirmed	Card stored successfully.
INV	Invalid	Storage wasn't successful. Probably the merchant sent an incorrect parameter, so it wasn't possible to create the transaction correctly.
NEG	Denied	The card was queried on SiTef and was classified as invalid.
DUP	Duplicated	Attempt by the merchant to store a card that was already stored on Carat Portal.
CAN	Cancelled	Storage of the card data cancelled by the customer. Data removed from Carat Portal, requested by the merchant.
DEL	Deleted	Card data were removed from Carat Portal as requested by the card owner.
BLQ	Blocked	Storage blocked due to a possible fraud attempt.

Response codes

Code	Description
0	Transaction OK
1	Null NIT field
2	Request is null
3	Invalid NIT field
4	Null authorizerId field
5	Invalid authorizerId field
6	Null autoConfirmation field
7	Empty autoConfirmation field
8	Null cardExpireDate field
9	Invalid cardExpireDate field
10	Null cardNumber field
11	Invalid cardNumber field
12	Null cardSecurityCode field
13	Invalid cardSecurityCode field
14	Null installments field
15	Invalid installments field
16	Null installmentType field
17	Invalid installmentType field
18	Null customerId field
19	Invalid customerId field
20	Null departureTax field
21	Invalid departureTax field
22	Null firstInstallment field
23	Invalid firstInstallment field
24	Null softDescriptor field
25	Invalid softDescriptor field
26	Null merchantKey field
27	Invalid merchantKey field
28	Null nsuSitef field
29	Invalid nsuSitef field
30	Null merchantId field
31	Invalid merchantId field
32	Null amount field
33	Invalid amount field
34	Null esitefUSN field
35	Invalid esitefUSN field
36	Null merchantUSN field
37	Invalid merchantUSN field
38	Invalid ordered field
39	Invalid parameter field
40	Null parameter field
41	Invalid parameterNumber field
42	Null jsonXml field
43	Invalid jsonXml field
44	Null method
45	Invalid method
46	Invalid url field
47	Invalid redirect field
48	Null card_hash field
49	Invalid card_hash field
50	Null financing_type field
51	Invalid financing_type field
52	Invalid sitef_ip field
53	Invalid sitef_port field
54	Invalid sitef_terminal field
55	Invalid sitef_merchant_id field
56	Invalid confirmation_data field
57	Invalid confirmation_type field
58	Null or empty inner_transactions field
59	Invalid extra_field field
60	Empty prefixes / key field
61	Empty prefixes / value field
62	Invalid additional_data field
63	Invalid prefixes field
64	financing_type field with ineterest not allowed
68	Null dealer_code field
69	Invalid dealer_code field
70	Null phone_ddd field
71	Null phone_number field
72	Invalid amount_key field
73	card_number and card_token fields cannot be used at the same time
74	amount field cannot be fixed to recharge transactions
75	Invalid phone_ddd field
76	Invalid phone_number field
77	Invalid store_card field
78	Invalid store_identification field
79	Invalid recharge_included field
80	Authorizer not implemented to mobile interface.
81	Operation not allowed.
82	Transaction not found.
83	Null store_identification field
84	Storage not allowed to the chosen authorizer.
85	Invalid purchase_summary field.
86	Empty item list.
87	Null authenticate field
88	Invalid card. Verify the card number or the chosen payment method.
89	Error retrieving transaction
100	Failed to perform payment transaction
101	Failed to confirm payment transaction
102	Transaction already completed or in progress
103	Invalid transaction type.
104	Invalid authorizer for the transaction.
105	Invalid transaction style.
106	Merchant without permission for operation.
107	Operation not allowed for the transaction status.
108	Authorizer inactive or not enabled for the merchant.
109	Installments exceed the limit set in the authorization.
110	Inactive merchant
111	Invalid authorizer type
112	Authorization with invalid configuration
113	Authorizer inactive or not enabled for the merchant.
114	Blocked transaction.
115	Authenticity error
116	Error in transaction query. Please try again later.
131	Communication failure with SiTef
132	Malformed request
134	Card query error
135	Merchant does not have permission to perform split transactions.
136	Rollback error
137	Invalid operation
138	Authorizer selection failure
139	There is no registered authorizer
140	Query returned many authorizers
141	The informed authorizer is not routed via SiTef
142	Error while querying card: unexpected response from authorizer
143	The card number you submitted does not match the chosen payment method.
144	Merchant without permission for Recharge V5 HTML
145	Merchant without permission for Recharge V5 WebService
146	Authentication error
147	Authentication denied
148	Authentication not allowed for this authorizer
149	Store without ISA authentication registration data.
150	Invalid Request
157	Invalid showTimesInvoice field
160	Merchant without permission for HTML transactions
161	Merchant without permission for payment transactions
162	Merchant without Permission for IATA Transactions
163	Authorizer registration with errors.
215	Sale with gift type card not enabled
216	Gift card recharge not enabled
217	Cancellation of payment via gift card not enabled
222	Invalid acquirer.authorization_number field
230	Invalid payer neighborhood field
231	Invalid payer uf field
232	Invalid payer name field
233	Invalid payer address_street_name / address_street_number field
234	Invalid payer identification_number field
235	Invalid payer city field
236	Invalid payer zipcode field
255	Denied payment
256	Waiting cancellation response
257	Refund denied
258	Recharge denied
259	Transaction denied
260	Recharge undone due to payment failure
261	Recharge must be resubmitted
300	Error creating refund transaction
301	Divergent card_number field
302	Communication failure
304	Invalid extra_info field
305	Invalid currency field
306	Invalid insurance_amt field
307	Invalid handling_amt field
308	Invalid tax_amount field
309	Invalid inner_transaction order_id field
310	Invalid inner_transaction merchant_id field
311	Invalid inner_transaction merchant_usn field
312	Invalid inner_transaction amount field
313	Invalid shipment type field
314	Invalid shipment cost field
315	Invalid shipment discount_amount field
316	Invalid shipment receiver_address_apartment field
317	Invalid shipment receiver_address_floor field
318	Invalid shipment receiver_address_street_name field
319	Invalid shipment receiver_address_street_number field
320	Invalid shipment receiver_address_zip_code field
321	Invalid shipment receiver_address_complement field
322	Invalid shipment receiver_address_district field
323	Invalid shipment receiver_address_city field
324	Invalid shipment receiver_address_state field
325	Invalid shipment receiver_address_country field
326	Invalid shipment receiver_address_name field
327	Invalid shipment receiver_address_phone_area_code field
328	Invalid shipment receiver_address_phone_number field
329	Invalid payment_method installments field
330	Invalid payment_method excluded_payment_method id field
331	Invalid payment_method excluded_payment_method name field
332	Invalid payment_method excluded_payment_method payment_type_id field
333	Invalid payment_method excluded_payment_method thumbnail field
334	Invalid payment_method excluded_payment_method secure_thumbnail field
335	Invalid payment_method excluded_payment_type id field
336	Invalid payment_method excluded_payment_type name field
337	Invalid payer phone_number field
338	Invalid payer phone_area_code field
339	Invalid payer date_created field
340	Invalid payer email field
341	Invalid payer born_date field
342	Invalid payer mother_name field
343	Invalid payer father_name field
344	Invalid payer sex field
345	Invalid payer phone_country_code field
346	Invalid payer phone_extension field
347	Invalid payer phone_extension_type field
348	Invalid payer tax_type field
349	Invalid payer address_type field
350	Invalid item id field
351	Invalid item description field
352	Invalid item category_id field
353	Invalid item picture_url field
354	Invalid item unit_price field
355	Invalid item quantity field
356	Invalid item title field
357	Invalid item weight field
358	Invalid item shipping_cost field
359	Invalid item quantity_itens_sum field
360	Invalid item tax_amount field
361	Invalid item weight_unit field
362	Invalid item length field
363	Invalid item length_unit field
364	Invalid item width field
365	Invalid item width_unit field
366	Invalid item height field
367	Invalid item height_unit field
368	Invalid item url field
369	Invalid item type field
370	Invalid extra_param metadata_item key field
371	Invalid extra_param metadata_item field field
372	Invalid extra_param metadata_item group field
373	Invalid extra_param prefix key field
374	Invalid extra_param prefix value field
375	Invalid extra_param acquirer_param key field
376	Invalid extra_param acquirer_param value field
400	Aborted transaction
723	The conditions sent are not supported by the acquirer. / Invalid acquirer credentials.
724	Invalid max_installments field
742	Invalid max_installments_with_interest field
743	Invalid allowed_payment_methods field
910	Transaction declined by e-Rede.
920	Transaction declined by Cielo e-Commerce.
930	Visa Checkout communication error.
934	Masterpass communication error.
940	Declined transaction by GetNet WS.
941	User not authenticated in GetNet WS.
942	Invalid username.
943	Invalid password.
944	Invalid merchant id.
945	Merchant track id.
946	Terminal id.
947	Null card field.
948	Null payment id.
949	Null PARes.
950	Declined transaction by Global Payments WS.
951	Null request.
952	Invalid merchant code.
953	Invalid terminal.
954	Invalid signature.
970	Transaction declined by SafetyPay.
971	Null refund reason.
972	Null credential.
980	Null cardholder.
981	Null order key.
989	Invalid anti-fraud institution to notify.
990	Null merchant id.
991	Null merchant code.
992	Invalid anti-fraud payment type.
993	Invalid anti-fraud authorizer.
994	Split payment not allowed to anti-fraud.
995	Recharge transaction type not allowed to anti-fraud.
996	Anti-fraud institution not registered.
997	Merchant without permission to use anti-fraud.
998	Anti-fraud analysis rejected, invalid or in review.
999	Null anti-fraud item id.
1000	Unexpected error in Carat Portal. Please contact support.
1003	Unexpected error in Carat Portal. Please contact support.
1004	Unexpected error in Carat Portal. Please contact support.
1010	Unexpected error accessing Carat Portal database. Please contact support.
1135	Invalid additional_data application_fee field
1136	Invalid additional_data binary_mode field
1137	Invalid additional_data discount_campaign_id field
1138	Invalid additional_data acquirer_expiry_date field
1139	Invalid additional_data description field
1140	Invalid payer type field
1141	Invalid additional_data acquirer_expiry_date_from field
1142	Invalid additional_data acquirer_expiry_date_to field
1143	Invalid additional_data acquirer_expires field
1144	Invalid shipment mode field
1145	Invalid shipment local_pickup field
1146	Invalid shipment dimensions field
1147	Invalid shipment default_shipping_method field
1148	Invalid shipment free_shipment field
1149	Invalid shipment free_methods id field
1150	Invalid ad_tracks type field
1151	Invalid ad_tracks conversion_id field
1152	Invalid ad_tracks conversion_label field
1153	Invalid ad_tracks pixel_id field
2000	Unexpected error in Carat Portal. Please contact support.
5555	Unexpected error in Carat Portal. Please contact support.

Negative Response codes (Routing via SiTef)

In routings via SiTef, you may receive negative response codes (for example, "-211"). In cases like this, please contact our support team.