Checkout hospedado

A forma mais simples de cobrar: você cria um link, o comprador paga numa página nossa (Pix ou cartão) e volta para o seu site. Nenhum dado de cartão passa por você.

Como funciona

1. Seu servidor cria o link com a chave secreta.
2. Você envia o comprador para a url devolvida.
3. O comprador paga. A página confirma o Pix sozinha, sem recarregar.
4. O comprador volta para a sua urlSucesso. Confirme o pagamento no servidor antes de liberar o produto.

Criar o link

curl -X POST https://api.pay.qorvie.com/v1/checkouts \
  -H "Authorization: Bearer $CHAVE_SECRETA" \
  -H "Content-Type: application/json" \
  -d '{
    "valorCentavos": 12000,
    "descricao": "Curso de fotografia",
    "metodos": ["pix", "cartao"],
    "parcelasMax": 3,
    "referencia": "pedido-1001",
    "urlSucesso": "https://sualoja.example/obrigado?checkout={CHECKOUT_ID}",
    "urlCancelamento": "https://sualoja.example/carrinho",
    "split": [{ "recebedorId": "rc_...", "percentualBps": 9000 }]
  }'

{
  "id": "cks_...",
  "url": "https://checkout.pay.qorvie.com/c/cks_...",
  "situacao": "aberto",
  "valorCentavos": 12000,
  "expiraEm": "2026-10-17T11:45:55Z",
  ...
}

• {CHECKOUT_ID} na urlSucesso vira o id do link, para você achar o pedido.
• O link vale 24 horas por padrão. Use expiraEmSegundos (de 5 minutos a 7 dias) para mudar.
• Em produção, as URLs de retorno precisam ser https.
• O split é validado na criação: recebedor inexistente ou sem KYC aprovado impede o link.
• Se já souber os dados do comprador, envie cliente (nome, documento, e-mail) e a página não pergunta de novo.

Situações do link

Consulte com GET /v1/checkouts/{id}: quando situacao for pago, o objeto traz a cobranca com o id para conciliar. Cancele um link não pago com POST /v1/checkouts/{id}/cancelar.

Regras do pagamento

• Cada link tem no máximo um pagamento em andamento ou concluído, então abrir a página duas vezes não cobra duas vezes.
• Cartão recusado deixa o comprador tentar de novo, até 5 tentativas por link. Depois disso, gere outro link.
• Com um Pix aguardando pagamento, a página não permite trocar para cartão até o Pix expirar. É uma limitação desta versão.
• A página não pode ser embutida em outros sites (proteção contra clickjacking).

Sandbox

Com chave de teste, a página mostra um aviso, aceita os cartões de teste e tem um botão para simular o pagamento do Pix. Veja os cartões em SDK de cartão.

Os links são criados também pelo painel, em Links de pagamento.