Pular para o conteúdo
AchaduDevelopers
API operacionalIr para o site
Painel
Developers/API/receipt_reconcile
Commissions

Conciliar recebimento

Seleciona automaticamente ou recebe as comissões que formam o crédito.

POST/commissions/receipts/{id}/reconcilecommissions: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

idstring · pathIdentificador do recurso.minLength 2 · maxLength 100obrigatório
commission_idsarray · bodyIDs escolhidos manualmente; omita para conciliação automática.opcional
AuthorizationBearer ach_live_...
Acceptapplication/json
Escopocommissions:write

Exemplo executável

curl
curl -X POST 'https://achadu.com/api/v1/commissions/receipts/resource_id/reconcile' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "commission_ids": []
}'

Resposta e erros

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

200 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"
  },
  "request_id": "req_01J..."
}
200Operação concluída.
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.