PIX, Maquininhas e Wallets: Sistema de Pagamento Para Apps de Servico

Implementar pagamentos e frequentemente o passo mais complexo no desenvolvimento de um app de servico ou marketplace. Este guia cobre as opcoes de pagamento no Brasil em 2026: PIX API, gateways de cartao, carteiras digitais e split de pagamento para marketplaces.

O ecossistema de pagamentos no Brasil em 2026

O sistema de pagamentos brasileiro e um dos mais avancados do mundo, apos as reformas promovidas pelo Banco Central entre 2015 e 2023. O PIX, lancado em novembro de 2020, e hoje o metodo de pagamento mais usado no pais — com 48 bilhoes de transacoes em 2024.

Para desenvolvedores, as opcoes sao:

PIX via API (Banco Central / PSPs parceiros): pagamento instântaneo, disponivel 24/7, sem taxa para pessoa fisica. Para empresas, taxa de 0,10-0,22% nas transacoes via parceiros.

Cartao debito/credito via gateway: gateways como Pagar.me, PagSeguro, Mercado Pago, Stripe e Adyen processam cartoes. Taxa tipica: 1,5-3% no debito e 2,5-4% no credito parcelado.

Boleto bancario: tem taxa plana de R$ 1-3,50, com pagamento em 1-3 dias uteis. Ainda relevante para pagamentos de maior valor.

Carteiras digitais (Mercado Pago, PicPay): faceis de integrar via URL de pagamento, sem necessidade de dados de cartao.

Integrando PIX dinamico: API do Pagar.me

O PIX dinamico permite gerar um QR Code especifico por transacao com valor e descricao embedded. Ao contrario do PIX estatico (chave fixa), o PIX dinamico permite reconciliar automaticamente o pagamento quando o cliente efetua a transferencia.

const PagarmeClient = require(“pagarme”);

const gerarPixDinamico = async (valor, descricao, clienteInfo) => {
const client = await PagarmeClient.connect({ api_key: process.env.PAGARME_API_KEY });

const pedido = await client.orders.create({
items: [{ description: descricao, amount: Math.round(valor * 100), quantity: 1, code: “SVC-001” }],
customer: {
name: clienteInfo.nome,
email: clienteInfo.email,
type: “individual”,
document: clienteInfo.cpf,
phones: [{ home_phone: { country_code: “55”, area_code: clienteInfo.ddd, number: clienteInfo.tel } }],
},
payments: [{
payment_method: “pix”,
pix: { expires_in: 3600 }, // expira em 1 hora
}],
});

return {
pixQrCode: pedido.charges[0].last_transaction.qr_code,
pixQrCodeUrl: pedido.charges[0].last_transaction.qr_code_url,
orderId: pedido.id,
};
};

Split de pagamento para marketplaces

Em um marketplace, o pagamento do cliente precisa ser dividido entre o prestador de servico e a plataforma (comissao). Esse processo se chama split de pagamento.

Gateways como Pagar.me, Zoop e StarkBank suportam split de pagamento nativamente: voce configura que X% vai para a conta de destino do prestador e Y% para a conta do marketplace, e o gateway processa automaticamente.

const criarPagamentoComSplit = async (valor, prestadorId, comissaoPercent) => {
const valorTotalCentavos = Math.round(valor * 100);
const comissaoPlataforma = Math.round(valorTotalCentavos * comissaoPercent);
const valorPrestador = valorTotalCentavos – comissaoPlataforma;

const result = await client.orders.create({
amount: valorTotalCentavos,
split: [
{
recipient_id: process.env.MARKETPLACE_RECIPIENT_ID,
type: “flat”,
amount: comissaoPlataforma,
options: { charge_processing_fee: true, charge_remainder_fee: true, liable: true },
},
{
recipient_id: prestadorId, // ID do prestador no gateway
type: “flat”,
amount: valorPrestador,
options: { charge_processing_fee: false, charge_remainder_fee: false, liable: false },
},
],
});

return result;
};

Pagamento em escrow (custódia)

Para marketplaces onde o pagamento so deve ser liberado apos confirmacao da entrega do servico (modelo custodia/escrow), o fluxo e:

1. Cliente paga: valor entra na conta da plataforma (nao vai para o prestador imediatamente)
2. Servico e entregue
3. Cliente confirma a entrega (ou prazo de contestacao expira)
4. Plataforma libera o pagamento para o prestador via API de transferencia

Pagar.me Recipient API e StarkBank permitem implementar esse fluxo.

Antifraude

Em marketplaces com alto volume, a fraude e uma ameaca real: cartoes clonados, identidades falsas de prestadores e criacao de transacoes falsas para lavar dinheiro.

As melhores praticas: implementar uma solucao de antifraude como Konduto ou ClearSale nos pagamentos, verificar identidade de prestadores com CPF + selfie (parceiros como Unico, idwall), limitar o volume de transacoes por conta nova, e monitorar padroes anômalos de saque.