Docs
Acessar painel

Repasses

Listar repasses feitos pela Koku

GEThttps://api.kokupay.com/v1/payouts/by-koku

Lista os repasses que a Koku fez para a sua conta bancária sem pedido de saque, conforme o contrato, com a referência da transferência. Cada repasse já foi descontado do saldo disponível. Os saques que você pede pelo painel aparecem no extrato (payout.reserved e payout.paid) e nos eventos payout.*.

GET/v1/payouts/by-koku
curl -X GET 'https://api.kokupay.com/v1/payouts/by-koku' \
  -H "Authorization: Bearer $KOKU_API_KEY"
200Resposta
{
  "items": [
    {
      "id": "4b8f2c6e-1a9d-4e37-8c05-6f3a9d2e7b14",
      "amount_cents": "10670",
      "external_reference": "E98765432202610081000Zx9Yw8Vu7Ts",
      "paid_at": "2026-10-08T10:00:00.000Z"
    }
  ]
}

Autenticação

Authorization: Bearer <sua chave de API>

Escopo exigido: payouts:read. Veja Chaves de API.

Resposta 200

itemslista de objetos

Repasses feitos pela Koku, do mais recente para o mais antigo.

items[].idstring

Identificador do repasse.

items[].amount_centsstring

Valor repassado, em centavos.

items[].external_referencestring

Referência da transferência (por exemplo, o identificador fim a fim do Pix).

items[].paid_atstring

Data da transferência.

Erros

StatusCódigoQuando
401unauthorizedChave ausente, inválida, revogada ou expirada.
403forbiddenA chave não tem o escopo exigido (details.reason = "missing_scope").
429rate_limitedLimite de requisições excedido. Aguarde o tempo de Retry-After.
500internal_errorFalha inesperada. Repita com a mesma Idempotency-Key; persistindo, envie o correlation_id à Koku (veja Suporte).

Formato do corpo de erro em Erros.