Pagamentos internacionais: venda global, receba em reais

O HeroPay funciona como gateway de pagamento internacional dentro do mesmo link de pagamento que você já usa no Brasil: o comprador de fora vê o checkout no idioma e na moeda dele, paga com cartão Visa ou Mastercard emitido no exterior, e você recebe em reais na sua conta HeroPay, sem operação separada, sem conta no exterior e sem abrir empresa fora. Para ativar, basta enviar enable_international_sales: true ao criar um link avulso pela API. A taxa vigente na documentação é 7,9% + R$ 1 por transação internacional aprovada, sem mensalidade.

Criar conta sandbox · Ler a documentação

O que é um gateway de pagamento internacional (e por que não é a mesma coisa que "receber do exterior")?

Quase tudo que aparece quando você busca "receber pagamento do exterior" fala de transferência: alguém lá fora te manda dinheiro por SWIFT, Wise, Payoneer, Remessa Online ou PayPal, e você converte para reais. Isso resolve salário de freelancer e fatura de cliente que já fechou negócio com você.

Um gateway de pagamento internacional resolve outro problema: vender para quem ainda não é seu cliente. O comprador em Lisboa, Miami ou Buenos Aires chega na sua página, clica em comprar e precisa ver um checkout que ele entende, na moeda dele, aceitando o cartão que ele tem na carteira. Sem isso, ele abandona.

O HeroPay mora na segunda linha: venda em moeda estrangeira com liquidação local, via checkout.

Como funciona o pagamento internacional no HeroPay?

Do ponto de vista do dinheiro, são quatro passos:

1. Você cria o link em reais. Um link avulso de R$ 497 com enable_international_sales: true. O preço de referência é sempre em BRL, em centavos (49700).
2. O checkout se adapta ao comprador. Quando alguém de fora abre o link, o checkout identifica a região e configura idioma e moeda locais. O comprador em Portugal vê euros; o do México, pesos.
3. O comprador paga com cartão internacional. Visa ou Mastercard emitido fora do Brasil. A conversão da moeda dele para reais é feita no momento do checkout.
4. Você recebe em reais. O valor configurado no link entra no saldo da sua conta HeroPay em BRL, descontada a taxa internacional. Daí em diante é igual a qualquer venda: aparece no saldo, nos relatórios e sai por saque Pix.

A venda internacional entra primeiro no seu saldo a receber e passa a disponível no prazo de liberação da sua conta. Acompanhe os dois em GET /financial/balance e no painel.

Na prática, por código

Criar um link com venda internacional

O mesmo endpoint de sempre (referência), com um campo a mais:

curl -X POST "$HEROPAY_API_URL/payment_links" \
  -H "Authorization: Bearer $HEROPAY_JWT_TOKEN" \
  -H "Accept: application/vnd.herospark.com; version=1" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_link": {
      "name": "Curso de Fotografia Mobile",
      "description": "Acesso vitalício, 42 aulas",
      "price_cents": 49700,
      "absorbs_fees": true,
      "max_installments": 1,
      "payment_methods": ["credit_card", "pix"],
      "enable_international_sales": true,
      "src": "campanha-portugal"
    }
  }'

Resposta 201 Created:

{
  "message": "Payment link created successfully",
  "data": {
    "id": 214,
    "name": "Curso de Fotografia Mobile",
    "description": "Acesso vitalício, 42 aulas",
    "price_cents": 49700,
    "absorbs_fees": true,
    "max_installments": 1,
    "period": "unitary",
    "frequency_type": "unlimited",
    "frequency_limit": null,
    "overdue_type": "none",
    "overdue_limit": null,
    "public_id": "8b1f3c2a-5d4e-4f6a-9c7b-2e1d0a9f8b7c",
    "offer": {
      "id": 6211,
      "kind": "payment_link",
      "url": "https://pay.beta.herospark.com/8b1f3c2a-5d4e-4f6a-9c7b-2e1d0a9f8b7c-6211?src=campanha-portugal",
      "accepted_payment_methods": ["credit_card", "pix"]
    },
    "created_at": "2026-09-23T11:20:14.512-03:00",
    "updated_at": "2026-09-23T11:20:14.512-03:00"
  }
}

O comprador brasileiro que abre esse link vê o checkout normal, com Pix e cartão; o comprador de fora vê a versão internacional, no idioma e na moeda dele, pagando com cartão. Um link só, sem variação por país. O src volta em cart.src em todo webhook, então você sabe quanto a campanha de Portugal vendeu.

Detalhes que valem ouro:

