# PurinCash

> Documentação da API PurinCash. Cobranças PIX, cartão, assinaturas, splits, saques e webhooks, com sandbox gratuito.

## Docs

- [Create Subscription](https://docs.purincash.com/api-reference/assinaturas/create-subscription.md): Cria uma assinatura recorrente via PIX vinculada a um produto ativo e retorna o código PIX (brCode) da primeira cobrança. Funciona também no modo sandbox (chaves ps_test_), com dados simulados.
- [List Subscriptions](https://docs.purincash.com/api-reference/assinaturas/list-subscriptions.md): Retorna a lista de assinaturas do ambiente da chave utilizada, ordenadas da mais recente para a mais antiga, com paginação por limit/offset e filtro opcional por status.
- [Create Card Payment](https://docs.purincash.com/api-reference/cartao/create-card-payment.md): Cria um pagamento no cartão de crédito via Stripe Checkout e retorna a checkoutUrl para redirecionar o cliente. A sessão de checkout expira em 30 minutos. Não disponível no modo sandbox (chaves ps_test_).
- [Get Card Payment](https://docs.purincash.com/api-reference/cartao/get-card-payment.md): Consulta os detalhes de um pagamento no cartão pelo orderCode retornado na criação. Não disponível no modo sandbox (chaves ps_test_).
- [List Card Payments](https://docs.purincash.com/api-reference/cartao/list-card-payments.md): Retorna a lista de pagamentos no cartão, ordenados do mais recente para o mais antigo, com paginação por limit/offset e filtro opcional por status. No modo sandbox (chaves ps_test_) a lista retorna vazia.
- [Get Wallet](https://docs.purincash.com/api-reference/carteira/get-wallet.md): Retorna o saldo da carteira da loja. O campo withdrawable é o saldo sacável agora (balance - disputeBlocked): o valor retido por disputas (MED) abertas ou perdidas não perdoadas é descontado do saldo bruto, e é esse o limite máximo aceito pelo POST /v1/payouts. Funciona com chaves ps_live_ e ps_test…
- [Create Charge](https://docs.purincash.com/api-reference/cobrancas/create-charge.md): 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 confirma…
- [Get Charge](https://docs.purincash.com/api-reference/cobrancas/get-charge.md): Consulta os detalhes de uma cobrança avulsa pelo paymentId, incluindo status, cliente, metadata e datas. Use para confirmar o pagamento (polling) como alternativa ao webhook do callbackUrl. Cobranças com split (prefixo psplit_) retornam o formato descrito em GET /v1/split-charges/{paymentId}.
- [Get Dispute](https://docs.purincash.com/api-reference/disputas/get-dispute.md): Consulta os detalhes de uma disputa pelo ID, incluindo as evidências já enviadas (com URLs assinadas regeneradas a cada consulta). No sandbox retorna sempre 404.
- [List Disputes](https://docs.purincash.com/api-reference/disputas/list-disputes.md): Lista as disputas (MED — Mecanismo Especial de Devolução) da loja, das mais recentes para as mais antigas. Enquanto uma disputa estiver aberta ou perdida (não perdoada), o valor contestado fica retido do saldo sacável (campo disputeBlocked do GET /v1/wallet). No sandbox retorna lista vazia com "sand…
- [Submit Dispute Evidence](https://docs.purincash.com/api-reference/disputas/submit-dispute-evidence.md): Envia evidência de defesa para uma disputa aberta. A disputa precisa estar com status "aberta" e ter ID no gateway (wooviDisputeId). Informe documents (até 10 URLs http/https) e/ou textForPdf (texto convertido automaticamente em PDF de defesa, hospedado em URL assinada com expiração). Não disponível…
- [Get Delivery](https://docs.purincash.com/api-reference/entregas/get-delivery.md): Consulta o status de entrega de um pagamento e retorna o conteúdo entregue, se disponível. Aceita IDs de pagamento (prefixo psa_) e de cobrança (prefixo psc_). O campo deliveredContent é null se o pagamento estiver pendente ou se o produto tiver entrega manual.
- [Referência da API](https://docs.purincash.com/api-reference/introducao.md): 29 endpoints, um formato de erro, uma autenticação. Com playground pra testar aqui mesmo.
- [List Store Products](https://docs.purincash.com/api-reference/loja/list-store-products.md): Lista os produtos da loja do Discord, com categoria, variações e estoque. É uma rota de leitura: para criar ou editar produtos da loja, use o painel.
- [Create Payment](https://docs.purincash.com/api-reference/pagamentos/create-payment.md): Cria um pagamento e retorna os dados para o cliente pagar. Suporta PIX (padrão) e LTC (Litecoin) via `paymentMethod`. Envie `productId` (o preço vem do produto) ou `valueCents` (valor avulso em centavos); se ambos forem enviados, o preço do produto prevalece. Pagamentos LTC não estão disponíveis no…
- [Get Payment](https://docs.purincash.com/api-reference/pagamentos/get-payment.md): Consulta os detalhes de um pagamento pelo paymentId, incluindo status, método de pagamento, cliente, metadata e datas. Use para confirmar o pagamento (polling) como alternativa ao webhook do callbackUrl.
- [List Payments](https://docs.purincash.com/api-reference/pagamentos/list-payments.md): Retorna a lista de pagamentos com paginação e filtros por status e tipo, ordenada da mais recente para a mais antiga.
- [Create Product](https://docs.purincash.com/api-reference/produtos/create-product.md): Cria um produto para ser referenciado em pagamentos e assinaturas. Limite de 500 produtos por conta por ambiente.
- [Delete Product](https://docs.purincash.com/api-reference/produtos/delete-product.md): Exclui permanentemente um produto pelo seu ID.
- [Get Product](https://docs.purincash.com/api-reference/produtos/get-product.md): Obtém os detalhes de um único produto pelo seu ID.
- [List Products](https://docs.purincash.com/api-reference/produtos/list-products.md): Retorna a lista de produtos criados, ordenada da mais recente para a mais antiga. Por padrão, apenas produtos ativos são retornados.
- [Update Product](https://docs.purincash.com/api-reference/produtos/update-product.md): Atualiza um produto existente. Todos os campos são opcionais — apenas os campos enviados são alterados.
- [Sandbox Transactions](https://docs.purincash.com/api-reference/sandbox/sandbox-transactions.md): Lista as transações do ambiente de teste (pagamentos e cobranças avulsas), das mais recentes para as mais antigas. Requer chave ps_test_ (retorna 403 com chave ps_live_).
- [Sandbox Wallet](https://docs.purincash.com/api-reference/sandbox/sandbox-wallet.md): Retorna o saldo simulado do ambiente de teste, calculado a partir dos pagamentos e cobranças de teste — os pagos somam em available e os pendentes em pending. Requer chave ps_test_ (retorna 403 com chave ps_live_).
- [Simulate Charge Paid](https://docs.purincash.com/api-reference/sandbox/simulate-charge-paid.md): Simula a confirmação de uma cobrança avulsa no ambiente de teste. Requer chave ps_test_ (retorna 403 com chave ps_live_). Marca a cobrança como "paid" e, se a cobrança tiver callbackUrl, dispara o webhook payment.paid com "sandbox": true. Cobranças já pagas apenas retornam o estado atual.
- [Simulate Payment Paid](https://docs.purincash.com/api-reference/sandbox/simulate-payment-paid.md): Simula a confirmação de um pagamento no ambiente de teste. Requer chave ps_test_ (retorna 403 com chave ps_live_). Marca o pagamento como "paid" e, se o pagamento tiver callbackUrl, dispara o webhook payment.paid com "sandbox": true. Pagamentos já pagos apenas retornam o estado atual.
- [Create Payout](https://docs.purincash.com/api-reference/saques/create-payout.md): Solicita um saque PIX ou LTC do saldo disponível. O débito do saldo é atômico. O valor máximo sacável é o campo withdrawable do GET /v1/wallet (balance - disputeBlocked): o saldo retido por disputas (MED) abertas ou perdidas não perdoadas não é sacável, e pedidos acima desse valor são rejeitados com…
- [List Payouts](https://docs.purincash.com/api-reference/saques/list-payouts.md): Lista os saques solicitados pela loja, do mais recente para o mais antigo. O campo walletAddress é sempre mascarado (6 primeiros caracteres + ***). No sandbox retorna lista vazia.
- [Create Split Charge](https://docs.purincash.com/api-reference/splits/create-split-charge.md): 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…
- [Get Split Charge](https://docs.purincash.com/api-reference/splits/get-split-charge.md): Consulta o status de uma cobrança com split pelo paymentId (prefixo psplit_). Após o pagamento, retorna a taxa do gateway, o valor líquido e o quanto cada beneficiário recebeu (amountCents) com a data do crédito (creditedAt). Emails dos beneficiários são mascarados (LGPD).
- [Ambientes e sandbox](https://docs.purincash.com/guias/ambientes.md): Como testar o fluxo inteiro, inclusive webhook, sem mover um centavo.
- [Assinaturas](https://docs.purincash.com/guias/assinaturas.md): PIX recorrente amarrado a um produto, com a cobrança sendo gerada sozinha.
- [Autenticação](https://docs.purincash.com/guias/autenticacao.md): Uma chave, um header. Como pegar, como guardar e o que fazer quando vaza.
- [Receber por cartão](https://docs.purincash.com/guias/cartao.md): Checkout hospedado: você redireciona, a gente cobra e devolve o resultado.
- [Carteira](https://docs.purincash.com/guias/carteira.md): Saldo bruto, retido, a liberar e sacável. Quatro números que não são a mesma coisa.
- [Receber em Litecoin](https://docs.purincash.com/guias/cripto.md): Mesmo endpoint do PIX, um campo a mais. E três diferenças que mudam o seu fluxo.
- [Disputas](https://docs.purincash.com/guias/disputas.md): O cliente contestou o PIX. O que fica retido, o que você manda e em quanto tempo.
- [Entrega automática](https://docs.purincash.com/guias/entrega.md): Como buscar a chave, a conta ou o link que o comprador recebeu.
- [Erros](https://docs.purincash.com/guias/erros.md): Um formato só, sete códigos, e quais deles vale reenviar.
- [Limites de requisição](https://docs.purincash.com/guias/limites.md): 120 por minuto no geral, 10 por hora em saque. E como não bater neles.
- [Receber por PIX](https://docs.purincash.com/guias/pix.md): Os dois endpoints de PIX, quando usar cada um e como reconciliar sem passar vergonha.
- [Sua primeira cobrança](https://docs.purincash.com/guias/primeira-cobranca.md): Do zero ao PIX pago em sandbox, sem mover dinheiro de verdade.
- [Antes de ir pra produção](https://docs.purincash.com/guias/producao.md): A lista curta do que costuma quebrar no primeiro dia com dinheiro de verdade.
- [Produtos](https://docs.purincash.com/guias/produtos.md): Existem dois tipos de produto com o mesmo nome. Aqui está qual é qual.
- [Saques](https://docs.purincash.com/guias/saques.md): Tirar o saldo por PIX, LTC ou USDT sem sair do código. Inclui o turbo, que é irreversível.
- [Dividir o valor (split)](https://docs.purincash.com/guias/splits.md): Marketplace, comissão e sociedade resolvidos no instante em que o dinheiro entra.
- [Documentação PurinCash](https://docs.purincash.com/index.md): Como integrar pagamentos PIX, cartão, cripto e assinatura na PurinCash: referência da API, webhooks e um sandbox pra testar o fluxo inteiro sem mover dinheiro.
- [Validando a assinatura](https://docs.purincash.com/webhooks/assinatura.md): Sem isso, qualquer pessoa na internet consegue dizer que pagou.
- [card_payment.paid](https://docs.purincash.com/webhooks/cartao.md): Mesma ideia do PIX, dois campos com nome diferente. É onde o handler genérico quebra.
- [payment.paid e charge.paid](https://docs.purincash.com/webhooks/pagamentos.md): O evento que confirma que o PIX caiu, com os dados que só o banco tem.
- [order.paid](https://docs.purincash.com/webhooks/pedidos.md): Para quem vende pelo bot no Discord e quer sincronizar estoque ou CRM.
- [withdrawal.*](https://docs.purincash.com/webhooks/saques.md): Solicitado, pago ou negado. Os três momentos em que o seu saldo muda de lado.
- [Como funcionam os webhooks](https://docs.purincash.com/webhooks/visao-geral.md): Quem avisa quem, o que a sua URL precisa ter e o que acontece quando ela cai.

## OpenAPI Specs

- [openapi](https://docs.purincash.com/api-reference/openapi.yaml)

## Optional

- [Dashboard](https://purincash.com/dashboard/api)
- [Suporte no Discord](https://discord.gg/8eyQQFZZxY)
- [llms.txt](https://docs.purincash.com/llms-full.txt)