🔀 Split payments

Collect one payment and pay each payee its share, by rules you save once.

Split payments let you collect one payment and pay several payees from it, by rules you save once.
You can split an invoice or a card charge.

Terms

  • Rule set: your saved split rules, such as 60% carrier, 25% MGA, and the rest to the broker. Each change saves a new version.
  • Share: one line of a rule set, naming one payee and how its cut is calculated, such as "carrier gets 60%". A share is a rule, not money.
  • Payee: anyone who gets a share. Every payee is one of your carriers.
  • Part: the amount one rule set splits. A payment that covers several policies can have one part per policy.
  • Leg: one payee's payout from one payment, such as $600 to the carrier. Each leg pays out on its own, so one failed leg does not stop the others.
  • Settled: the policyholder's money has arrived and is ready to pay out. For a card charge, this is the succeeded status. For an invoice, this is when the invoice is paid.
  • Trust Account: your bank account that receives collected funds today. We pay it any amount that no part covers and any canceled leg.

Example

A policyholder pays a $1,000.00 invoice split 60/25/15:

PayeeShareLeg
Carrier60%$600.00
MGA25%$250.00
BrokerThe rest$150.00

Workflow

  1. For each direct payee, add a bank account for the carrier.
  2. Create a split rule set.
  3. Add the split when you create an invoice or a card charge.
  4. When the payment settles, we release each leg (automatic), or you release it (manual).
  5. Follow each leg with Get split payment or the split_leg_status_changed webhook (event ID 10), and manage legs as needed.

Payout modes

payoutModeWho pays the payees
managedWe pay each leg.
instructionsYou do. We pay the full amount to your Trust Account and send each payee's amount in the split_payment_instructions_ready webhook (event ID 11).

Limits

  • USD only, paid to US bank accounts.
  • One level of splits. A share cannot point to another rule set.
  • Share types are percent, fixed, threshold, and remainder.
📘

Note

  • We round each percent and threshold share down to the cent. The remainder share gets the rest.
  • Payout fees follow your account's fee setting.
  • Ignore fields and values you do not recognize. We will add more over time.
📘

Pro tip

Updating a rule set changes unpaid invoices and future payments. A payment that is already collected keeps the version it was collected under.

❗️

Important

  • You can refund a split card charge only in full, and only while every leg is waiting or held. Use manual mode if you need time to refund.
  • If a payment is disputed or returned after the legs are paid, your account repays it. We do not take money back from payees.

Did this page help you?