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 (inteiro maior ou igual a 80, ou seja, R$ 0,80).
x >= 80Descrição da cobrança (máx. 200 caracteres). Padrão "Pagamento PIX".
200URL 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.
2048Ví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).

