Como funciona
1
Você cria a cobrança com split
O campo
split entra no mesmo POST /transactions da cobrança normal.2
O pagador paga o Pix
O valor da venda não muda para ele.
3
A NyxPag credita cada recebedor
Na aprovação, o valor de cada recebedor entra no saldo disponível dele, na hora.
4
Você recebe o líquido
A comissão sai do seu líquido, ao lado da tarifa da NyxPag. O que sobra é o
netAmount.O recebedor precisa ter conta na NyxPag. Quem não tem conta não recebe split.
Criando uma cobrança com split
Cada item desplit tem um recebedor e um modo de cálculo: amount (valor fixo em reais) ou percent (percentual sobre o valor da venda). Nunca os dois no mesmo item.
Campos de cada item
Resposta
A transação volta comsplitAmount (total descontado) e split (uma linha por recebedor). O netAmount já sai descontado do split.
Os valores são ilustrativos: a tarifa (
fee) depende da sua conta. A conta do exemplo seria: R$ 100,00 − R$ 0,50 de tarifa − R$ 15,00 de split = R$ 84,50 de líquido. Em split, origin: "api" são os recebedores que você enviou. Contas ligadas a uma parceria da NyxPag também podem ter uma linha origin: "partner", aplicada automaticamente.Limites
Erros
coverFee e split
ComcoverFee: false (padrão), a tarifa e o split saem do seu líquido, como no exemplo acima. Com coverFee: true, o valor do Pix gerado fica maior que o amount enviado.
Quando o recebedor vê o dinheiro
O crédito acontece quando a cobrança é aprovada, e vai para o saldo disponível do recebedor, sem reserva. Se a cobrança expirar ou falhar, ninguém é creditado. O crédito é idempotente: um webhook repetido não credita duas vezes.Receber por Pix
Todos os campos da cobrança e como apresentar o QR Code.
Criar cobrança Pix
Referência completa do endpoint.

