Money journey
How a customer's payment becomes revenue-share credits on your treasury and member accounts, when it can be withdrawn, and how refunds, chargebacks and manual transactions change it.
When a customer pays for a product that shares revenue, Planeward splits what the buyer paid between the affiliate who referred the sale, the product's holders, and your treasury. Once Stripe or Xendit reports its processor fee, Planeward takes the fee off the shares of the accounts the product picked to cover it. Each share waits on hold until the product's settlement cooldown ends, then becomes available to withdraw. Refunding before settlement cancels the shares; refunding after settlement takes them back from every account that received one, even when that pushes a balance below zero. A Stripe chargeback works like a full refund the moment it opens.
Related
| Guide | Use it for |
|---|---|
| Invoices and payments | Recording payments, receipts, invoices |
| Payment processors | Connecting Stripe or Xendit, webhook events |
| Roles and permissions | Giving people Manage commerce and Manage payments |
Journey
| Account | Belongs to | Receives |
|---|---|---|
| Treasury | Your workspace | Treasury cut on each sale, manual transactions |
| Planeward Account | A member of your workspace team | Holder shares, manual transactions |
| Community Account | A customer with earnings | Holder shares, affiliate referrals, manual transactions |
An account is created the first time it receives money: a sale share, a referral, or a manual transaction.
An account that covers processor fees also gets a Processor fee debit for each Stripe or Xendit sale it earned from. See Processor fees.
How a payment is split
The affiliate's percentage is always of what the buyer paid. The processor fee never lowers it.
Rounding: each share is rounded down and the leftover cents go to the largest share.
Processor fees
Stripe and Xendit keep a fee on every payment. Planeward looks it up after the payment and takes it off the revenue share. The payment amount stays what the buyer paid.
- When the fee is known. Stripe's usually within a few minutes. Xendit's once the payment settles, which can take a few days. Until then the payment page shows the fee as Pending.
- Who covers it. Each product picks the accounts that cover its fees: any of its holders (team members or community members) and the treasury. By default, all of them do. The fee is shared among them in proportion to what each earned from that sale.
- Affiliates never cover it. Affiliate and setter commissions stay their exact percentage of what the buyer paid.
- How it shows. Each covering account gets a Processor fee debit in its balance history. The payment page shows the fee and the net.
- Credited first, deducted later. Shares are credited when the buyer pays. The fee debit comes later, so if the share was already withdrawn, the balance can go below zero, as after a refund. The account's next earnings pay it back.
- Bank transfers (approved receipts) have no processor fee.
- No fee found. If Planeward can't find the fee within 30 days, the payment shows the fee as Unavailable with the reason, and nothing is deducted.
The choice of who covers the fee is saved on each sale. Changing it on the product applies to new sales only.
Past sales. Sales made before Planeward deducted processor fees get their fees in a one-time update run by Planeward staff. It uses each product's current choice of who covers the fee, and it also reaches shares that were already settled or withdrawn. Set who covers fees on each product before it runs.
Statuses
| Sale status | Counts toward | Can be withdrawn |
|---|---|---|
| Pending (on hold) | Pending balance | No |
| Completed | Available balance | Yes |
| Canceled | Nothing (refunded before settlement) | No |
| Reversed | Nothing (credits taken back) | No |
The payment itself shows Refunded after a full refund or a chargeback. A partial refund leaves it Completed with a lower amount.
Refunding a payment
Open the sale on Finance → Transactions (row menu → Refund payment…) or the payment on Finance → Payments (Refund payment card). Enter the amount (the full amount by default), a reason, and what should happen to the plan the payment granted.
When nobody changes the plan choice, a full refund ends the plan and a partial refund keeps it. Ending a plan that Stripe or Xendit bills also cancels its subscription there right away, so it doesn't renew. A plan billed through Stripe or Xendit can't get a new end date here; change it in that dashboard.
If the payment changed after you opened the dialog (another refund or an amount edit), Planeward refuses the refund and reloads the page so you can start again from the amount that is left.
Shares already paid out. If a share was already withdrawn, the refund still takes it back, and that account's balance goes below zero. Its next earnings pay the debt back first, and nothing can be withdrawn until the balance is above zero again. The only thing that blocks a refund is a pending withdrawal that still needs the funds.
A full refund sends the payment.refunded webhook with reason manual_refund; a partial refund sends payment.updated. Ending the plan also sends subscription.terminated. The reason you type goes to the audit log only.
Correcting a payment amount
To fix a wrong amount, edit the payment on Finance → Payments and change Amount, with an optional Reason. On a completed payment, Planeward re-splits the revenue share to the new amount and posts a ledger adjustment for the difference. The processor fee stays what Stripe or Xendit charged, shared again among the same covering accounts. The payment's Amount history card lists every change.
- Refunds go through Refund payment. Setting the status to Refunded runs the same full refund.
- A payment that paid an invoice can't have its amount edited: "Edit the invoice instead."
- A refunded payment keeps its amount; only its note and paid date can change.
Chargebacks
When a customer disputes a Stripe card payment, Stripe pulls the funds as soon as the dispute opens. Planeward reverses the payment at that point, exactly like a full refund: the plan ends (subscription.terminated), the member loses access, its Stripe subscription is canceled, and every share is taken back. Because the money has already left, the shares are taken back even if a pending withdrawal needs them or that pushes a balance below zero. An inquiry, where the bank only asks questions, moves no money, so nothing changes unless it turns into a chargeback. A full refund made in Stripe works the same way.
Manual transactions
Finance → Transactions → New transaction adds a settled credit or debit straight away. The member search lists active members only. A former member (a removed team member or a revoked community member) who already has an account can still receive one: open their account on Finance → Balances and use New transaction there.
Reading the Transactions page
- The sale row's amount is the net of the entries inside it. A sale canceled before settlement nets to 0.
- Filters look inside sales: Type = Referral keeps only the sales that paid a referral, and shows just those rows when expanded.
- Pages count sales, not individual rows. The Treasury and member account pages list rows individually.
Staff setup
| Setting | Where | Effect |
|---|---|---|
| Holders and their % | Commerce → Catalog → product → Rev share → Holders | Who gets a share |
| Treasury cut | Commerce → Catalog → product → Rev share → Treasury | Percentage or fixed amount |
| Processor fees | Commerce → Catalog → product → Rev share → Processor fees | Which holders and whether the treasury cover Stripe and Xendit fees (all by default; new sales only) |
| Settlement | Commerce → Catalog → product → Rev share → Settlement | Pending settlement on or off, and Cooldown days |
| Cost mode | Commerce → Affiliates → Program | Platform or Shareholder pays the referral |
| Stripe webhook events | Settings → Integrations → Payments | Add charge.dispute.created, charge.dispute.funds_withdrawn and charge.dispute.closed so chargebacks reverse payments |
| Manage commerce | Settings → Roles | Catalog, rev share, and the Finance pages that need Commerce, manual transactions |
| Manage payments | Settings → Roles | Refunds, approving withdrawals |
Troubleshooting
- A rejection reason is sent to the member. When you reject a withdrawal, the reason you type is in the member's bell item, push and email. Members are also told when you complete a withdrawal and when their balance changes. See Community notifications.
- Refund blocked: a pending withdrawal needs the funds. Reject that withdrawal first, then refund.
- "This payment changed. Refresh and try again." Someone refunded or edited the payment after you opened the dialog. Open it again; it starts from the amount that is left.
- A balance went negative after a processor fee. The share was withdrawn before the fee was known. The account's next earnings pay it back.
- Processor fee stays Pending with a note, or shows Unavailable. For Xendit, check that the API key has the Transaction Read permission. Fix it within 30 days of the payment and the fee is still deducted; a fee not found within 30 days never is.
- A balance went negative after a refund. The shares had already been paid out. The account's next earnings pay it back; until then nothing can be withdrawn from it.
- No Refund payment option. You need Manage payments, and the payment must be Completed and not already refunded.
- Partial refund refused. Payments that paid an invoice refund in full only; edit the invoice instead.
- Member missing from the search. The search lists active members only. Removed team members and revoked community members can't get a new account; if they already have one, open it on Finance → Balances and add the transaction there.
- A balance went negative after a chargeback. The shares were taken back after the money was paid out. Reject any pending withdrawal from that account, or add a manual transaction once you recover the funds.
- Chargeback won, but the payment still shows Refunded. Planeward keeps the refund on record and adds a note to the payment. If Stripe returned the funds, record a new payment for them.
- Chargeback didn't reverse the payment. Check that the Stripe webhook subscribes to
charge.dispute.createdandcharge.dispute.funds_withdrawn. An inquiry is only reversed once Stripe withdraws the funds.
Open items
- Refunds record the money in Planeward only. Refund the card in Stripe or Xendit as well.
- When a refund or chargeback ends a plan, Planeward cancels its Stripe or Xendit subscription once. If that call fails (the processor is down or its key was removed), the refund still stands and the failure is logged, so cancel the subscription in that dashboard or the next renewal turns the plan back on.
- Planeward reverses full Stripe refunds automatically. It doesn't apply partial Stripe refunds, so record those here.
- Chargebacks are handled for Stripe only.
Sales journey
How a visitor gets from an affiliate's link or one of your redirects to your Site sales page, through checkout, and how the sale credits the right affiliate before revenue share splits it.
Apps in your community
Add tools from other developers to your community, choose what they can access, and remove them.
Planeward Docs