PUT /api/v2/storefront/billing/payout-details
Saves the bank account Apostra uses to pay you. Payouts are made by
bank transfer in your payout currency, executed by Apostra finance — there is no
payment processor. Payout details on file are required before Apostra can
disburse accrued funds. Missing details never block activation or transacting:
media buys remain on consolidated billing (agent) and funds continue to accrue.
Direct billing is not yet configurable for normal Seller Accounts.
Organization-admin only. A child-account admin cannot create or replace a
payout destination. Parent organization admins manage a direct child Seller Account with
the REST query parameter ?targetCustomerId=<child-id>. The operation is also
available to agents as set_payout_details for the active organization.
In Plan & Billing → Payouts, a parent admin selects the organization or a
direct child Seller Account from the account dropdown. The agent operation does not expose
direct-child targeting today.
accountNumber accepts a bank account number or an IBAN. Exactly one bank
identifier is set via the bankIdentifierType + bankIdentifierValue pair.
Submitting again replaces the details on file; omitting accountNumber on a
resubmit keeps the stored account number (it is write-only and never prefilled).
Request
Parameters
Response
Returns the full updated billing configuration with masked payout details:accountNumberLast4 only. onboardingStatus
is complete once payout details are on file. The same shape is returned by
Get billing config and the
get_billing_info operation.
Errors
400 VALIDATION_ERROR— malformedaccountNumber(must be 6–34 letters/digits), abankIdentifierValuethat doesn’t match itsbankIdentifierType(e.g. a routing number that isn’t 9 digits), a lowercase or non-ISOcountryCode/currency, or a missing required field.
Related
Billing tasks
All billing operations
Get billing config
Confirm the masked details on file
Billing overview
How payouts work and why bank details are needed