Integration Flow

Payout Integration Flow
  1. (Optional) Check balancePOST /partner/{service_id}/balance: returns the current account balance.

  2. Create payoutPOST /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).

    OK and PROCESSING statuses are non-final — the System will send a webhook with the final result.

    The request is idempotent by id. A repeated request with the same id returns the existing payout with its current status, which may include final statuses: PAID, NOT_PAID, or ERROR.

  3. Asynchronous processing. The System sends the payout to the payment system in the background.

  4. 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.

  5. (Optional) Check statusPOST /partner/{service_id}/check.

    If the webhook was not received (e.g., network issue), the Partner can poll for the current status.