Ambiente
Base URLhttps://api.sancopay.com/api/v1
Arquivo para IA
Pré-aprovação

Consultar

Lista as pré-aprovações da conta (use para achar os ids pendentes de aprovação) e consulta uma pelo id.

GET/pre-approvals

Lista paginada de pré-aprovações.

Query

CampoTipoDescrição
statusopcionalstringpending, approved, rejected ou failed.
pageopcionalintegerPágina, a partir de 1.
per_pageopcionalintegerItens por página, de 1 a 100 (padrão 20).
Requisição
curl -X GET "https://api.sancopay.com/api/v1/pre-approvals?status=pending" \  -H "Authorization: Bearer <TOKEN>"
Resposta200 OK
{  "data": [    {      "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"    }  ],  "meta": {    "page": 1,    "per_page": 20,    "total": 1,    "last_page": 1  }}

Consultar uma pré-aprovação

GET/pre-approvals/{id}

Consulta uma pré-aprovação pelo id.

Parâmetros da URL

CampoTipoDescrição
idobrigatóriointegerId da pré-aprovação.
Requisição
curl -X GET "https://api.sancopay.com/api/v1/pre-approvals/58" \  -H "Authorization: Bearer <TOKEN>"
Resposta
{  "id": 58,  "reference": "PA-2026-0001",  "status": "approved",  "amount": 500,  "fee": 1,  "total": 501,  "pix": {    "type": "cpf",    "key": "12345678909"  },  "recipient": {    "tax_id": "12345678909"  },  "tracking_id": "5d2c8e1a-7b3f-4c9d-a6e0-1f2b3c4d5e6f",  "approved_at": "2026-11-09T15:04:41.000000Z",  "created_at": "2026-11-09T15:04:05.000000Z"}