• enable_international_sales é opcional e o padrão é false. Sem ele, o link é só doméstico.
• price_cents é sempre o valor em reais, em centavos. Você não informa preço em dólar ou euro: a conversão é do checkout.
• O mínimo do link é R$ 5,00 (500).
• No exemplo usamos max_installments: 1, venda à vista no cartão, que é o cenário mais simples para o comprador de fora.

A limitação que você precisa conhecer: recorrência

Pagamento internacional não se aplica a links recorrentes. Se você mandar period (monthly, quarterly, semiannual ou annual) junto com enable_international_sales: true, a API não devolve erro: o link é criado como assinatura doméstica comum e a venda internacional fica desligada (docs).

{
  "payment_link": {
    "name": "Plano Pro mensal",
    "price_cents": 9700,
    "absorbs_fees": true,
    "period": "monthly",
    "enable_international_sales": true
  }
}

Esse corpo cria uma assinatura mensal que só aceita compradores com meios de pagamento brasileiros. Não conte com o internacional aqui. Se você tem SaaS com cliente recorrente lá fora, leia a seção Quando abrir uma empresa fora compensa.

Confirmar a venda pelo webhook

Venda internacional confirma pelo mesmo evento de qualquer venda: spark_payment_confirmed. Confie no evento, não no polling.

curl -X POST "$HEROPAY_API_URL/webhook" \
  -H "Authorization: Bearer $HEROPAY_JWT_TOKEN" \
  -H "Accept: application/vnd.herospark.com; version=1" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook": {
      "trigger": "spark_payment_confirmed",
      "webhook_url": "https://seuapp.com/webhooks/heropay",
      "request_method": "post"
    }
  }'

O evento chega assinado com HMAC SHA-256 no header X-HeroPay-Signature, com os blocos buyer, payment, offer, cart e payment_methods de sempre (validação passo a passo em /webhooks). O registro de pagamento traz os campos currency_price_cents e international_quotation, que vêm null em venda doméstica.

Por prompt

Cole https://heropay.tech/llms.txt na conversa com Claude, ChatGPT, Cursor, Lovable e outros, e a ferramenta passa a conhecer a API do HeroPay a partir das docs abertas. Aí você pede em português:

Com base em https://heropay.tech/llms.txt, escreva o código que cria um link de pagamento avulso de R$ 497 para o "Curso de Fotografia Mobile", só cartão à vista, com venda internacional ligada e src "campanha-portugal", e cadastra um webhook de pagamento confirmado para https://seuapp.com/webhooks/heropay.

O código gerado usa POST /payment_links com enable_international_sales: true e POST /webhook com o gatilho certo. Se você pedir "assinatura mensal internacional", uma boa resposta deve avisar que o recurso não vale para recorrência, porque as docs abertas dizem isso. A chave de API fica no seu ambiente, nunca colada no chat. Um MCP server oficial está em desenvolvimento; até lá, llms.txt, docs e API REST são o caminho que funciona hoje. Mais em /ai.

Quanto custa vender para fora do Brasil?

A taxa vigente na documentação do HeroPay para cartão internacional é 7,9% + R$ 1 por transação aprovada. Recusa não paga. A tabela nova do site pode revisar esse número: a referência oficial é sempre /precos.

HeroPay vs Stripe no cartão internacional

Venda de R$ 1.000 para um comprador com cartão estrangeiro:

Verificado em setembro/2026 nas páginas oficiais.

Leitura honesta da tabela: se você aceita cobrar o estrangeiro em reais, o Stripe é mais barato em percentual. Mas cobrar em reais de quem pensa em dólar ou euro custa conversão: o comprador vê uma moeda que não conhece, o banco dele aplica IOF e spread do lado de lá, e a desconfiança derruba a compra. Quando você quer mostrar a moeda do comprador, as duas opções ficam praticamente empatadas (R$ 80,00 contra a partir de R$ 80,29), e o HeroPay entrega junto o checkout de conversão, o Pix a R$ 0 para o comprador brasileiro no mesmo link e o dinheiro já em reais. Em ticket baixo, repare na parte fixa: R$ 1 no HeroPay contra R$ 0,39 no Stripe. Comparativo completo em Stripe vs HeroPay.

Sobre o câmbio: a conversão é feita no checkout e você recebe em reais o valor que configurou no link.

Quando abrir uma empresa fora compensa mais?

Abrir uma entidade nos Estados Unidos é o caminho clássico de quem quer faturar em dólar. O Stripe Atlas, por exemplo, abre uma C Corp ou LLC em Delaware por US$ 500 de taxa única e US$ 100 por ano de agente registrado a partir do segundo ano (stripe.com/atlas, verificado em setembro/2026). Por cima disso entram custos que o Atlas não elimina: relatório anual e imposto de franquia de Delaware, contador nos EUA, declarações americanas e, do lado brasileiro, a obrigação de declarar a participação e o dinheiro mantido fora.

