Inter API Documentation

Version 2.0 - Enhanced Partner Integration Guide

Common Errors

This page consolidates common API errors, categories, and suggested resolutions. Exact messages may vary by method. For a programmatic list, see the GetErrorList API.

PIX (Brazil) - Error Codes

Code Description Resolution
7001PIX id is requiredProvide PixId
7002PixTypeId must be CPF, PHONE, EMAIL or RANDOMKEYSend a valid PixTypeId
7003Invalid PixTypeId valueUse one of the allowed values
7004RecipientCountry must be BR for PIXEnsure RecipientCountry is "BR"
7005Bank information must be empty for PIX transactionsDo not send bank fields for TypeOfPaymentID=42
7006Invalid CPF format for PixIdValidate CPF format
7007Invalid phone format for PixIdValidate E.164 format (e.g., +5511999999999)

Common Validation & Business Rules

Code Category Description Resolution
1059AmountsAmountSent below minimumIncrease amount (min $0.01)
1072Exchange RateExchange rate/amount validation errorRefresh rates and retry
1077TotalsTotal collected not correctRecalculate totals
1091Exchange RateInvalid outgoing exchange rateProvide valid rate
1103CountryInvalid country of origin/sender/recipientUse valid ISO 3166-1 alpha-2
1104CountryInvalid country of paymentCorrect payment country
1115CredentialsInvalid AgentID and PartnerID combinationVerify credentials
1195PermissionsOrder can only be edited by creating agentUse same agent company
2042CurrencyInvalid Currency of PaymentUse valid ISO 4217 (e.g., BRL, USD)
3001ValidationMissing required fieldFill required fields per corridor
3072ConfigurationAgent SP/config or rate/time validationFix configuration and refresh rates
3079Exchange RateXE rate required for BR corridorSend XE rate
3206ServiceService disabledContact administrator
3207ServiceState disabledContact administrator
3208ServiceState disabledContact administrator
3299Business RulesAutorelease/holiday or reason requiredSet flags and reason correctly
3300CardsCard token/flags invalid for card paymentsProvide token; adjust NeedConfirmationToBePaid
4101CreditAgent exceeded allowed credit limitClear balance or increase limit
4102BalanceInsufficient balance to complete transactionFund account
5009PermissionsFeature restricted to agent profileUse authorized account
5213LimitsAmount sent exceeds payee limitReduce amount
5214LimitsAmount received exceeds payee limitReduce amount
6001StatusInvalid order status/flowOperate only on incomplete orders
772FX HoldFX can only be held for 6 business daysRecreate with valid window
99ASystemUnexpected error or redeem value undefinedRetry and contact support
0000TestingTest transaction rejectedUse valid test data

Order/Lookup

Code Description Resolution
2001Order not found or reference conflictVerify OrderID or use unique AgentOrderReference

HTTP Status (Transport Layer)

Status Meaning Resolution
429Too Many Requests (rate limited)Backoff and retry after Retry-After header