For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL. To search these docs, send a GET request to https://paddle-docs-retrieval.kapa-paddle.workers.dev/?q=<question> with a URL-encoded question. No authentication needed.

Skip to content
Paddle Docs home

Payout account isn't set

You haven't set a payout account for your account, so transactions can't be processed.

Example response
{
  "error": {
    "type": "request_error",
    "code": "transaction_payout_account_required",
    "detail": "A payout account is required to process transactions, you may need to check with Paddle Support that the Paddle onboarding process has completed.",
    "documentation_url": "https://developer.paddle.com/errors/transactions/transaction_payout_account_required"
  },
  "meta": {
    "request_id": "00000000-0000-0000-0000-000000000000"
  }
}

Details

Status code
400
Error code
transaction_payout_account_required
Error message
A payout account is required to process transactions, you may need to check with Paddle Support that the Paddle onboarding process has completed.

Common causes

  • No payout account has been set for this account. A payout account is required to process transactions.

Troubleshooting

  • Set a payout account in your Paddle dashboard.
  • If you've completed onboarding but still see this, contact the Paddle support team to confirm onboarding is complete.
See all errors

Was this page helpful?