Skip to main content
POST
Create Card Payment

Authorizations

Authorization
string
header
required

Chave de API gerada no dashboard da PurinCash (ps_live_ ou ps_test_).

Body

application/json
valueCents
integer
required

Valor do pagamento em centavos. Mínimo de 80 (R$ 0,80).

Required range: x >= 80
description
string
default:Pagamento Cartao

Descrição exibida no checkout do Stripe. Máximo de 200 caracteres.

Maximum string length: 200
callbackUrl
string<uri>

URL HTTPS pública para receber o webhook de confirmação do pagamento. Máximo de 500 caracteres.

Maximum string length: 500
customer
object

Dados do cliente (opcional).

metadata
string
default:{}

String JSON com dados livres. Máximo de 2048 caracteres.

Maximum string length: 2048
successUrl
string<uri>

URL de redirecionamento após o pagamento aprovado. Máximo de 500 caracteres.

Maximum string length: 500
cancelUrl
string<uri>

URL de redirecionamento se o cliente cancelar o checkout. Máximo de 500 caracteres.

Maximum string length: 500

Response

Pagamento no cartão criado com sucesso.

orderCode
string

Código único do pedido. Use-o para consultar o pagamento.

status
enum<string>

Status do pagamento. Sempre "pending" na criação.

Available options:
pending,
paid,
expired,
refunded,
failed
amountCents
integer

Valor solicitado em centavos.

currency
string

Moeda do pagamento. Sempre "BRL".

checkoutUrl
string

URL do Stripe Checkout para onde o cliente deve ser redirecionado para pagar.

expiresAt
string<date-time>

Data e hora de expiração da sessão de checkout (30 minutos após a criação).