Mirakl

On a Mirakl marketplace, one storefront sells products from many independent sellers.
Buckaroo for Mirakl connects that marketplace to Buckaroo Split Payments. The customer pays once at checkout, and Buckaroo divides the money between the sellers and you, the operator. The connector also takes care of onboarding sellers, refunds and payouts, driven by what happens in Mirakl.

Buckaroo hosts the connector, so there is nothing to install.
You add a few fields in Mirakl, and Buckaroo links your Mirakl environment to your Buckaroo account.

Who it is for

• Marketplace operators running on Mirakl who sell for third-party sellers in the Netherlands and Belgium
• Operators who want a licensed payment service provider to collect customer payments and distribute them to sellers

Features

• New sellers are submitted to Buckaroo for onboarding (KYC) with the company, bank and contact details they entered in Mirakl. The result of the review shows up as the shop's KYC status in Mirakl.
• Each approved seller gets a Buckaroo account, and its ID is stored on the Mirakl shop.
• A basket with products from several sellers is paid in one payment and split across the sellers and you.
• Refunds and cancellations made in Mirakl are refunded to the customer. The commission on them comes back out of your share.
• Mirakl calculates the order commission, and you receive it with each payout. Seller subscription fees are deducted from the seller's balance.
• When an accounting document in Mirakl is paid, Buckaroo pays out the seller and you.
• You can follow every payment, refund, transfer and payout in Buckaroo Plaza.

Available payment methods

A wide range of payment methods that Buckaroo supports for Split Payments can be used at your marketplace checkout, including iDEAL | Wero, Bancontact, credit and debit cards, Riverty and SEPA Direct Debit. See Split Payments.

How the money flows

flowchart LR
    C([Customer]) -- "1 · Pays the order<br/>(one payment)" --> SP[Buckaroo<br/>Split Payments account]
    SP -- "2 · Split per seller" --> SA[Seller accounts<br/>at Buckaroo]
    SP -- "2 · Operator share" --> OA[Operator account<br/>at Buckaroo]
    SA -- "4 · Seller payout" --> SB[(Seller<br/>bank account)]
    OA -- "4 · Operator payout<br/>(commission)" --> OB[(Operator<br/>bank account)]
    M{{Mirakl}} -. "3 · Accounting document PAID" .-> SP

1. The customer pays the whole basket in one payment at the marketplace checkout.
2. Buckaroo splits the payment between the sellers in the order and the operator.
3. Mirakl calculates commission and fees in its billing cycle. When an accounting document is marked as paid, the connector instructs Buckaroo to pay out.
4. Buckaroo pays the seller's amount to the seller's bank account and the commission to the operator.

Refunds run the other way. The seller's part comes from the seller's account and the commission part from
the operator's account.

How the systems connect

flowchart TB
    subgraph OP["Operator"]
        ST[Storefront / checkout]
        MK[(Mirakl<br/>shops · orders · accounting documents)]
    end
    subgraph BK["Buckaroo"]
        CN[Buckaroo for Mirakl<br/>connector, hosted by Buckaroo]
        SPL[Split Payments]
        ONB[Seller onboarding]
        PZ[Plaza]
    end

    ST -- "Split payment request" --> SPL
    SPL -- "Push message" --> ST
    ST -- "Writes buckaroo-transaction-id<br/>reads buckaroo-id" --> MK
    CN -- "Every hour: reads shops, orders,<br/>accounting documents (operator API)" --> MK
    CN -- "Writes KYC status and buckaroo-id" --> MK
    CN -- "Submits sellers, reads status" --> ONB
    CN -- "Refunds, fee transfers, payouts" --> SPL
    SPL --- PZ

Lifecycle of a marketplace order

flowchart LR
    A["Seller onboarded<br/>KYC APPROVED"] --> B["Customer pays<br/>split payment"]
    B --> C["Order shipped"]
    C --> D{"Refund or<br/>cancellation?"}
    D -- yes --> E["Refund to customer<br/>seller part + commission part"]
    D -- no --> F
    E --> F["Mirakl billing cycle<br/>accounting document"]
    F --> G["Document marked PAID"]
    G --> H["Payout to seller<br/>and operator"]

Roles

Before you start

• A Buckaroo Enterprise account with the Split Payments service activated. Contact your Buckaroo account manager.
• A Mirakl Marketplace Platform environment with shop KYC enabled, and access to the Mirakl back office as operator
• A Mirakl operator API key for Buckaroo to use
• A storefront checkout that can start a Buckaroo split payment and write data to a Mirakl order (see Pay-ins)
• A test environment of both Mirakl and Buckaroo for the test transaction