B2C Acquiring · API Integration

Collect Pix,
pay out BRL —
IOF only on FX

Accept Pix payments via API, then use the collected BRL to pay out directly in Brazil — influencer commissions, buyer refunds, seller incentives. Only the portion you actually convert to USD is subject to IOF. Your total collection cost drops significantly.

B2C收款 · API集成

收取Pix,
用BRL付款 —
IOF仅计换汇部分

通过API接收Pix支付,然后用收到的BRL直接在巴西付款 — 网红佣金、买家退款、卖家激励。只有实际兑换为USD的部分才需缴纳IOF。您的总收款成本大幅降低。

Cobrança B2C · Integração via API

Receba com Pix,
pague em BRL —
IOF só sobre o câmbio

Aceite pagamentos Pix via API e use o BRL recebido para fazer repasses diretamente no Brasil — comissões de influenciadores, reembolsos de compradores, incentivos a vendedores. Somente a parte que você converte para USD está sujeita ao IOF. Seu custo total de recebimento cai significativamente.

Collect + Pay收+付Receber + Pagar
Pix collection + BRL
local payout in one API
Pix收款+BRL
本地付款,一个API搞定
Cobrança Pix + repasse BRL
local em uma só API
FX only仅换汇Só câmbio
IOF charged only on
the converted portion
IOF仅对
换汇部分征收
IOF cobrado apenas sobre
a parte convertida
Independent独立账户Independente
Each merchant gets
their own account structure
每个商户拥有
独立的账户结构
Cada lojista tem
sua própria estrutura de conta
REST
Standard API
3–7 days to go live
标准API
3–7天上线
API padrão
3–7 dias para entrar em produção
POST /v1/orders/create
// Create a Pix collection order
POST /v1/orders/create
Authorization: Bearer YOUR_API_KEY
{
  "merchant_id": "merchant_abc123",
  "amount": 299.90,
  "currency": "BRL",
  "payment_method": "PIX",
  "notify_url": "https://your-site.com/webhook",
  "settlement_mode": "hold" // hold BRL for payouts or FX
}
// Response: checkout URL + QR code
{
  "order_id": "ord_9f2k3m...",
  "checkout_url": "https://pay.b2b-nexapay.com/...",
  "qr_code": "00020101021226870014..."
}
IOF Optimization LogicIOF优化逻辑Lógica de Otimização de IOF

IOF charged only on the converted portionIOF仅对换汇部分征收IOF cobrado apenas sobre a parte convertida

IOF is Brazil's mandatory cross-border FX tax, levied at 3.5%. The traditional model requires all collected BRL to be converted to USD immediately — IOF applies to the full amount. With NexaPay, your BRL balance can first be used for local BRL payouts, and only the portion actually converted to USD is subject to IOF.IOF是巴西强制性跨境外汇税,税率为3.5%。传统模式要求将所有收取的BRL立即兑换为USD — IOF适用于全额。使用NexaPay,您的BRL余额可以先用于本地BRL付款,只有实际兑换为USD的部分才需缴纳IOFIOF é o imposto brasileiro obrigatório sobre câmbio transfronteiriço, cobrado a 3,5%. O modelo tradicional exige que todo o BRL recebido seja convertido em USD imediatamente — o IOF incide sobre o valor total. Com a NexaPay, seu saldo em BRL pode primeiro ser usado para repasses locais em BRL, e somente a parte efetivamente convertida para USD está sujeita ao IOF.