Regra prática: se o internacional ainda é teste de mercado, ligar um campo no link é mais barato que manter uma empresa. Quando o exterior vira o negócio principal, a conta muda, e a decisão é do seu contador e do seu advogado, não de uma tabela de taxa.

Casos de uso

Infoprodutor com público brasileiro no exterior. Um curso de R$ 497 divulgado para a comunidade brasileira em Portugal e nos EUA. Com o link internacional, o comprador em Lisboa paga em euros com o cartão europeu dele. Taxa: 7,9% de R$ 497 (R$ 39,26) + R$ 1 = R$ 40,26. Você recebe R$ 456,74 em reais. O mesmo link, aberto em São Paulo, oferece Pix a R$ 0.

Venda de template ou produto digital para a América Latina. Um pacote de templates de R$ 270 vendido em comunidades de design do México e da Argentina. O checkout aparece em espanhol e na moeda local. Taxa: R$ 21,33 + R$ 1 = R$ 22,33 por venda; você recebe R$ 247,67. Dez vendas no mês somam R$ 2.476,70 líquidos, sem abrir conta em lugar nenhum.

Mentoria ou consultoria avulsa para cliente de fora. Uma sessão de R$ 1.500 vendida para um cliente em Miami. Em vez de mandar dados bancários e esperar uma transferência SWIFT, você manda o link. Taxa: R$ 118,50 + R$ 1 = R$ 119,50; você recebe R$ 1.380,50, com confirmação por webhook e o comprovante no relatório de transações.

Multimoeda no checkout: o que o comprador vê

O link internacional abre o checkout HeroPay adaptado ao comprador:

• Idioma do checkout traduzido automaticamente para o da região.
• Moeda local exibida e processada, entre até 134 moedas suportadas.
• Cartão internacional Visa ou Mastercard.
• Um link para todos os países: você não mantém uma versão por mercado.

Antes de divulgar para outro país, abra o link no sandbox e confira a experiência completa que o comprador de fora vai ver.

Impostos e câmbio: o que muda quando a venda vem de fora?

O HeroPay resolve a cobrança e entrega o dinheiro em reais. O que essa receita significa para o seu imposto é outra conversa, e esta página não é aconselhamento fiscal. Em linhas gerais, os pontos que você vai levar ao contador são:

• ISS na exportação de serviço. A lei do ISS (LC 116/2003) prevê que o imposto não incide sobre exportação de serviços, mas faz exceção quando o resultado do serviço se verifica no Brasil. Para produto digital consumido lá fora, a interpretação é discutida.
• PIS e COFINS. Receitas de exportação têm regra própria de imunidade, que precisa ser confirmada para o seu caso.
• Câmbio e contabilidade. Receita que nasce em moeda estrangeira tem tratamento contábil próprio, e o seu regime (MEI, Simples, Lucro Presumido) define o que incide.
• Nota fiscal. Venda para estrangeiro também gera obrigação de emissão, com particularidades.

Para se aprofundar antes de falar com o contador, o Guia fiscal do infoprodutor da HeroSpark tem uma seção inteira sobre venda internacional, com as fontes legais linkadas. Monte a estrutura fiscal antes da primeira venda em dólar, não depois.

Limites e regras honestas

• Só link avulso. Com period, o internacional é ignorado sem erro. Assinatura internacional não existe no HeroPay hoje.
• Só cartão para o comprador de fora. Pix e boleto são meios brasileiros; o estrangeiro paga com Visa ou Mastercard internacional.
• Preço sempre em reais. Você não define preço fixo em dólar ou euro; o valor na moeda do comprador é a conversão do seu preço em BRL no momento do checkout, então pode variar de um dia para o outro.
• Você recebe em reais, não em dólar. Se o seu objetivo é manter caixa em moeda forte, o HeroPay não é a ferramenta.
• Mínimo de R$ 5 por link. Para ticket baixo internacional, faça a conta antes: o R$ 1 fixo pesa mais.
• Não substitui estrutura fiscal. A receita de fora tem regras próprias de imposto e câmbio; leve ao contador.
• Não é conta global. Sem IBAN, sem conta em dólar, sem receber transferências de terceiros: o HeroPay recebe vendas feitas no seu checkout.

Venda para fora hoje, com o link que você já tem

Um campo na API, um link para todos os países, dinheiro em reais.

Criar conta sandbox · Ler a documentação

Continue por aqui: Preços · Link de pagamento · Checkout · Assinaturas · Webhooks · Stripe vs HeroPay · Desenvolvedores · Glossário: câmbio · Glossário: chargeback