Business Registration
To start accepting payments, businesses must register with a payment processor. The registration process varies depending on whether you’re registering as an individual or a company. For individual businesses, you’ll need to provide your Social Security Number’s last 4 digits along with your date of birth and address. Company registrations require additional information like the business name and Employer Identification Number (EIN). If a business tries to register more than once, the API returns abusinessAlreadyRegistered error.
Financial Accounts and Cards
Once registered, businesses can add financial accounts for receiving payouts. These can be traditional bank accounts added manually or through Plaid integration for instant verification. You can also add payout cards for faster fund access, though this typically comes with higher fees. Both financial accounts and cards can be designated as default payout destinations. When you need to remove accounts or cards, use the respective removal operations. However, you cannot remove default financial accounts or remove default payout cards - the API will return acannotRemoveDefault error. You must set a different account as default first.
Balance Monitoring
The business balance endpoint shows your current financial position across four categories: Available funds are ready for standard payouts to your bank account. Available for instant represents the portion of those funds eligible for instant payouts to cards, subject to daily limits. Pending funds are still processing and not yet available for payout. Allocated funds are already committed to payouts currently being processed. If you try to check your balance before completing payment processor setup, you’ll receive apaymentProviderNotSetup error.
Payout Methods
Different payout destinations support different methods. When listing financial accounts or listing payout cards, you can filter by payout method to see which destinations work for your intended payout type. The platform handles the complexity of routing payouts to appropriate destinations based on the payout method you choose.Error Handling
Common business operation failure scenarios:| Error Type | Description | Resolution |
|---|---|---|
businessAlreadyRegistered | Business is already registered | Use existing registration |
cannotRemoveDefault | Cannot remove default financial account or card | Set a different default first |
paymentProviderNotSetup | Payment processor not configured | Complete business registration |
Getting Started
- Register Your Business: Provide business details and payment processor information
- Complete Verification: Submit required identity and business verification documents
- Add Financial Accounts: Configure bank accounts or cards for payouts
- Monitor Balances: Track available funds and payout readiness
- Configure Payouts: Set up automatic or manual payout preferences