Introduction

WelcomeServices map

Guides

AcceptSpend

Legal

SecurityPrivacyTerms

PreviousConnectNextRecycle
BlogPrivacyTerms

Withdraw seller balance

Transfer seller balance to the connected Stripe account when payouts are enabled.


Same flow over HTTP: Connect off-ramp

Tool

rill_withdraw

Call after rill_connect action=sync shows the seller is onboarded. This Transfers seller balance (including open-rail Accept credits) to Stripe Express. Auto payout also runs when Connect is ready and balance meets the minimum. Prefer rill_recycle when the owner wants ledger earnings back into the account wallet without a Stripe payout.

Auth

Seller key required. Connect must already report payouts_enabled.

Parameters

ParameterTypeRequiredDescription
amountnumberyesUSD amount to withdraw
seller_keystringnoOverrides the session seller key
idempotency_keystringnoSafe retries; auto-generated when omitted

Usage notes

  • connect_required / connect_incomplete means finish KYC with rill_connect first.
  • Check balance with rill_balance and seller_key before withdrawing.
  • Same flow over HTTP: POST /sellers/me/withdraw.