Traditional eFX Model传统eFX模式Modelo eFX Tradicional
Collect BRL → Full mandatory FX conversion → IOF on 100%收取BRL → 强制全额换汇 → IOF按100%征收Receber BRL → Conversão total obrigatória → IOF sobre 100%
Pix collect 100Pix收取100Pix recebe 100 Full FX conversion全额换汇Conversão total IOF × 100 USD out
Regardless of local payout needs, all collected BRL must be converted — IOF deducted from the full amount无论本地付款需求如何,所有收取的BRL必须兑换 — IOF从全额中扣除Independente dos repasses locais, todo o BRL recebido deve ser convertido — IOF descontado do valor total
NexaPay ModelNexaPay模式Modelo NexaPay
Collect BRL → Local payouts + IOF only on FX portion收取BRL → 本地付款 + IOF仅计换汇部分Receber BRL → Repasses locais + IOF só sobre câmbio
Pix collect 100Pix收取100Pix recebe 100 BRL balanceBRL余额Saldo BRL Local payout 40本地付款40Repasse local 40 + FX convert 60 → IOF × 60换汇60 → IOF × 60Câmbio 60 → IOF × 60
40 used for BRL local payouts (no IOF); only the 60 converted to USD incurs IOF40用于BRL本地付款(无IOF);只有60兑换为USD的部分产生IOF40 usados para repasses locais em BRL (sem IOF); somente os 60 convertidos para USD incorrem em IOF
IOF Tax Base Comparison (example: collect BRL 100, 40% used for local payouts)IOF税基对比(示例:收取BRL 100,40%用于本地付款)Comparativo da Base de Cálculo do IOF (exemplo: recebe BRL 100, 40% usado para repasses locais)
Traditional model: IOF tax base传统模式:IOF税基Modelo tradicional: base IOF IOF × 100%
Full FX conversion · BRL 100全额换汇 · BRL 100Conversão total · BRL 100
NexaPay model: IOF tax baseNexaPay模式:IOF税基Modelo NexaPay: base IOF IOF × 60%
Local payouts · 40本地付款 · 40Repasses locais · 40
FX conversion · 60换汇 · 60Câmbio · 60
Local payouts (no FX needed, no IOF)本地付款(无需换汇,无IOF)Repasses locais (sem câmbio, sem IOF)
FX conversion to USD (IOF applies)换汇为USD(IOF适用)Conversão para USD (IOF incide)
−40%
IOF tax base reduced by 40%IOF税基减少40%Base de cálculo do IOF reduzida em 40%
The higher your local payout ratio, the more you save. For platforms with significant Brazil-side operating spend, total collection costs drop materially.本地付款比例越高,节省越多。对于在巴西有大量运营支出的平台,总收款成本显著下降。Quanto maior o percentual de repasses locais, mais você economiza. Para plataformas com gastos operacionais significativos no Brasil, o custo total de recebimento cai expressivamente.
Collect & Pay in One收付一体Receber & Pagar em Um Só Lugar

Collected BRL can be paid out directly收到的BRL可直接付款BRL recebido pode ser repassado diretamente

BRL balances aren't just waiting to be converted. Through API calls, you can disburse directly to Brazil-based recipients — buyers, influencers, sellers — keeping collection and payout in a local loop and reducing unnecessary FX conversions.BRL余额不只是等待兑换。通过API调用,您可以直接向巴西本地收款方付款 — 买家、网红、卖家 — 将收款和付款保持在本地循环中,减少不必要的换汇。Os saldos em BRL não ficam apenas esperando para serem convertidos. Através de chamadas de API, você pode repassar diretamente para destinatários no Brasil — compradores, influenciadores, vendedores — mantendo cobrança e repasse em circuito local e reduzindo conversões desnecessárias.

