Confirm funding from the actual authoritative ledger journal

POST/affiliate-controls/usages/{id}/confirmation

Only the executing service confirms. Reads the saved idempotency key from the authoritative ledger and verifies source service, kind, source reference, gross debit and exact destination credit. Already confirmed results replay without authorizing another post.

Path parameters

idstringRequired

Headers

Idempotency-KeystringOptional

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Returns

200 OK

actorstringRequired

created_atstring · date-timeRequired

funding_source_sha256stringOptional

funding_source_snapshotobjectOptional

idstringRequired

journal_idstringOptional

Example jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm

monitor_idstringOptional

plan_idstringRequired

policy_idstringRequired

registry_idsarray of stringsRequired

requestobjectRequired

11 child attributes

amountintegerRequired

currency_codestringRequired

destination_amountintegerRequired

Net borrower credit; affiliate scope currently requires this equal gross Amount

destination_ledger_account_idstringRequired

Example lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm

journal_keystringRequired

journal_kindstringRequired

journal_source_refstringRequired

source_ledger_account_idstringRequired

Example lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm

terms_sha256stringRequired

transaction_refstringRequired

use_refstringRequired

reservation_idstringRequired

statusstringRequired

Authorized or committed; unknown posting keeps authorization and capacity

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503