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

🛑Approving Held Payouts

A payout in pending-approval is approved or rejected in the PayRam dashboard (Withdraw → Payouts), not through the API.

Action
What happens

Approve

A 6-digit code, valid for 10 minutes, is emailed to the approving admin’s own address. The payout shows pending-otp-verification until the code is entered. The approval takes effect only when the code is entered: the payout then moves to pending, payout.approved is sent (PayRam Core v3.9.0 and later), and the payout is sent.

Reject

The payout becomes rejected (final).

Who can approve a held payout (PayRam Core v3.9.0 and later):

  • Root and Admin — any payout, including one they created.

  • Project Admin — payouts of the projects they administer, including one they created.

  • Nobody else — creating a payout never lets you approve it. Other members get an “insufficient permissions” error, and the payout stays awaiting approval.

Approving or rejecting a payout that is no longer awaiting approval (already queued, being sent, sent, rejected or cancelled) is refused with 409 PAYOUT_NOT_AWAITING_APPROVAL and changes nothing. A wrong, expired or already-used code is refused with 400 INVALID_OTP; the payout keeps waiting for the right code (PayRam Core v3.9.0 and later).

Track the result through webhooks or GET Single Payout.

Last updated