Create Payment
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 sandbox. Se callbackUrl for informado, um webhook payment.paid assinado com HMAC-SHA256 (header X-Webhook-Signature) é enviado quando o pagamento for confirmado.
Authorizations
Chave de API gerada no dashboard da PurinCash (ps_live_ ou ps_test_).
Body
Envie productId ou valueCents — um dos dois é obrigatório.
ID (ObjectId) de um produto ativo. O valor do pagamento vem do preço do produto. Obrigatório se valueCents não for enviado. Produtos em moeda diferente de BRL são convertidos automaticamente para BRL na cobrança.
Valor em centavos (inteiro maior ou igual a 80, ou seja, R$ 0,80). Obrigatório se productId não for enviado.
x >= 80Método de pagamento. "pix" (padrão) gera um BR Code PIX; "ltc" gera um endereço Litecoin com o valor convertido pela cotação atual. LTC não está disponível no modo sandbox.
pix, ltc Descrição do pagamento (máx. 200 caracteres). Usada como nome do pagamento quando não há productId. Padrão "Pagamento".
200URL HTTPS pública (máx. 500 caracteres) que recebe um POST com o evento payment.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, e o conteúdo é entregue automaticamente após o pagamento.
Response
Pagamento criado com sucesso. A resposta PIX traz o objeto pix (BR Code); a resposta LTC traz o objeto ltc (endereço e valor em Litecoin).
- Pagamento PIX
- Pagamento LTC
Resposta quando paymentMethod é "pix" (padrão).
Identificador único do pagamento (prefixo psa_).
Status do pagamento. Sempre "pending" na criação.
pending, paid, expired, refunded Tipo do pagamento ("one_time" para pagamentos avulsos).
one_time, subscription Método de pagamento utilizado.
pix Valor cobrado em centavos (BRL).
Moeda do produto (padrão BRL). A cobrança PIX é sempre em BRL.
Nome do produto vinculado ou a descrição enviada.
Ambiente da chave de API utilizada.
live, sandbox Dados do PIX gerado.
Expiração do pagamento (30 minutos após a criação).