🎯
Influencer & Creator Commission Payouts网红及创作者佣金发放Comissões para Influenciadores e Criadores
Disburse BRL commissions to creators and influencers in bulk, API-triggered, automated settlement per order or campaign批量向创作者和网红发放BRL佣金,API触发,按订单或活动自动结算Repasse comissões em BRL para criadores e influenciadores em lote, disparado por API, liquidação automática por pedido ou campanha
🔄
Buyer Refunds & Cashback买家退款及返现Reembolsos e Cashback para Compradores
Refunds or platform cashback sent back to buyer accounts via Pix instantly — fully API-driven, no manual processing退款或平台返现通过Pix即时发送至买家账户 — 全API驱动,无需人工处理Reembolsos ou cashback da plataforma enviados para a conta do comprador via Pix instantaneamente — 100% via API, sem processamento manual
🏆
Seller Rewards & Platform Incentives卖家奖励及平台激励Premiações de Vendedores e Incentivos da Plataforma
Pay performance bonuses, ranking rewards, and new seller incentives — small amounts, high volume, auto-triggered by rule engine支付绩效奖金、排名奖励和新卖家激励 — 小额高频,规则引擎自动触发Pague bônus de desempenho, prêmios de ranking e incentivos para novos vendedores — valores pequenos, alto volume, disparado automaticamente por motor de regras
💳
Points & Balance Cash Redemptions积分及余额兑现金Resgate de Pontos e Saldo em Dinheiro
Redeem loyalty points or wallet balances as BRL cash, sent directly to user Pix accounts — 100% API driven将积分或钱包余额兑换为BRL现金,直接发送至用户Pix账户 — 100% API驱动Resgate pontos de fidelidade ou saldos de carteira como BRL, enviados diretamente para a conta Pix do usuário — 100% via API
Fund Flow Diagram资金流示意图Diagrama do Fluxo de Fundos
Collect → BRL Account → Flexible Distribution收款 → BRL账户 → 灵活分配Receber → Conta BRL → Distribuição Flexível
Step 01 · Collect步骤01 · 收款Etapa 01 · Receber
Pix CollectionPix收款Cobrança Pix
Buyer pays → BRL credited instantly买家付款 → BRL即时到账Comprador paga → BRL creditado imediatamente
Step 02 · Account步骤02 · 账户Etapa 02 · Conta
BRL Balance AccountBRL余额账户Conta Saldo BRL
Independent merchant account, real-time visible独立商户账户,实时可见Conta independente por lojista, visível em tempo real
Distribute as needed按需分配Distribua conforme necessário
Use A用途AUso A
Local Payout本地付款Repasse Local
BRL disbursement
Refunds/commissions
No IOF
BRL发放
退款/佣金
无IOF
Repasse BRL
Reembolsos/comissões
Sem IOF
Use B用途BUso B
FX Withdrawal换汇提现Saque via Câmbio
Convert to USD
IOF on this
portion only
兑换为USD
IOF仅对
此部分征收
Converter para USD
IOF apenas sobre
esta parte
Key: Only Use B (FX conversion) incurs IOF at 3.5%. Use A (BRL local disbursements: refunds, commissions, incentives) requires no FX conversion and generates no IOF. The higher your local payout ratio, the lower your total IOF cost.关键点:只有用途B(换汇)需缴纳3.5%的IOF。用途A(BRL本地发放:退款、佣金、激励)无需换汇,不产生IOF。本地付款比例越高,总IOF成本越低。Ponto-chave: Somente o Uso B (conversão de câmbio) incorre em IOF de 3,5%. O Uso A (repasses locais em BRL: reembolsos, comissões, incentivos) não requer conversão e não gera IOF. Quanto maior o percentual de repasses locais, menor o custo total de IOF.
Settlement Modes结算模式Modos de Liquidação

Two settlement modes, configured per merchant两种结算模式,按商户独立配置Dois modos de liquidação, configurados por lojista

Each merchant's settlement mode is independently configured — for platform clients, different merchants can use different modes without affecting each other.每个商户的结算模式独立配置 — 对于平台客户,不同商户可使用不同模式,互不影响。O modo de liquidação de cada lojista é configurado de forma independente — para clientes de plataforma, diferentes lojistas podem usar modos diferentes sem interferir entre si.

Mode A模式AModo A
Hold BRL + Flexible Distribution保留BRL + 灵活分配Manter BRL + Distribuição Flexível
Active fund management主动资金管理Gestão ativa de fundos

