Integration Flow
-
(Optional) Check balance —
POST /partner/{service_id}/balance: returns the current account balance. -
Create payout —
POST /partner/{service_id}/payout.The System validates the request, authorizes the operation, and returns an initial status:
OK— payout accepted for processing (non-final).PROCESSING— status not yet determined (non-final).ERROR— payout rejected, see<error>element (final).
OKandPROCESSINGstatuses are non-final — the System will send a webhook with the final result.The request is idempotent by
id. A repeated request with the sameidreturns the existing payout with its current status, which may include final statuses:PAID,NOT_PAID, orERROR. -
Asynchronous processing. The System sends the payout to the payment system in the background.
-
Webhook notification. When the transaction reaches a final status, the System sends a POST request to the Partner's webhook URL. See Webhooks for details.
-
(Optional) Check status —
POST /partner/{service_id}/check.If the webhook was not received (e.g., network issue), the Partner can poll for the current status.