Ambiente
Base URLhttps://api.sancopay.com/api/v1
Arquivo para IA
Cobranças Pix

Listar cobranças

Lista as cobranças da conta, da mais recente para a mais antiga, com filtros e paginação.

GET/charges

Lista paginada de cobranças.

Query

CampoTipoDescrição
statusopcionalstringpending, paid, failed, refunded ou expired.
referenceopcionalstringA sua reference (valor exato).
tracking_idopcionalstringCódigo de rastreio do Pix (valor exato).
idopcionalintegerId da cobrança.
date_fromopcionalstringData inicial (YYYY-MM-DD).
date_toopcionalstringData final (YYYY-MM-DD).
qopcionalstringBusca livre.
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/charges?status=paid&date_from=2026-11-01&per_page=50" \  -H "Authorization: Bearer <TOKEN>"
Resposta200 OK
{  "data": [    {      "id": 4821,      "tracking_id": "c62abd1d-9092-4892-b163-cef2951912ad",      "reference": "PED-123",      "status": "paid",      "amount": 150,      "fee": 1.5,      "message": "Pedido #123",      "customer": {        "name": "Maria Souza",        "email": "[email protected]",        "tax_id": "12345678909"      },      "pix": {        "copy_paste": "00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7a8b-9c0d-e1f2a3b4c5d65204000053039865406150.005802BR5913LOJA EXEMPLO6009SAO PAULO62070503***6304A1B2"      },      "end_to_end_id": "E18236120202611091504s0a1b2c3d4e",      "metadata": {        "order_id": "123",        "coupon": "OFF10"      },      "failure_reason": null,      "created_at": "2026-11-09T15:04:05.000000Z",      "updated_at": "2026-11-09T15:04:41.000000Z"    }  ],  "meta": {    "page": 1,    "per_page": 20,    "total": 1,    "last_page": 1  }}

Exportar em CSV

GET/charges/export

Exporta as cobranças em CSV.

Aceita os mesmos filtros da lista. A coluna Referencia traz a reference de cada cobrança.