Create Charge
Cria uma cobrança PIX avulsa com valor customizado, sem produto vinculado. Retorna o BR Code (copia-e-cola) e a imagem do QR code para pagamento. Se callbackUrl for informado, um webhook charge.paid assinado com HMAC-SHA256 (header X-Webhook-Signature) é enviado quando o pagamento for confirmado. Para dividir a cobrança entre contas PurinCash, use o recurso Split Charges (POST /v1/split-charges).
Authorizations
Chave de API gerada no dashboard da PurinCash (ps_live_ ou ps_test_).
Body
Valor da cobrança em centavos: número JSON INTEIRO, de 80 (R$ 0,80) a 100000000000 (R$ 1 bilhão). String, decimal ou acima do teto são recusados com 400, sem arredondamento silencioso.
80 <= x <= 100000000000Descrição da cobrança (máx. 200 caracteres). Padrão "Pagamento PIX".
200Prazo de validade da cobrança, em SEGUNDOS. De 60 (1 minuto) a 604800 (7 dias). Padrão 1800 (30 minutos). Valor fora da faixa devolve 400 em vez de cair no padrão, pra o erro mais comum (mandar minutos achando que é o campo) não passar batido.
60 <= x <= 604800URL HTTPS pública (máx. 500 caracteres) que recebe um POST com o evento charge.paid quando o pagamento é confirmado, assinado com HMAC-SHA256 no header X-Webhook-Signature.
500Dados do cliente (opcional).
String JSON livre (máx. 2048 caracteres), devolvida nas consultas e no webhook.
2048Subconta (sacc_...) que recebe o crédito no ledger quando a cobrança for paga. Não aceito junto com splits. Veja /v1/subaccounts. OMITA o campo para uma cobrança sem atribuição: string vazia devolve 400 em vez de criar a venda sem dono, porque o padrão subaccountId: cliente.saccId || "" viraria perda silenciosa de atribuição. Cobrança é PIX: paymentMethod não existe aqui e devolve 400 (para LTC, use POST /v1/payments).
Vínculo opcional com produto de fornecedor (split). O valor é dividido entre a loja e o fornecedor conforme o split configurado.
Response
Cobrança criada com sucesso.
Identificador único da cobrança (prefixo psc_).
Status da cobrança. Sempre "pending" na criação.
pending, paid, expired, refunded Valor da cobrança em centavos.
Moeda da cobrança (sempre BRL).
Ambiente da chave de API utilizada.
live, sandbox Dados do PIX gerado.
Expiração da cobrança (30 minutos após a criação).

