recibo de registro

Registra un crédito recibido sin tratarlo automáticamente como una comisión.

POST/commissions/receiptscommissions:write

COMPORTAMIENTO

El cambio se valida y persiste en la cuenta clave antes de responder. Consulta el recurso devuelto como fuente de verdad.

EFECTO

Puede cambiar el recurso y emitir el evento de dominio correspondiente.

REPETICIÓN

En caso de falla de la red, confirme el estado del recurso antes de volver a intentarlo. Rehaga automáticamente solo 429 y 5xx con retroceso y fluctuación.

Solicitar

sourcestring · bodyFuente de pago.obligatorio

amountnumber · bodyCantidad recibida.min 0.0001obligatorio

currencystring · bodyMoneda ISO 4217.default BRLopcional

referencestring · bodyReferencia externa idempotente.opcional

period_startstring · bodyInicio del período.date-timeopcional

period_endstring · bodyFin del periodo.date-timeopcional

paid_atstring · bodyFecha de crédito.date-timeobligatorio

notesstring · bodyNotas internas.maxLength 2000opcional

AuthorizationBearer ach_live_...

Acceptapplication/json

Alcancecommissions:write

Ejemplo ejecutable

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"
}'

Respuesta y errores

Cada respuesta incluye request_id. Las listas añaden paginación; Los recursos mutables devuelven el estado persistente después de la operación.

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 creado y persistido.

400Parámetro, cuerpo o transición no válidos.

401Clave faltante, inválida, caducada o revocada.

402El plan de cuenta no libera esta interfaz.

403A chave precisa do escopo commissions:write.

404La característica no existe en esta cuenta.

409El estado actual impide esta operación.

413El cuerpo JSON supera los 128 KB.

429Se ha superado la ventana de 120 solicitudes por minuto.

recibo de registro

Solicitar

Ejemplo ejecutable

Respuesta y errores

Operaciones relacionadas