Pix collections credit directly to the merchant's BRL wallet. The merchant decides: which portion to use for BRL local disbursements (refunds, commissions, incentives — no IOF), and which to convert to USD when the rate is favorable. Switch between uses anytime.Pix收款直接记入商户的BRL钱包。商户决定:哪部分用于BRL本地发放(退款、佣金、激励 — 无IOF),哪部分在汇率有利时兑换为USD。随时切换用途。Pix collections credit directly to the merchant's BRL wallet. The merchant decides: which portion to use for BRL local disbursements (refunds, commissions, incentives — no IOF), and which to convert to USD when the rate is favorable. Switch between uses anytime.

Pix creditedPix到账Pix creditadoHold BRL保留BRLManter BRLLocal payout / FX on demand本地付款/按需换汇Repasse local / câmbio sob demanda
Mode B模式BModo B
Real-time FX Conversion实时换汇Conversão de Câmbio em Tempo Real
Prioritize speed of USD receipt优先USD到账速度Priorizar velocidade de recebimento em USD

If the merchant prioritizes USD cash flow speed and doesn't need BRL local payouts, enable real-time conversion: every Pix collection is instantly converted at the mid-market rate and credited as USD. Switch between modes anytime in the dashboard.如果商户优先考虑USD现金流速度且不需要BRL本地付款,可启用实时转换:每笔Pix收款即时按中间价兑换并记为USD。随时在控制台中切换模式。Se o lojista prioriza a velocidade do fluxo de caixa em USD e não precisa de repasses locais em BRL, ative a conversão em tempo real: cada cobrança Pix é instantaneamente convertida pela taxa média e creditada como USD. Alterne entre modos a qualquer momento no painel.

Pix creditedPix到账Pix creditadoInstant FX即时换汇Câmbio instantâneoUSD credited immediatelyUSD即时到账USD creditado imediatamente
Merchant Account Structure商户账户结构Estrutura de Conta por Lojista

Each merchant gets their own account space每个商户拥有独立的账户空间Cada lojista tem seu próprio espaço de conta

Each integrated merchant has independent BRL + USD dual wallets — funds are isolated, reconciliation is clean, and merchants can check their own balances and transaction history in real time without going through the platform.每个接入的商户拥有独立的BRL+USD双钱包 — 资金隔离,对账清晰,商户可实时查看自己的余额和交易记录,无需通过平台。Cada lojista integrado tem carteiras duais independentes BRL + USD — fundos isolados, conciliação limpa, e os lojistas podem verificar seus próprios saldos e histórico de transações em tempo real sem passar pela plataforma.

🔒
Isolated funds资金隔离Fundos isolados
Each merchant account is independent — no shared pool, no commingling risk between merchants每个商户账户独立 — 无共享资金池,无商户间资金混合风险Cada conta de lojista é independente — sem pool compartilhada, sem risco de mistura entre lojistas
📊
Real-time balance visibility实时余额可见Visibilidade de saldo em tempo real
Every collection, payout, and FX transaction syncs in real time — merchants check their own dashboard anytime每笔收款、付款和换汇交易实时同步 — 商户随时查看自己的控制台Cada cobrança, repasse e transação de câmbio sincroniza em tempo real — lojistas consultam seu próprio painel a qualquer hora
⚙️
Independent settlement configuration独立结算配置Configuração de liquidação independente
When a platform integrates multiple merchants, each merchant's settlement mode is configured independently — no cross-interference当平台接入多个商户时,每个商户的结算模式独立配置 — 互不干扰Quando uma plataforma integra múltiplos lojistas, o modo de liquidação de cada lojista é configurado independentemente — sem interferência cruzada
🔑
Account accessible only by the holder仅持有人可访问Conta acessível apenas pelo titular
Each account is bound to the applying merchant — only the account holder can view details and initiate fund movements每个账户绑定申请商户 — 仅账户持有人可查看详情和发起资金操作Cada conta está vinculada ao lojista solicitante — somente o titular pode visualizar detalhes e iniciar movimentações de fundos
Account Structure Diagram账户结构示意图Diagrama da Estrutura de Contas
Platform Layer平台层Camada de Plataforma
NexaPay Acquiring PlatformNexaPay收单平台Plataforma de Cobrança NexaPay
API routing · Pix collection · ClearingAPI路由 · Pix收款 · 清算Roteamento API · Cobrança Pix · Compensação
Independent Account Structure独立账户结构Estrutura de Conta Independente
Merchant A商户ALojista A
BRL Wallet
+ USD Wallet
Merchant B商户BLojista B
BRL Wallet
+ USD Wallet
Merchant C商户CLojista C
BRL Wallet
+ USD Wallet
Each merchant independently decides: BRL local disbursement (refunds/commissions/incentives, no IOF) or FX withdrawal to offshore bank account (IOF on converted portion only)每个商户独立决定:BRL本地发放(退款/佣金/激励,无IOF)或换汇提现至境外银行账户(IOF仅对换汇部分)Cada lojista decide de forma independente: repasse local em BRL (reembolsos/comissões/incentivos, sem IOF) ou saque via câmbio para conta bancária offshore (IOF apenas sobre a parte convertida)
API SpecificationsAPI规格Especificações da API

