Recebimentos

GET/v1/payments

Os recebimentos (créditos pagos pelas adquirentes) do cliente, criados ou alterados a partir de uma data, em páginas numeradas. Funciona igual às vendas: mesmos parâmetros de página e mesmas regras.

Autenticação: Authorization: Bearer <access_token> e X-Company-Token: <company_token>.

Parâmetros de consulta

Parâmetro	Tipo	Padrão	Descrição
updated_since	data e hora ISO 8601		Recebimentos criados ou alterados a partir deste instante (inclusive). Sem ele, vêm todos os recebimentos dos últimos 90 dias e os futuros. Não pode estar mais de 5 minutos no futuro.
page	inteiro	1	Número da página, de 1 a 10000.
page_size	inteiro	500	Itens por página, de 1 a 1000.
acquirer	string		Só uma adquirente: REDE, STONE, PAGBANK ou CIELO.
merchant_code	string		Só um estabelecimento. Até 60 caracteres.
date_from	data YYYY-MM-DD	90 dias atrás	Recebimentos com payment_date a partir deste dia. Não pode ser anterior a 90 dias atrás.
date_to	data YYYY-MM-DD		Recebimentos com payment_date até este dia. Não pode ser anterior a 90 dias atrás.

:::info Últimos 90 dias A API entrega só vendas e recebimentos com data de até 90 dias atrás (no horário de Brasília). Recebimentos com crédito previsto para o futuro aparecem normalmente. date_from ou date_to antes desse limite dão 400. :::

:::tip Todos os recebimentos de um dia Sem updated_since e com date_from e date_to, vêm todos os recebimentos creditados no período. Veja Consultar um dia ou período. :::

curl "$BASE_URL/v1/payments?updated_since=2026-10-01T00:00:00Z&page=1&page_size=1000" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "X-Company-Token: $COMPANY_TOKEN"

Resposta 200

{
  "message": "Recebimentos",
  "result": true,
  "data": {
    "items": [
      {
        "id": "51877",
        "acquirer": "REDE",
        "merchant_code": "12345678",
        "payment_id": "202610020000123",
        "payment_date": "2026-10-02",
        "status": "PAID",
        "type": "CREDIT",
        "type_negotiation": null,
        "brand_code": "1",
        "bank_code": "341",
        "bank_branch": "1234",
        "bank_account": "567890",
        "net_amount": "4820.370000",
        "settlement_code": null,
        "updated_at": "2026-10-02T09:41:27.106533Z"
      }
    ],
    "page": 1,
    "page_size": 1000,
    "has_more": false,
    "next_updated_since": "2026-10-21T15:42:10.000Z"
  },
  "error": null
}

page, page_size, has_more e next_updated_since funcionam como nas vendas.

Recebimento

Campo	Tipo	Descrição
id	string	Identificador do recebimento no Concilia+. Estável. Use para deduplicar.
acquirer	string	Adquirente: REDE, STONE, PAGBANK ou CIELO.
merchant_code	string	Código do estabelecimento na adquirente.
payment_id	string	Identificador do pagamento na adquirente.
payment_date	string YYYY-MM-DD	Data do crédito.
status	string	Situação, por exemplo PAID, PENDING ou SUSPENDED.
type	string ou null	Tipo do lançamento, por exemplo CREDIT.
type_negotiation	string ou null	Preenchido quando o recebível foi negociado ou cedido (antecipação, cessão). Nesse caso o dinheiro pode ter ido para outra conta.
brand_code	string ou null	Código da bandeira.
bank_code	string ou null	Código do banco do domicílio.
bank_branch	string ou null	Agência.
bank_account	string ou null	Conta.
net_amount	string decimal	Valor líquido creditado, em reais.
settlement_code	string ou null	Código da liquidação (saque) que pagou o recebimento, quando a adquirente informa (PagBank).
updated_at	string ISO 8601	Última alteração do recebimento no Concilia+ (UTC, com microssegundos).

Comportamento importante

As mesmas regras das vendas:

• Um recebimento alterado (por exemplo, de PENDING para PAID) volta a aparecer: faça upsert pelo id.
• Pode haver repetição, dentro da rodada e nos 30 segundos de sobreposição entre rodadas; nenhum recebimento é pulado.
• Nada é apagado.
• Vendas e recebimentos têm rodadas separadas. Guarde um updated_since para cada feed de cada cliente.

Erros

Código	Quando
400	Parâmetros inválidos, como no feed de vendas.
401	Token de acesso ou company_token ausente, vencido, revogado ou inválido.
429	Limite por minuto excedido.