Affiliate commissions and organizer payouts

New staging website. Use https://beti.worldyogaalliance.org/admin/commerce/affiliates and the linked staging payout routes. These controls record decisions; they do not replace external finance evidence.

Open the finance controls

Affiliate controls are at Commerce → Affiliate settings or /admin/commerce/affiliates. The page has Referrals, Commissions and payouts, and Commission policy.

Organizer payout settings are at Operations → Configuration, with pending requests linked to /admin/operations/payouts. The payout controls explicitly say These controls never initiate a transfer. A decision records the outcome of an external/manual transfer process; it does not send money.

Review referrals

The Referrals table shows Registration, Referrer, Invoice, Attribution, and Recorded. The page warns that a referral row does not confirm payment or commission. Check the related invoice/payment before taking commission action.

Review a commission

Under Commissions and payouts, a commission card can show Commission, Payment, Reversed, Paid, and Recovery due.

1. Open the registration, invoice, and payment context.
2. Check whether a partial/full refund, dispute, reversal, or recovery is present.
3. Enter a required review note (up to 1,000 characters).
4. Select Approve commission or Reject commission.

Approval is blocked when the commission requires refund review or recovery. A rejected commission remains available for audit; do not create a replacement commission by hand.

Record an affiliate payout decision

Affiliate payout cards show the amount, currency, destination, request note, and transfer reference.

1. Verify the approved commission and eligible payment.
2. Confirm the destination through the private finance process; do not copy full destination details into a ticket.
3. Enter a decision note.
4. For a paid result, enter the required transfer reference.
5. Select Record manual payout or Reject payout.

The page blocks a paid decision when the payout is not eligible or a recovery is outstanding. Recording the decision does not initiate a transfer.

Update the commission policy

The Commission policy form includes:

• Commission method: Percentage of paid registration amount or Fixed amount per registration.
• Percentage rate (0–100, up to two decimal places).
• Attribution window (days) (1–365).
• Attribution method: First eligible referral or Last eligible referral.
• School registration purchases and Teacher registration purchases.
• Currency cards for USD, THB, EUR, and INR with Fixed commission and Minimum payout.
• Save commission policy.

The policy text explains that the first paid school/teacher registration creates the verified commission, self-referrals are excluded, and partial/full refunds or disputes can affect the commission. Review the policy before saving because it applies to future attribution and does not pay money itself.

Review organizer payout requests

Open /admin/operations/payouts from the Configuration link. The page has status filters All, Requested, Rejected, and Paid.

1. Open the request and check the eligible event payments and hold/cancellation conditions.
2. For rejection, enter a decision note and select Reject request.
3. For a completed external transfer, enter a decision note and transfer reference, then select Mark paid.
4. Reopen the request and verify its status.

The form blocks Mark paid when the request is not eligible and requires a transfer reference. It does not make the transfer.

Configure organizer payout and cancellation rules

In Operations → Configuration, use Organizer payouts and cancellation:

• Minimum payout hold (days) — whole days, 0–365.
• Free cancellation cutoff (days) — whole days, 0–365.
• Platform fee (%) — 0–100.
• Save settings.

The section shows the pending request count and Review payout requests. Check existing payout eligibility before changing these shared rules. This is a policy write, not a payout action.

Confirm the decision

Reopen the commission or payout request and verify its status, note, and transfer reference. Policy changes affect future attribution and do not retroactively pay an affiliate. A recorded decision does not replace Stripe/provider evidence or a bank transfer confirmation.