Expandir para outro país muda o que a operação precisa saber antes de escolher uma rota. O método local, a moeda, o documento do pagador, o contrato com o provedor e a moeda de liquidação existem antes do roteamento. A orquestração de pagamentos explica a camada que separa a intenção de cobrar do caminho que executa essa intenção. O Smart Routing explica como uma rota é escolhida quando já existe mais de um caminho permitido. Este guia trata do que a expansão acrescenta: o que precisa estar decidido para que uma rota internacional seja real, e o que uma camada comum não deve apagar.
O texto é para times de produto, engenharia e finanças que já processam num mercado e estudam outro. Os exemplos são sintéticos. A documentação pública da AZPay consultada em 7 de novembro de 2026 descreve uma matriz de métodos e moedas e avisa que a habilitação depende do perfil do comerciante, dos contratos com adquirentes e da configuração da carteira. Nada neste artigo transforma essa matriz em cobertura garantida para qualquer conta.
O que a expansão pede antes de existir uma rota?
Uma intenção de pagamento continua sendo a mesma ideia em qualquer país: cobrar um valor por um pedido, saber se foi aceito e conciliar o que liquidou. A orquestração, no sentido do artigo pilar, recebe essa intenção e coordena o caminho. Na expansão, o caminho só existe se alguém respondeu perguntas anteriores.
Qual método o comprador desse país realmente usa para concluir a compra? Em que moeda o valor é apresentado e em que moeda o dinheiro liquida? Qual documento o provedor exige no objeto do pagador? Qual contrato e qual credencial de produção valem para aquele país? Quem é a entidade que vende e quem é a entidade que recebe? Enquanto essas respostas forem suposição, não há rota para o Smart Routing escolher. Há um desejo de vender lá fora.
Conectar um segundo PSP no mesmo país para ter contingência é um problema de disponibilidade. Abrir um país novo é um problema de adequação: o método, a regra e o acerto financeiro daquele mercado. Os dois problemas podem coexistir. Eles não se resolvem com a mesma configuração.
A intenção do pedido permanece; o instrumento muda
O pedido comercial deve guardar um identificador estável, o valor que o comprador aceitou, a moeda apresentada e o país ou mercado da venda. A tentativa de pagamento referencia esse pedido e registra o método, o provedor, o identificador externo e o resultado. Essa separação já é útil com um único PSP. Na expansão, ela impede que o checkout brasileiro seja copiado com os campos trocados e ainda assim pareça “o mesmo fluxo”.
Um pedido de uma assinatura digital vendida para o México não é um pedido brasileiro com o rótulo do país alterado. O valor pode estar em pesos mexicanos. O método pode ser uma transferência SPEI ou um pagamento em dinheiro numa rede de conveniência, se isso estiver habilitado. O documento do pagador segue a exigência daquele mercado. O webhook de confirmação continua sendo um fato da tentativa, associado ao pedido, e não um status genérico colado na ordem sem método.
O artigo sobre gateway, PSP, adquirente e subadquirente ajuda a nomear os participantes. Na expansão, o nome do participante importa menos do que a pergunta: este caminho executa este método, nesta moeda, para esta conta? Se a resposta depender de um contrato que ainda não foi assinado, a aplicação deve tratar o país como indisponível, em vez de exibir um botão que vai falhar no pagamento.
O que uma camada comum não deve normalizar?
Normalizar o estado ajuda: criado, em processamento, confirmado, falhou, devolvido. Normalizar o método até ele desaparecer atrapalha. Pix, boleto, cartão, SPEI e um voucher de dinheiro não compartilham prazo, comprovante nem documento. Uma interface única pode criar a cobrança. Ela ainda precisa guardar o tipo e os campos que o comprador usou para pagar.
A matriz pública de capacidades da AZPay, lida em 7 de novembro de 2026, lista países e moedas de liquidação como Brasil em BRL, México em MXN, Chile em CLP, Colômbia em COP, Peru em PEN e Argentina em ARS. A mesma página diz que CLP e COP não têm centavos e que os valores dessas moedas devem ser enviados como inteiros. Isso é um detalhe de integração com efeito financeiro. Arredondar um valor chileno como se fosse real cria divergência entre o que o comprador viu e o que o provedor recebeu. A orquestração pode centralizar a regra. Ela não pode tratar toda moeda como se tivesse duas casas decimais.
A página também resume métodos por país: Pix e boleto aparecem no Brasil; SPEI e OXXO, no México; QRA e PFC, na Argentina; cartão de crédito aparece em todos os países dessa matriz. Notas da própria página atribuem, por exemplo, documento local obrigatório em alguns cartões e provedores de roteamento nomeados por país. Tudo isso é capacidade descrita de roteamento, com a ressalva explícita de que habilitação por comerciante é outra coisa. Um artigo não converte a tabela em promessa de que cada método está ligado na sua conta.
Apagar o método na conciliação é o erro seguinte. O financeiro precisa ver que um pedido mexicano liquidou por SPEI e outro, no mesmo dia, por cartão. A conciliação de pagamentos cruza venda, captura e liquidação. Na expansão, o cruzamento ganha moeda de apresentação, moeda de liquidação e identificador do país. Somar tudo em uma coluna “aprovado” sem moeda mistura reais com pesos.
Pix permanece um método do Brasil
Na matriz consultada, Pix está marcado para o Brasil e não para México, Chile, Colômbia, Peru ou Argentina. A nota de Brasil descreve retorno de QR e copia e cola, confirmação e documento CPF ou CNPJ. Isso combina com o recorte do Pix como arranjo brasileiro. Um comprador no exterior pode, em alguns desenhos comerciais, pagar um recebedor brasileiro com Pix se tiver como iniciar esse pagamento no arranjo. Esse caso continua sendo Pix no Brasil, não um método local do país onde a pessoa está viajando.
Por isso, “aceitar pagamentos internacionais” não significa “levar o Pix para cada país da expansão”. Se o mercado novo exige transferência local, dinheiro ou cartão com documento local, a intenção de cobrança usa esse instrumento. O guia de Pix continua válido para a operação brasileira. Ele não substitui a pesquisa do método do outro país.
A mesma clareza vale no sentido inverso. Abrir o Brasil para uma empresa que já vende em outro lugar pede Pix ou boleto como métodos próprios, com confirmação e conciliação próprias, e não um cartão estrangeiro reapresentado como se cobrisse o hábito local. A orquestração guarda a intenção. O método entra como decisão do mercado.
Smart Routing começa quando a rota já é possível
O Smart Routing escolhe entre caminhos permitidos com base em regras e sinais. Ele não fabrica um método que o provedor não oferece nem um contrato que a conta não tem. Se a única rota habilitada para o México é cartão, uma regra que manda “tudo que for MXN para SPEI” não tem onde cair. A falha é de catálogo, anterior à engine de roteamento.
Quando duas rotas realmente existem, o artigo de Smart Routing é a referência para regra, explicabilidade e métrica. Este texto não repete a lista de sinais nem o desenho de fallback. O ponto de expansão é a ordem: primeiro o país está habilitado com método, moeda, documento e credencial de produção próprios; depois a política de routing pode distribuir ou contingenciar o tráfego dentro desse conjunto.
Credencial de produção por país, como a documentação de capacidades pede ao orientar o teste em sandbox antes da produção, também limita o routing. Uma chave brasileira não deve ser reutilizada silenciosamente para liquidar outro país. A tentativa precisa saber qual ambiente e qual conta executaram o pagamento. Sem isso, o fallback “tenta o outro provedor” pode tentar o outro provedor com o contrato errado.
Contrato, habilitação e liquidação vêm antes do botão
A página de capacidades afirma que a tabela não é uma lista de habilitações por comerciante. Essa frase deve aparecer no plano de expansão em linguagem de projeto: método visível no checkout somente depois da confirmação de contrato, adquirente e carteira. Um país “no roadmap” não é um país no seletor de pagamento.
Liquidação é o momento em que o valor sai do estado de venda autorizada e entra no controle que o financeiro reconcilia. Prazo, tarifa e moeda de liquidação variam por método. A documentação consultada descreve, por exemplo, confirmação de Pix em segundos na nota de Brasil, liquidação de SPEI em horário bancário e janela de referência para OXXO. São descrições de produto e de método, sujeitas ao provedor e ao contrato. O plano de expansão registra a expectativa operacional com a fonte, em vez de copiar um prazo de um país para o outro.
A documentação de payout da AZPay, também lida em 7 de novembro de 2026, descreve saída de dinheiro da carteira por trilhos como Pix, TED, SPEI e transferência, e diz que a seleção de provedor e um failover podem ocorrer nesse fluxo de payout antes de um erro final. Isso é uma capacidade documentada de desembolso, não uma prova de que toda cobrança internacional tem o mesmo failover. Cobrar um comprador e pagar um beneficiário são fluxos diferentes. A expansão precisa dizer qual dos dois está sendo aberto.
Taxa de câmbio, quando existir conversão, é outro contrato. A página de Argentina da matriz avisa que controles de capitais podem fazer a taxa divergir de referências oficiais e aponta para a documentação de FX. Este artigo não publica taxa, spread nem prazo de conversão. Se o pedido é cobrado numa moeda e liquidado em outra, o registro guarda as duas quantias e a referência da cotação usada, para a conciliação não inventar o número depois.
Um lançamento sintético em dois países
Imagine uma empresa de software, sem relação com clientes reais, que já cobra no Brasil e quer vender a mesma licença no México. No Brasil, o pedido de R$ 120 pode ser pago com Pix, se a conta estiver habilitada para isso: cobrança em BRL, documento brasileiro, confirmação associada ao pedido BR-1001. No México, o pedido de 490 pesos é o pedido MX-2001, em MXN, com o método que o contrato mexicano realmente permitir. Os dois pedidos não compartilham identificador, documento nem cobrança.
O checkout mostra o método do mercado da sessão. A aplicação envia a intenção com moeda, valor na escala correta e tipo de cobrança. O adaptador do país preenche o documento exigido. O resultado volta para a tentativa daquele pedido. Um pagamento confirmado em MX-2001 não quita BR-1001. Um webhook brasileiro não fecha o pedido mexicano.
Se a conta mexicana ainda só tem cartão, o checkout mexicano oferece cartão. SPEI fica de fora até a habilitação. O time pode querer SPEI porque a matriz o lista no México. A lista é o catálogo descrito. O botão espera o contrato. Enquanto isso, o Smart Routing do Brasil continua resolvendo contingência entre rotas brasileiras, sem ser usado como atalho para “enviar o Pix ao México”.
A conciliação do dia mostra duas linhas: BR-1001, BRL, Pix, valor recebido conforme o evento; MX-2001, MXN, método efetivo, valor recebido conforme o evento. Não há uma terceira linha que soma 120 e 490. Relatório gerencial pode converter para uma moeda de gestão, se a empresa definir a regra e a fonte da taxa. Essa conversão é apresentação. Ela não substitui o razão em moeda original.
O que observar antes de chamar o país de aberto?
Abertura é um critério combinado, não um deploy. O sandbox daquele país passou com o método e os dados de teste previstos. A credencial de produção é a daquela região. Um pedido real de baixo valor, ou um pedido controlado, percorreu criação, confirmação e conciliação com os identificadores certos. O financeiro conseguiu explicar moeda apresentada e moeda liquidada. O suporte tem frase pronta para “pagamento pendente” no prazo daquele método, diferente do prazo do Pix.
As métricas acompanham essa separação. Taxa de confirmação do México não entra no mesmo denominador da taxa do Brasil. Falha por documento inválido, falha por moeda com decimais indevidos e falha por método não habilitado são diagnósticos de expansão. Elas não deveriam ser lidas como “o routing piorou”. O routing só é avaliado dentro das rotas que já podiam receber a transação. O artigo de Smart Routing cobre essa avaliação. Aqui, o alerta é não misturar indisponibilidade de país com qualidade de rota.
Também faz parte da abertura saber o que ficou de fora. Se a devolução no método local tem prazo ou canal diferente, o atendimento não reutiliza o script de estorno de cartão. Se o método local confirma no dia seguinte, a entrega do serviço digital espera essa confirmação, do mesmo modo que uma operação brasileira não entrega com base na tela do comprador. O princípio é o do pilar de orquestração: a aplicação expressa a intenção; a infraestrutura e o método executam; o estado financeiro vem da evidência, não do botão.
Como o time de produto conversa com finanças e engenharia?
Produto define o mercado, a oferta e os métodos que a experiência vai prometer. Finanças define moeda de venda, expectativa de liquidação e o que entra no razão. Engenharia guarda a intenção, a tentativa e os campos que não podem se perder na adaptação. Nenhum dos três “internacionaliza” sozinho mudando o idioma do checkout.
Uma revisão útil antes do lançamento percorre um pedido de ponta a ponta em voz alta. Qual valor o comprador viu? Qual método apareceu? Qual cobrança foi criada? Qual evento confirmou? Em que moeda o valor será procurado no extrato? Se alguma resposta for “o mesmo do Brasil”, a revisão para e aponta o campo. Igualdade de plataforma não é igualdade de instrumento.
A documentação a consultar de novo na data do projeto é a matriz de capacidades e o contrato da conta, não uma memória deste artigo. Endereços estáveis na Dev Central: capacidades por provedor e, para o fluxo de saída quando ele for o escopo, payout. O pilar orquestração de pagamentos e o guia de Smart Routing seguem como leitura do mecanismo. Este texto só organiza a decisão de país que aqueles dois não tinham como objeto.
Perguntas frequentes
Orquestração para expansão é o mesmo que Smart Routing?
A orquestração coordena a intenção e os caminhos. O Smart Routing escolhe uma rota entre caminhos já permitidos. A expansão internacional é o trabalho anterior e paralelo de tornar um país real: método, moeda, documento, contrato, credencial e liquidação. Sem esse conjunto, não há rota internacional para escolher.
Um checkout único significa um contrato único?
A experiência pode ser uma só. O contrato, a credencial e a habilitação seguem o país e o provedor. A documentação consultada trata a matriz como resumo de capacidade e condiciona o uso ao perfil do comerciante. Mostrar um método no checkout espera essa confirmação.
Pix atende outro país como método local?
Na matriz pública lida em 7 de novembro de 2026, Pix aparece no Brasil. Métodos como SPEI e OXXO aparecem no México, e outros instrumentos aparecem nos países descritos naquela página. Pix continua sendo o arranjo brasileiro. Um mercado novo usa o método local habilitado para ele.
Trocar de país exige reescrever a aplicação?
A intenção do pedido, a tentativa e a confirmação podem permanecer numa camada comum. O que muda é o instrumento: moeda e escala, documento, método, prazo de confirmação e moeda de liquidação. Reescrever tudo costuma ser desnecessário. Reaproveitar o fluxo brasileiro sem esses campos costuma quebrar a conciliação.
Dá para somar vendas do Brasil e do México num número só?
Dá para apresentar um relatório gerencial se a empresa definir a moeda de gestão e a fonte da conversão. O razão da operação guarda cada pedido na moeda e no método originais. A soma sem moeda não é uma medida de venda nem de liquidação.