Clientes

Veja quem pagou e quanto.

Listar

Clientes não são um cadastro à parte: a lista é montada a partir das cobranças, agrupando por CPF ou CNPJ do pagador. Só entram cobranças com documento conhecido, informado em customer.document ou identificado no pagamento.

Campo	Significado
`document`	CPF ou CNPJ.
`name`	Nome.
`email`	E-mail, se informado.
`charges`	Quantidade de cobranças.
`paid`	Quantidade de cobranças pagas.
`total`	Soma paga, em centavos.
`last`	Data da cobrança mais recente.

curl "https://api.sacipix.com/v1/customers?q=ana" \
  -H "Authorization: Bearer $GATEWAY_API_KEY"

Resposta

{
  "data": [
    {
      "document": "12345678901",
      "name": "Ana Souza",
      "email": "ana@example.com",
      "charges": 4,
      "paid": 3,
      "total": 45000,
      "last": "2026-11-01 15:04:05.000+00"
    }
  ],
  "page": 1
}