Skip to main content

Get Storefront Payout Fallback Settings

GET 

/api/storefront/payout-mappings/fallback-settings

Gets the fallback accounts one processor's payouts use for a store: the store's own where it set them, otherwise the global ones (null = not set).

Required scope: accounting:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

  • fallback_revenue_nominal_code_id: the account an unmapped line type posts to when it adds money (a charge with no account).
  • fallback_expense_nominal_code_id: the account an unmapped line type posts to when it takes money (fees, refunds with no account).
  • invoiced_order_payout_nominal_code_id: for an order that already has its own invoice (for example one placed before the store switched to per-payout booking), the account its payout line is credited to instead of revenue: a clearing (current asset) account. It cannot be the Accounts Receivable or Accounts Payable account (422): the payout's documents already post against those, so its deposit could not settle the line.

Every call names the processor (provider: stripe) and the store (integration_instance_id). A store sees its own rows plus the global rows every store shares; another store's rows are never reachable.

Authentication: Requires Bearer token. Open to API tokens with the accounting:read scope.

Request​

Responses​

OK

Response Headers
    Content-Type