ShegerPay for Marketplaces

Quick Answer: Two-sided marketplaces use ShegerPay to verify buyer payments and trigger split payouts to sellers across CBE, Telebirr, PayPal, and USDT — without ever holding funds. Because the platform never custodies money, no money-transmitter license is required, which is the single largest legal barrier most marketplaces hit before launch.

The problem marketplace founders face today

Marketplaces have a fundamental legal problem in Ethiopia (and frankly, most of the world): if you take buyer money into your account before paying the seller, you are operating as a money transmitter. That requires a license, capital reserves, audited custody controls, and usually 6-18 months of regulatory paperwork before you can legally launch. For an early-stage marketplace this is fatal — you cannot validate demand if you cannot collect payment.

The workarounds are all bad. Some founders accept buyer money personally, pay sellers manually, and pray. Others use Stripe Connect — which doesn't operate in Ethiopia. Others use Chapa or Telebirr Business — both of which custodian funds, both of which technically expose you to the same license question, and neither of which supports split payouts to multiple sellers per order.

Then there's the operational nightmare: a single order might have three sellers, two shipping providers, and a platform fee. That's five payouts per transaction. Doing this manually means a reconciliation team. Doing it through a custodial processor means waiting T+3 to release seller funds, which destroys seller trust on day one.

How ShegerPay solves it

ShegerPay's split-payment workflow routes a single buyer payment to multiple recipient accounts atomically. Buyer pays into a verification address keyed to the order; ShegerPay confirms the rail; the moment it confirms, payout instructions fire to each seller's pre-registered bank, Telebirr, PayPal, or USDT address. Platform fee is automatically retained at the source — you never touch seller funds.

Sellers get a role-scoped dashboard showing their pending and completed payouts, their tax-ready statements, and their own KYC status. Buyers get a transparent receipt with on-chain (for USDT) or rail-native (for CBE/Telebirr) proof of payment. Disputes get resolved by the rail provider, not by you holding funds hostage.

Code example

from shegerpay import ShegerPay

sp = ShegerPay(api_key="sk_test_demo")

# 1. Register seller payout destinations (one-time)
seller_a = sp.recipients.create(
    external_id="seller_113",
    destinations=[
        {"rail": "cbe", "account": "1000123456789", "name": "Almaz Tadesse"},
        {"rail": "telebirr", "account": "+251911234567"},
    ],
)

# 2. Create a split order — buyer pays once, funds route atomically
order = sp.orders.create(
    reference="order_99812",
    amount=4500,
    currency="ETB",
    splits=[
        {"recipient_id": seller_a.id, "amount": 4000},          # seller takes 4000
        {"recipient_id": "platform",    "amount": 500},          # platform fee 500
    ],
    rails=["cbe", "telebirr", "visa"],
    webhook_url="https://api.mymarketplace.et/sp",
)

print(order.checkout_url)  # send to buyer

# 3. Webhook fires after buyer pays — payouts dispatch automatically
# Events: order.paid, payout.dispatched, payout.settled, payout.failed

For multi-currency marketplaces (Ethiopian sellers, foreign buyers), USDT splits work the same way — each seller's wallet receives their share directly on-chain.

Why non-custodial matters for marketplaces

This is the use case where custody matters most. Every custodial marketplace operator in Ethiopia is one regulator inquiry away from being shut down, because by holding buyer funds even briefly they are legally a money transmitter. Securing that license requires a registered financial entity, capital reserves, audited controls, and ongoing reporting — none of which is feasible for a pre-seed startup validating product-market fit.

ShegerPay's non-custodial architecture removes this entirely. Buyer money is never in your account. It moves from buyer to seller (and to your platform-fee account) atomically at the rail level. Legally, you are a software vendor providing verification and routing — not a payment institution. This is the difference between launching next week and waiting eighteen months.

Workflow features used

• Split payment routing (N recipients per order)
• Recipient registry with multi-rail destinations
• Atomic payout dispatch on verification
• Role-based dashboards (seller, buyer, admin)
• Platform fee retention at source
• Multi-rail buyer support (CBE, Telebirr, Visa, PayPal, USDT)

Pricing fit

Pre-launch marketplaces (under 50 orders/month) start Free. Once you cross the validation threshold, Growth $29 is the right tier — it includes higher webhook throughput and the split-payment API. Marketplaces processing 10k+ orders/month with custom payout schedules talk to us about Enterprise.

FAQ

Does using ShegerPay mean my marketplace doesn't need a money-transmitter license? In Ethiopia, yes — because you never hold buyer funds. (Always confirm with local counsel for your specific structure.)

Can I take a platform fee? Yes — include a split with recipient_id: "platform" for any portion of each order.

What if a seller hasn't completed KYC yet? You can configure ShegerPay to hold payouts in escrow on the rail (e.g., delayed Telebirr push) until KYC clears, without you touching the funds.

Can buyers and sellers be in different countries? Yes. Buyer rail and seller payout rail are independent — a US buyer pays via PayPal, an Ethiopian seller receives via Telebirr.

How do refunds work? The rail-level refund flow runs in reverse through ShegerPay; seller payout can be clawed back if it hasn't settled, otherwise debited against future payouts.

Can I see all orders and payouts in one dashboard? Yes — admin role sees full transaction tree across all rails and recipients.

Related: Pricing · API Docs · ShegerPay vs Chapa · Verify Telebirr · Non-custodial payments explained