Standard REST, go live in 3–7 days标准REST,3–7天上线REST padrão, produção em 3–7 dias

UAT and production environments provided. Fully simulate the payment flow in the test environment without affecting production data. A dedicated account manager supports integration throughout.提供UAT和生产环境。在测试环境中完全模拟支付流程,不影响生产数据。专属客户经理全程支持对接。Ambientes UAT e produção disponíveis. Simule completamente o fluxo de pagamento no ambiente de teste sem afetar dados de produção. Um gerente de conta dedicado apoia a integração do início ao fim.

REST API + HMAC-SHA256 request signingREST API + HMAC-SHA256请求签名API REST + assinatura HMAC-SHA256
Every request carries a signature for secure communication. Code examples available in Java, Python, and PHP每个请求携带签名确保安全通信。提供Java、Python和PHP代码示例Cada requisição carrega uma assinatura para comunicação segura. Exemplos de código disponíveis em Java, Python e PHP
Webhook push + active polling — both supportedWebhook推送 + 主动轮询 — 两种方式均支持Push por Webhook + polling ativo — ambos suportados
Payment success triggers a push to your notify_url (retries up to 3 times by default); merchants can also poll order status actively during the order's validity window支付成功触发推送至notify_url(默认重试3次);商户也可在订单有效期内主动轮询订单状态O sucesso do pagamento aciona um push para seu notify_url (até 3 tentativas por padrão); os lojistas também podem consultar o status do pedido ativamente durante a janela de validade
UAT + production dual environmentsUAT + 生产双环境Ambientes dual UAT + produção
Test environment fully simulates collection and payout flows; production API key provided securely by your account manager测试环境完全模拟收款和付款流程;生产API密钥由客户经理安全提供Ambiente de teste simula completamente os fluxos de cobrança e repasse; chave de API de produção fornecida com segurança pelo seu gerente de conta
Hosted checkout + native QR code — both modes托管收银台 + 原生二维码 — 两种模式Checkout hospedado + QR code nativo — ambos os modos
Redirect buyers to NexaPay's hosted checkout, or retrieve the raw QR code string to embed in your own interface将买家重定向至NexaPay托管收银台,或获取原始二维码字符串嵌入您自己的界面Redirect buyers to NexaPay's hosted checkout, or retrieve the raw QR code string to embed in your own interface
Webhook Callback Example
// NexaPay → merchant notify_url (POST)
{
  "event": "payment.success",
  "order_id": "ord_9f2k3m...",
  "merchant_id": "merchant_abc123",
  "amount": 299.90,
  "currency": "BRL",
  "status": "SUCCESS",
  "brl_balance_after": 1580.40,
  "paid_at": "2026-05-04T14:22:11Z",
  "signature": "HMAC-SHA256(secret_key, ...)"
}
// HTTP 200 = acknowledged; unacknowledged requests are retried
📋 Full API documentation完整API文档Documentação completa da API is available on our existing developer portal, including all endpoint specs, signing algorithm examples, and error code reference. UAT API key provided by your account manager after KYB approval.可在我们的开发者门户获取,包括所有端点规范、签名算法示例和错误码参考。UAT API密钥由客户经理在KYB审批后提供。disponível no nosso portal de desenvolvedores, incluindo todas as especificações de endpoints, exemplos do algoritmo de assinatura e referência de códigos de erro. Chave de API UAT fornecida pelo seu gerente de conta após aprovação do KYB.
Integration Process接入流程Processo de Integração

