Criar
Cria a pré-aprovação e tenta reservar o valor mais a taxa na carteira.
POST
/pre-approvalsCria uma pré-aprovação de saque.
Corpo da requisição
| Campo | Tipo | Descrição |
|---|---|---|
amountobrigatório | number | Valor em reais. Mínimo 1.00. |
referencecondicional | string | Identificador do seu sistema; garante uma pré-aprovação por pedido.Obrigatório quando não houver o header Idempotency-Key. |
pixobrigatório | object | Chave Pix de destino. |
pix.typeobrigatório | string | cpf, cnpj, email, phone ou random. |
pix.keyobrigatório | string | A chave, no formato do tipo. |
recipientopcional | object | Dados do titular da chave. |
recipient.tax_idcondicional | string | CPF ou CNPJ do titular. Fica guardado e é reenviado na aprovação.Obrigatório quando a sua conta exige, exceto se pix.type for cpf ou cnpj. |
curl -X POST "https://api.sancopay.com/api/v1/pre-approvals" \ -H "Authorization: Bearer <TOKEN>" \ -H "Content-Type: application/json" \ -d '{ "amount": 500, "reference": "PA-2026-0001", "pix": { "type": "cpf", "key": "12345678909" }, "recipient": { "tax_id": "12345678909" } }'{ "id": 58, "reference": "PA-2026-0001", "status": "pending", "amount": 500, "fee": 1, "total": 501, "pix": { "type": "cpf", "key": "12345678909" }, "recipient": { "tax_id": "12345678909" }, "tracking_id": null, "approved_at": null, "created_at": "2026-11-09T15:04:05.000000Z"}Com o header Idempotency-Key
Sem reference no corpo, o header faz o mesmo papel.
curl -X POST "https://api.sancopay.com/api/v1/pre-approvals" \ -H "Authorization: Bearer <TOKEN>" \ -H "Idempotency-Key: pa-2026-0001" \ -H "Content-Type: application/json" \ -d '{ "amount": 500, "pix": { "type": "cpf", "key": "12345678909" } }'