Create Split Charge
Cria uma cobrança PIX que, ao ser paga, é dividida automaticamente entre VOCÊ (dono da chave de API) e 1 a 9 beneficiários (contas PurinCash já cadastradas). Em splits você lista SOMENTE os outros beneficiários — você não se inclui: fica com o resto (100% menos a soma) e deve obrigatoriamente ter a maior fatia. A soma das percentages deve ser menor que 100.00. A taxa do gateway sai inteira da sua parte: cada beneficiário recebe a porcentagem cheia dele sobre o valor bruto; você recebe o restante menos a taxa (se a taxa passar da sua parte, você recebe 0). Emails dos beneficiários são mascarados em todas as respostas (LGPD). Se callbackUrl for informado, um POST assinado com HMAC-SHA256 (header X-Webhook-Signature) é enviado quando o pagamento for confirmado, com payload incluindo paymentId, status “paid” e splits mascarados.
Authorizations
Chave de API gerada no dashboard da PurinCash (ps_live_ ou ps_test_).
Body
amountCents (ou amount) é obrigatório, junto com splits.
Lista somente dos OUTROS beneficiários (1 a 9). Cada recipientEmail deve ser único, de uma conta PurinCash existente e diferente da sua. A soma das percentages deve ser menor que 100.00 e a sua fatia (100 menos a soma) deve ser estritamente maior que a de cada beneficiário — caso contrário a criação é rejeitada com 400.
1 - 9 elementsValor da cobrança em centavos — inteiro entre 80 (R$ 0,80) e 500000 (R$ 5.000,00, teto para cobranças com split). Preferido; também são aceitos amount (decimal em reais) ou valueCents (alias de amountCents).
80 <= x <= 500000Valor da cobrança em reais (decimal). Alternativa a amountCents.
Descrição da cobrança (máx. 200 caracteres). Padrão "Split PIX".
200Dados do cliente (opcional).
URL HTTPS pública (máx. 500 caracteres) que recebe um POST assinado com HMAC-SHA256 (header X-Webhook-Signature) quando o pagamento é confirmado. Payload inclui paymentId, status "paid" e splits com emails mascarados.
500Response
Cobrança com split criada com sucesso. A sua fatia aparece na lista splits com isOwner true (no exemplo, o parceiro recebe 3% e você fica com 97%, menos a taxa).
Identificador único da cobrança com split (prefixo psplit_).
Status da cobrança. Sempre "pending" na criação.
pending, paid, expired, refunded, cancelled Valor da cobrança em centavos.
Moeda da cobrança (sempre BRL).
Ambiente da chave de API utilizada.
live, sandbox Dados do PIX gerado.
Divisão configurada, incluindo a sua fatia (isOwner true). Emails mascarados (LGPD).
Expiração da cobrança (30 minutos após a criação).

