Payouts

Funds from customer payments stay in the sellers' Buckaroo accounts until Mirakl settles them. Mirakl
calculates what each seller is owed, minus commission and fees, in its billing cycle, and records it in an
accounting document (invoice). When an accounting document is marked as paid, the connector instructs
Buckaroo to pay out:

• the seller amount to the seller, and
• the operator amount (commission) to the operator.

You keep control of the timing through your Mirakl billing cycle and the moment you mark accounting documents as paid.

Payout flow

sequenceDiagram
    autonumber
    participant Mirakl
    actor Operator
    participant Conn as Buckaroo for Mirakl
    participant BCK as Buckaroo
    actor Seller

    Mirakl->>Mirakl: Billing cycle creates an accounting document per seller
    Operator->>Mirakl: Marks the accounting document as paid
    Conn->>Mirakl: Hourly: PAID accounting documents of the last 45 days
    Conn->>Conn: Skips documents that were already paid out
    Conn->>Mirakl: Reads buckaroo-id of the seller's shop
    Conn->>BCK: Operator payout: amount transferred to operator
    Conn->>BCK: Seller payout: amount transferred to seller
    BCK-->>Seller: Payout to the seller's bank account
    Conn->>Conn: Records each payout

Amounts

The connector uses the amounts that Mirakl calculates. It does not calculate commission itself.

Commission and fees

You set up order commission in Mirakl, per category or per seller. Mirakl deducts it in the accounting
document, and you receive it in the operator payout. When an order line is refunded, the commission Mirakl
gives back comes out of your account (see Refunds and cancellations).

If you charge sellers a subscription fee in Mirakl, the fee on a paid accounting document is moved from the
seller's Buckaroo account to yours.

Example

Seller A sold €1,000 this cycle. Mirakl's commission is 12% incl. tax, and the monthly subscription fee is €45.

Subscription fees

sequenceDiagram
    autonumber
    participant Mirakl
    participant Conn as Buckaroo for Mirakl
    participant SA as Seller account
    participant OA as Operator account

    Mirakl->>Mirakl: Accounting document with subscription fee, PAID
    Conn->>Mirakl: Reads PAID documents dated today
    Conn->>Conn: Fee already transferred for this document?
    Conn->>SA: Debit subscription fee
    SA->>OA: Credit subscription fee (internal transfer)

Timing

Payouts start within about an hour of an accounting document being marked as paid. Only documents from the last 45 days are considered, so older ones aren't paid out automatically. When the money reaches the
seller's bank depends on the Buckaroo payout schedule of their account.

Reliability

flowchart TD
    A["PAID accounting document<br/>from the last 45 days"] --> B{"Operator payout<br/>already executed?"}
    B -- no --> C["Pay out operator amount"]
    B -- yes --> D
    C --> D{"Seller payout<br/>already executed?"}
    D -- yes --> Z["Done"]
    D -- no --> E{"Shop has<br/>buckaroo-id?"}
    E -- no --> F["Skip, alert Buckaroo<br/>retry next hour"]
    E -- yes --> G["Pay out seller amount"]
    G --> H{"Result"}
    H -- "Confirmed" --> I["Recorded as executed"]
    H -- "Error" --> J["Recorded as failed<br/>retried next hour"]
    H -- "No answer" --> K["Run stops<br/>Buckaroo checks Plaza<br/>before next run"]

Each accounting document is paid out once to the seller and once to the operator, and a successful payout is never sent again. A payout that fails is retried every hour until it goes through.
The same happens when the seller's shop has no buckaroo-id yet. Buckaroo is alerted in that case.

If a payout request gets no answer from Buckaroo, the connector can't tell whether the money went out.
It stops the run, and Buckaroo checks the payout before the next run so the seller isn't paid twice.

Tracking payouts