3 steps, live in as fast as 3 business days3步完成,最快3个工作日上线3 etapas, produção em até 3 dias úteis

Fully online KYB — no in-person meetings. Approved same day at fastest, T+2 maximum. Your account manager is with you throughout.KYB全程线上 — 无需线下会议。最快当天审批,最长T+2。客户经理全程陪伴。KYB 100% online — sem reuniões presenciais. Aprovação no mesmo dia no mínimo, D+2 no máximo. Seu gerente de conta acompanha todo o processo.

Step 01步骤01Etapa 01
Register & KYB Verification注册及KYB验证Cadastro & Verificação KYB

Register on the NexaPay website and submit your company details, director/UBO proof, and offshore bank account info online. Supports HK, China mainland, and Singapore-registered entities.在NexaPay网站注册并在线提交公司资料、董事/UBO证明和境外银行账户信息。支持香港、中国大陆和新加坡注册实体。Cadastre-se no site da NexaPay e envie os dados da empresa, comprovante de sócio/representante legal e informações da conta bancária offshore online. Suporta entidades registradas em Hong Kong, China continental e Singapura.

Online — typically within 1 day线上 — 通常1天内Online — geralmente em até 1 dia
Step 02步骤02Etapa 02
Get API Key & Complete Integration获取API密钥并完成对接Obter Chave API & Concluir Integração

After KYB approval, your account manager provides UAT and production API keys. Complete endpoint integration and confirm Webhook callbacks are working — typically 2–5 days.KYB审批后,客户经理提供UAT和生产API密钥。完成端点对接并确认Webhook回调正常 — 通常2–5天。Após aprovação do KYB, seu gerente de conta fornece as chaves de API UAT e produção. Conclua a integração dos endpoints e confirme que os callbacks Webhook estão funcionando — geralmente 2–5 dias.

2–5 days to complete2–5天完成2–5 dias para concluir
Step 03步骤03Etapa 03
Switch to Production & Go Live切换生产环境并上线Migrar para Produção & Entrar no Ar

Switch to the production environment to start accepting real Pix payments and sending BRL payouts (refunds, commissions, incentives) or converting to USD on demand.切换至生产环境,开始接收真实Pix支付并发送BRL付款(退款、佣金、激励)或按需兑换为USD。Migre para o ambiente de produção para começar a aceitar pagamentos Pix reais e enviar repasses em BRL (reembolsos, comissões, incentivos) ou converter para USD sob demanda.

Instant activation即时激活Ativação imediata

Ready to integrate
Pix Collect & Pay?
准备好接入
Pix收付API了吗?
Pronto para integrar
Pix Receber & Pagar?

No minimum volume requirements, no upfront deposit. Submit KYB documents and go live in 3–7 days. Collection, payouts, and FX — all in one API.无最低交易量要求,无需预存。提交KYB文档,3–7天上线。收款、付款和换汇 — 一个API搞定。Sem requisito de volume mínimo, sem depósito inicial. Envie os documentos KYB e entre em produção em 3–7 dias. Cobrança, repasses e câmbio — tudo em uma só API.

技术问题/方案咨询:微信 17717330195 Technical questions / solution consultation: contact@b2b-nexapay.com