Início rápido

Do cadastro à primeira cobrança no sandbox em quatro passos.

A API está em pré-lançamento. Os exemplos usam https://api.pay.qorvie.com, o endereço planejado; ele entra no ar com o lançamento e será confirmado no credenciamento.

1. Cadastre a plataforma

Faça o credenciamento ou chame o endpoint diretamente. A resposta traz a chave de sandbox, mostrada uma única vez.

POST /v1/credenciamento

curl -X POST https://api.pay.qorvie.com/v1/credenciamento \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "Cursos do Zé",
    "documento": "11222333000181",
    "email": "ze@exemplo.com",
    "site": "https://cursosdoze.example",
    "descricaoNegocio": "Plataforma de cursos online com vendedores independentes.",
    "volumeMensalEstimadoCentavos": 5000000
  }'

2. Crie um recebedor

POST /v1/recebedores

curl -X POST https://api.pay.qorvie.com/v1/recebedores \
  -H "Authorization: Bearer $CHAVE_TESTE" \
  -H "Content-Type: application/json" \
  -d '{ "nome": "Loja A", "documento": "12345678909" }'

3. Crie uma cobrança

POST /v1/cobrancas

curl -X POST https://api.pay.qorvie.com/v1/cobrancas \
  -H "Authorization: Bearer $CHAVE_TESTE" \
  -H "Idempotency-Key: pedido-1" \
  -H "Content-Type: application/json" \
  -d '{
    "metodo": "pix",
    "valorCentavos": 25000,
    "descricao": "Pedido 1",
    "split": [{ "recebedorId": "rc_...", "percentualBps": 9000 }]
  }'

4. Consulte

GET /v1/cobrancas/{id}

curl https://api.pay.qorvie.com/v1/cobrancas/ch_... \
  -H "Authorization: Bearer $CHAVE_TESTE"

Conceitos

Valores em centavos inteiros. R$ 250,00 é 25000.
Sandbox e produção usam chaves diferentes (psp_test_… e psp_live_…) e dados separados.
Idempotência: toda criação de cobrança exige Idempotency-Key.