Payouts and settlement
How and when XPay disburses your balance to your bank, plus the settlement-method form, schedule view, and the payout batch detail page.
A payout is XPay sending your settled balance to your bank. The dashboard's settlement settings page is where you manage the bank account, wallet, or card the funds land on, and where you read your payout schedule. Once a payout has been generated, you can drill into it from the Payouts tab on Transactions, the Recent Payouts on Balance, or the Connected Payout link on any payment.
This page covers the settlement methods form, the approval gating that controls when you can edit it, the payout schedule, and how to read a payout batch detail.
What you can do
Set where money lands
Add a bank account, wallet, or card as your settlement method. Mark one as the default.
See your schedule
The payout schedule for your account is shown on the Balance page. Changes go through XPay support.
Wait for approval
Settlement edits are gated on account verification. Test mode is read-only; live mode opens up once your account is approved.
Read a payout batch
Every payout has a detail page with timeline, method, summary, and the underlying charges and refunds.
Open the payouts settings
In the dashboard sidebar, click your account menu and pick Settings, then Payouts. The page is titled Settlement methods.
Approval gating
What you see on the page depends on your account's verification status. Four states, four behaviors:
| Status | What the page shows |
|---|---|
| Draft | A "You must request account verification before editing these settings" panel with a Request Verification button to start onboarding. |
| Pending review | "Your application is under review. You'll be able to manage payout methods once your application is approved." |
| Changes requested | Same as pending review. The verification team has asked for additional information; the dashboard's onboarding flow will surface it. |
| Approved | Settlement methods and schedule are visible. Methods can be added and edited in live mode (subject to permissions). |
The Add Settlement Method button is disabled with a tooltip naming the reason it's blocked: missing payouts-write permission, account not approved, test mode, or pending submission.
Test mode
In test mode, settlement methods are auto-provisioned by XPay so you can simulate the full payment-to-payout cycle without real bank details. The methods can't be edited or removed; the dashboard surfaces a notice reading "Test mode payout methods are auto-provisioned for testing. Switch to live mode to manage your real payout methods."
The Add button is disabled in test mode regardless of approval status.
Settlement methods
A settlement method is the destination XPay sends payouts to. The page lists every method on your live account with the default one pinned to the top.
Three method types
| Method | Fields you provide |
|---|---|
| Bank account | Account holder name, bank name (from a select), branch (from a select), account number (10 to 20 digits), IBAN, SWIFT code, currency. |
| Wallet | Wallet holder name, wallet number, currency. |
| Card | Card holder name, card number, expiry month, expiry year, card network (from a select), currency. |
Every method has a single currency. Your account's default settlement currency drives the dashboard's currency picker; pick another one if you want a method in a different currency.
Default method
One method on the account is marked Default. Funds land in the default method on every payout unless XPay flags a method-specific issue (for example, a bank rejection).
The default appears at the top of the methods list with a Default badge. To change which method is the default, edit the method you want as default and toggle it on. There's only ever one default at a time.
Add a settlement method
Click Add Settlement Method
In the top right of the Settlement methods page, click Add Settlement Method. A side sheet opens.
Pick a method type
Pick Bank account, Wallet, or Card. The sheet's fields adjust based on what you pick.
Fill in the details
Fill in the holder name and the type-specific fields (see the table above). Optional Default method toggle at the bottom of the sheet pins this method as the default for future payouts.
Click Add
Save the method. The new entry appears in the list. If there's already a pending submission, your changes go through admin review before becoming the active method.
Edit and remove
Each method's row opens a sheet (the same one used for Add, in edit mode). Update fields, toggle the default, save. To remove a method, the sheet's footer carries a destructive action (gated on the same write permission and approval state).
Pending submission
Edits to a settlement method don't take effect immediately on a live account. The change goes into a pending submission state for admin review. While that's pending, the dashboard shows a notice reading "You have payout method changes awaiting admin review" and disables further edits until the review completes.
Payout schedule
Your payout schedule is set per merchant by the XPay operations team and isn't editable from the dashboard. The current schedule is shown on the Balance page in the Payout Schedule sidebar, with the next settlement date when one is queued.
If you're on a Manual schedule, the Balance page also shows a Pay out funds button so you can wire your available balance whenever you want.
To change the schedule, contact support.
Read a payout batch
When XPay generates a payout, you can find it in three places: the Payouts tab on the Transactions page, the Recent Payouts list on the Balance page, or the Connected Payout link on any payment that's already settled. Click any payout to open its detail page.
Header
The payout's amount, currency, and status (Open, Processing, In Transit, Paid, Failed, Canceled) sit at the top.
Details
A right-side block listing Payout ID, Created, Expected Arrival, Delivery Method (bank, wallet, or card with an identifier), Schedule (Automatic or Manual), Description, and Fee when applicable. The settlement type is shown as Standard or External.
Timeline
A reverse-chronological log of every step in the payout's life. Common entries:
- Payout initiated (automatic or manual).
- Payout in transit when the wire is submitted.
- Payout completed when the funds land.
- Payout failed with a failure code when the bank rejects.
- Payout canceled when the batch is canceled before the wire.
Payout Method
The bank account, wallet, or card the funds went to, with the relevant identifiers (bank name, account number, IBAN, wallet number, card number, card network).
Summary
The math behind the payout amount:
- Charges. Sum of payments included in this batch.
- Refunds. Sum of refunds processed against those payments, deducted from the batch.
- Charges fees. XPay's processing fees on the included charges.
- Subtotal. Charges minus refunds and charges fees.
- Payout fees. XPay's fee on the payout itself, when applicable.
- Net payout. The amount that lands in your bank.
Failure Details
When the payout failed, an extra block appears with the Failure code and any explanatory message returned by the bank.
Transactions
A table of every charge, refund, and fee included in this payout batch. Click any row to open the underlying transaction.
Where payouts show up
| Surface | What you see |
|---|---|
| Transactions → Payouts tab | The full list of payout batches with status, amount, and arrival date. |
| Balance → Recent Payouts | The latest few payouts at the bottom of the Balance page. |
| Balance → Total paid out | The lifetime total of paid payouts across all batches. |
| Transaction detail → Connected Payout | A link from any settled payment to the payout batch its funds are part of. |
| Transactions → All Activity | Each payout shows up as an entry in the running balance ledger, alongside the charges and refunds it covers. |