Capacidades por Provedor
Quick Reference
Países e moedas de liquidação suportados nesta matriz:
| País | Moeda | ISO | Decimais | Tipo de documento |
|---|---|---|---|---|
| Brasil | BRL | BR | 2 | CPF / CNPJ |
| México | MXN | MX | 2 | RFC / CURP |
| Chile | CLP | CL | 0 | RUT |
| Colômbia | COP | CO | 0 | CC (Cédula de Ciudadanía) |
| Peru | PEN | PE | 2 | DNI |
| Argentina | ARS | AR | 2 | DNI / CUIT |
CLP (Peso Chileno) e COP (Peso Colombiano) não possuem unidades fracionárias. Envie valores como inteiros: 50000 para CLP, 200000 para COP. O backend trunca decimais para essas moedas.
A habilitação ainda depende do seu perfil de comerciante, contratos com adquirentes e configuração da carteira. Esta tabela é um resumo de capacidade de roteamento, não uma lista de habilitações por comerciante.
Matriz de método por país
| Método de pagamento | Brasil | México | Chile | Colômbia | Peru | Argentina |
|---|---|---|---|---|---|---|
| Cartão de crédito | Sim | Sim | Sim | Sim | Sim | Sim |
| Cartão de débito | Sim | Sim | — | — | — | — |
| Boleto | Sim | — | — | — | — | — |
| PIX | Sim | — | — | — | — | — |
| SPEI | — | Sim | — | — | — | — |
| OXXO | — | Sim | — | — | — | — |
| E-Wallet | Sim | Sim | Sim | — | — | Sim |
| QRA | — | — | — | — | — | Sim |
| PFC | — | — | — | — | — | Sim |
| Apple Pay | Sim | Sim | — | — | — | — |
| Google Pay | Sim | Sim | — | — | — | — |
Limites de valor por transação
| Método | Moeda | Mínimo | Máximo | Observações |
|---|---|---|---|---|
| Cartão de crédito | BRL | R$ 0,01 | Depende do adquirente | Valor da parcela também validado |
| Cartão de crédito | MXN | MXN $0,01 | Depende do adquirente | — |
| Cartão de crédito | CLP | CLP $1 | Depende do adquirente | Apenas valores inteiros |
| Cartão de crédito | COP | COP $1 | Depende do adquirente | Apenas valores inteiros |
| Cartão de crédito | ARS | ARS $0,01 | Depende do adquirente | — |
| Cartão de crédito | PEN | PEN 0,01 | Depende do adquirente | — |
| PIX | BRL | R$ 0,01 | Limite diário da conta | Confirmação instantânea |
| Boleto | BRL | R$ 5,00 | Depende do adquirente | Bancos rejeitam boletos abaixo de R$5 |
| SPEI | MXN | MXN $1,00 | Depende do adquirente | Transferência bancária |
| OXXO | MXN | MXN $1,00 | MXN $10.000 | Limite por transação nas lojas OXXO |
| QRA | ARS | ARS $1,00 | Depende do adquirente | Pagamento por QR code |
| PFC | ARS | ARS $1,00 | Depende do adquirente | Rede de vouchers em dinheiro |
Se o valor estiver abaixo do mínimo do adquirente, a resposta retorna amount_below_minimum. Se acima do máximo, retorna amount_exceeds_maximum. O adquirente Cielo também retorna códigos específicos: 64 (valor mínimo inválido) e EE (parcela abaixo do mínimo). Veja códigos de resposta para a lista completa.
Notas específicas por país
Brasil
- PIX: Retorna um QR code e um código copia-e-cola. Pagamento confirma em segundos. CPF ou CNPJ é obrigatório no objeto do cliente.
- Cartão de crédito: Suporta parcelamento (campo
installments, 1-12). Elo e Hipercard são suportados junto com Visa e Mastercard. - Boleto: Suportado via adquirentes Cielo e Bradesco. Valor mínimo R$ 5,00. Retorna código de barras e URL de pagamento.
México
- SPEI: Transferência bancária usando CLABE (formato 18 dígitos). Liquidação em horário bancário. Exiba o valor
clabeda resposta para o cliente. - OXXO: Pagamento em dinheiro em lojas de conveniência. Gera referência com janela de 48 horas. Monitore o status
pendingaté confirmação.
Chile
- Moeda: CLP é uma moeda sem decimais. Envie valores como inteiros (
50000, não50000.00). O backend trunca qualquer parte fracionária. - Cartão de crédito: RUT (formato
XX.XXX.XXX-X) é obrigatório para cartões locais. Cartões internacionais não exigem RUT. - Adquirentes: Roteado via PagSeguro, Directa24 ou Monnet.
Colômbia
- Moeda: COP é uma moeda sem decimais. Envie valores como inteiros (
200000, não200000.00). O OpenPay converte paraint()para COP. - Cartão de crédito: Cédula de Ciudadanía (CC) é obrigatória como documento do pagador.
- Adquirentes: Roteado via PagSeguro, Monnet ou OpenPay.
Peru
- Moeda: PEN usa 2 casas decimais (padrão).
- Cartão de crédito: DNI é obrigatório como documento do pagador.
- Adquirentes: Roteado via PagSeguro ou Monnet.
Argentina
- Moeda: ARS usa 2 casas decimais. Sujeito a controles de capital — a taxa FX pode diferir das taxas oficiais. Veja taxas FX.
- QRA: Rail de pagamento QR para débito local. O cliente escaneia pelo app do banco. Liquidação em tempo real.
- PFC: Rede Pago Fácil e Cobro Express. Gera voucher com código de referência. Liquidação em 1-2 dias úteis.
- Adquirentes: Roteado via Bamboo ou MercadoPago.
Sempre teste com métodos de pagamento e dados de teste específicos do país no sandbox antes de ir para produção. Credenciais de produção são específicas por país e não podem ser compartilhadas entre regiões.