For the complete documentation index, see llms.txt. This page is also available as Markdown.

Payouts

The Payouts API enables Aquanow's clients to send funds from a source account to a pre-approved customer beneficiary crypto wallet. The API supports the complete payout lifecycle, including payout creation, authorization, status tracking, and retrieval of payout records for operational and reconciliation purposes.

Payouts follow a two-step workflow. A payout request is first created and returned in a PENDING_AUTHORIZATION state. Once authorized, the platform deducts the source currency from the sending account, performs the required currency conversion and initiates a blockchain transaction to send crypto to the beneficiary. Clients can monitor payout progress and retrieve payout details throughout the lifecycle using the available GET endpoints.

The Payouts service is designed for organizations that need to distribute funds to customers, partners, vendors, or other beneficiaries using supported digital asset networks. Typical use cases include customer withdrawals, affiliate payments, treasury disbursements, partner settlements, and other outbound payment workflows.

By separating payout creation from payout authorization, the service supports operational controls and approval processes that help reduce the risk of unauthorized transfers. The authorization step also validates account buying power and supports idempotent processing through the X-Request-Id header, preventing duplicate payout execution during retries.

Once a payout is authorized, CAMS manages the processing workflow, including fee calculation (when applicable), currency conversion, blockchain transaction execution, and status tracking. Clients can retrieve payout records, monitor processing status, reconcile completed transfers, and investigate failed transactions using the Payouts API.

The service provides a consistent operational model for managing outbound payments while maintaining auditability, control, and visibility across the payout lifecycle.

Last updated