对账单

三种查看资金变动的方式：已结束日期的对账单、当前的交易和某个期间的汇总。都使用权限范围 ex.extrato.read。

当日对账单 #

GET /v2/ex/extrato/{data}

仅适用于已结束的日期。data 是 America/Sao_Paulo 时区的会计日。

GET /v2/ex/extrato/2026-09-17
→ 200
{
  "data": "2026-09-17",
  "conciliado": false,
  "geradoEm": "2026-09-18T12:00:00.786679Z",
  "totais": {
    "creditos": "650.00",
    "debitos": "0.00",
    "emAberto": { "creditos": "0.00", "debitos": "0.00", "quantidade": 0 }
  },
  "transacoes": [
    {
      "data": "2026-09-17T13:05:00Z",
      "tipo": "DEPOSITO",
      "sentido": "CREDITO",
      "valor": "150.00",
      "referencia": "FIN02J1ZK7M9QW3ERT5TY6UI8O",
      "endToEndId": "E12345678202609181200000000000001",
      "status": "CREDITADO",
      "efetivado": true
    },
    {
      "data": "2026-09-17T13:00:00Z",
      "tipo": "DEPOSITO",
      "sentido": "CREDITO",
      "valor": "500.00",
      "referencia": "FIN01J1ZK7M9QW3ERT5TY6UI8O",
      "endToEndId": "E12345678202609181200000000000002",
      "status": "CREDITADO",
      "efetivado": true
    }
  ],
  "cursor": { "proximo": "", "temMais": false }
}

当日对账单的分页方式与列表相同：只要 cursor.temMais 为 true，就把 cursor.proximo 传入 ?cursor=。

GET /v2/ex/extrato/{data}/arquivo 以 CSV 返回同一天的数据，内容的 SHA-256 放在 trailer x-conteudo-sha256 中。带 ?formato=zip 时，返回一个 zip，里面是同一个 CSV，体积约为五分之一，trailer 仍然是该 CSV 的 SHA-256。formato 为其他值时返回 400 formato_invalido。

当前交易 #

GET /v2/ex/transacoes

时间窗口使用 RFC 3339 时间点：包含 de，不包含 ate。缺少其中一个时，该侧不设边界。存款在入账时出现；提现和退款在请求时出现，并带有当时的 status，付出后移到资金付出的时间点：请检查 efetivado。

如果只想列出某一类型或某一状态，请传入 tipo 和 situacao：每个参数都可以传多个值，用逗号分隔。不存在的值返回 400。

GET /v2/ex/transacoes?de=2026-09-18T00:00:00Z&ate=2026-09-18T23:59:59Z&limite=2
→ 200
{
  "transacoes": [
    {
      "data": "2026-09-18T12:00:03.779747Z",
      "tipo": "DEVOLUCAO",
      "sentido": "DEBITO",
      "valor": "50.00",
      "referencia": "E12345678202609181200000000000001:DEV01J1ZK7M9QW3ERT5TY6UI8O",
      "endToEndId": "E12345678202609181200000000000001",
      "status": "EM_PROCESSAMENTO",
      "efetivado": false
    },
    {
      "data": "2026-09-18T12:00:02.774316Z",
      "tipo": "SAQUE",
      "sentido": "DEBITO",
      "valor": "300.00",
      "referencia": "SAQ01J1ZK7M9QW3ERT5TY6UI8O",
      "endToEndId": "E12345678202609181200000000000003",
      "status": "EM_PROCESSAMENTO",
      "efetivado": false
    }
  ],
  "cursor": { "proximo": "MTc4OTcyMzIyMzc2NDAzMH5GSU4w...", "temMais": true }
}

要把同样的筛选结果导出为文件，请使用 GET /v2/ex/transacoes/arquivo，并传入 de 和 ate（必填，最多 31 天）、tipo 和 situacao。返回供电子表格使用的 CSV，以分号分隔，行和顺序与列表相同；传入 ?formato=zip 时，返回装有同一 CSV 的 zip。trailer x-linhas 给出返回的交易数。该文件不带 SHA-256：对账请使用已结束当日的文件。

期间汇总 #

GET /v2/ex/resumo

汇总 de 与 ate 之间已结束的日期，两者都是 AAAA-MM-DD，最长 366 天。如果 ate 包含当天，atePedido 表示请求的日期，ate 表示实际汇总到的日期。

GET /v2/ex/resumo?de=2026-08-19&ate=2026-09-18
→ 200
{
  "de": "2026-08-19",
  "ate": "2026-09-17",
  "atePedido": "2026-09-18",
  "geradoEm": "2026-09-18T12:00:00.792600Z",
  "totais": {
    "creditos": "650.00",
    "debitos": "0.00",
    "operacoesCredito": 2,
    "operacoesDebito": 0,
    "ticketMedio": "325.00"
  },
  "porDia": [
    { "dia": "2026-09-17", "creditos": "650.00", "debitos": "0.00", "operacoes": 2 }
  ],
  "porTipo": [
    { "tipo": "DEPOSITO", "creditos": "650.00", "debitos": "0.00", "operacoes": 2 }
  ]
}

没有资金变动的日期不会出现在 porDia 中。ticketMedio 等于 creditos 除以 operacoesCredito。

带 incluirHoje=true 时，汇总包含当天，截至查询时刻。响应带有 parcialAte，即当天已汇总到的时刻，ate 则为最后一个已汇总的日期。该数字在当天结束前会变化。

用任意 id 查找交易 #

GET /v2/ex/transacoes/mapear

在 ref 中传入 txid、idEnvio、endToEndId、rtrId、您的外部参考号或某项冻结的 id（与 GET /v2/ex/bloqueios 列出的相同），接口会返回在哪里找到了它。响应中的 procuradas 列表是服务器查找过的范围，其中包括内部领域。

GET /v2/ex/transacoes/mapear?ref=SAQ01J1ZK7M9QW3ERT5TY6UI8O
→ 200
{
  "ref": "SAQ01J1ZK7M9QW3ERT5TY6UI8O",
  "achados": [
    {
      "dominio": "payout",
      "campo": "id_envio",
      "id": "SAQ01J1ZK7M9QW3ERT5TY6UI8O",
      "situacao": "EM_PROCESSAMENTO",
      "valor": "300.00",
      "quando": "2026-09-18T12:00:02Z"
    }
  ],
  "procuradas": ["cobranca", "payout", "devolucao", "devolucao_recebida", "contingencia", "devolvido_pela_parceira", "venda_cartao", "boleto", "infracao", "bloqueio"],
  "naoProcuradas": []
}

错误 #