Registrar recebimento

Registra um crédito recebido sem tratá-lo automaticamente como comissão.

POST/commissions/receiptscommissions:write

COMPORTAMENTO

A alteração é validada e persistida na conta da chave antes da resposta. Consulte o recurso retornado como fonte de verdade.

EFEITO

Pode alterar o recurso e emitir o evento de domínio correspondente.

REPETIÇÃO

Em falha de rede, confirme o estado do recurso antes de repetir. Refaça automaticamente apenas 429 e 5xx com backoff e jitter.

Solicitação

sourcestring · bodyFonte do pagamento.obrigatório

amountnumber · bodyValor recebido.min 0.0001obrigatório

currencystring · bodyMoeda ISO 4217.default BRLopcional

referencestring · bodyReferência externa idempotente.opcional

period_startstring · bodyInício do período.date-timeopcional

period_endstring · bodyFim do período.date-timeopcional

paid_atstring · bodyData do crédito.date-timeobrigatório

notesstring · bodyNotas internas.maxLength 2000opcional

AuthorizationBearer ach_live_...

Acceptapplication/json

Escopocommissions:write

Exemplo executável

curl

curl -X POST 'https://achadu.com/api/v1/commissions/receipts' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "source": "string",
  "amount": 10,
  "paid_at": "2026-09-01T15:00:00Z",
  "currency": "BRL",
  "reference": "string",
  "period_start": "2026-09-01T15:00:00Z"
}'

Resposta e erros

Toda resposta inclui request_id. Listas acrescentam pagination; recursos mutáveis retornam o estado persistido após a operação.

201 application/json

{
  "data": {
    "id": "com_01J...",
    "marketplace": "amazon",
    "amount": 24.73,
    "currency": "BRL",
    "status": "approved",
    "order_id": "ORDER-123",
    "occurred_at": "2026-08-31T18:20:00.000Z"
  },
  "created": true,
  "request_id": "req_01J..."
}

201Recurso criado e persistido.

400Parâmetro, corpo ou transição inválida.

401Chave ausente, inválida, expirada ou revogada.

402O plano da conta não libera esta interface.

403A chave precisa do escopo commissions:write.

404Recurso inexistente nesta conta.

409O estado atual impede esta operação.

413O corpo JSON ultrapassa 128 KB.

429A janela de 120 solicitações por minuto foi excedida.

Registrar recebimento

Solicitação

Exemplo executável

Resposta e erros

Operações relacionadas