Zarejestruj paragon

Rejestruje otrzymany kredyt bez automatycznego traktowania go jako prowizji.

POST/commissions/receiptscommissions:write

ZACHOWANIE

Zmiana zostanie zweryfikowana i utrwalona na koncie kluczowym przed udzieleniem odpowiedzi. Zapytaj zwrócony zasób jako źródło prawdy.

EFEKT

Może zmienić zasób i wyemitować odpowiednie zdarzenie domeny.

POWTÓRKA

W przypadku awarii sieci potwierdź stan zasobu przed ponowną próbą. Automatycznie ponawiaj tylko 429 i 5xx z cofaniem i jitterem.

Żądanie

sourcestring · bodyŹródło płatności.obowiązkowe

amountnumber · bodyOtrzymana kwota.min 0.0001obowiązkowe

currencystring · bodyWaluta ISO 4217.default BRLopcjonalne

referencestring · bodyIdempotentne odniesienie zewnętrzne.opcjonalne

period_startstring · bodyPoczątek okresu.date-timeopcjonalne

period_endstring · bodyKoniec okresu.date-timeopcjonalne

paid_atstring · bodyData kredytu.date-timeobowiązkowe

notesstring · bodyNotatki wewnętrzne.maxLength 2000opcjonalne

AuthorizationBearer ach_live_...

Acceptapplication/json

Zakrescommissions:write

Przykład wykonywalny

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

Odpowiedź i błędy

Każda odpowiedź zawiera request_id. Listy dodają paginację; zasoby modyfikowalne zwracają utrwalony stan po operacji.

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

201Zasób został utworzony i utrwalony.

400Nieprawidłowy parametr, treść lub przejście.

401Brakujący, nieprawidłowy, wygasły lub unieważniony klucz.

402Plan konta nie udostępnia tego interfejsu.

403A chave precisa do escopo commissions:write.

404Funkcja nie istnieje na tym koncie.

409Obecny stan uniemożliwia tę operację.

413Treść JSON przekracza 128 KB.

429Przekroczono okno 120 żądań na minutę.

Zarejestruj paragon

Żądanie

Przykład wykonywalny

Odpowiedź i błędy

Powiązane operacje