Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
Versioning
Changelog
Upgrade your API version
Upgrade your SDK version
Essentials
SDKs
API
Testing
Stripe CLI
Sample projects
Tools
Workbench
Developers Dashboard
Stripe Shell
Stripe for Visual Studio Code
Features
Workflows
Event destinations
Stripe health alertsFile uploads
AI solutions
Agent toolkit
Model Context Protocol
Security and privacy
Security
Stripebot web crawler
Privacy
Extend Stripe
Build Stripe apps
Use apps from Stripe
    Overview
    Stripe-built apps
    Adobe Commerce
    Cegid
    Commercetools
    Mirakl
      Install
      Configure
      Onboard sellers
      Payments and payouts
      Reference
    NetSuite
    Oracle Opera
    Oracle Simphony
    Oracle Xstore
    PrestaShop
    Salesforce
    SAP
    Shopware 6
    Stripe Tax for BigCommerce
    Stripe Tax for WooCommerce
    Partner apps
    Build your own app
Partners
Partner ecosystem
Partner certification
HomeDeveloper resourcesUse apps from StripeMirakl

Payments and payouts using the Mirakl app

Accept payments and pay out using the Stripe Mirakl app.

We categorize payment methods into seven families. Each family has similar features, a single integration, and common checkout experiences. You can use one of our existing apps or build your own integration to accept payments.

Note

When implementing payments, don’t use any of the Connect charge types. The plugin takes care of splitting the funds based on your Mirakl orders.

Create a payment

Choose the payment method families according to the order workflow most adapted to your use case.

FamilyPay on acceptance Pay on delivery Pay on due date
Cards
Bank debits
Bank redirectsN/AN/A
Credit transfers
Buy now, pay laterN/AN/A
VouchersN/AN/A
WalletsN/AN/A

Pay on acceptance

For cards, set the value of capture_method option to manual when completing the PaymentIntent to authorize only. The connector captures the funds automatically as soon as all sellers have accepted or refused their respective orders. The orders must be accepted or refused within 7 days, the validity period of an authorization.

Because the payment confirmation is immediate for bank redirects, wallets and buy now, pay later, we recommend setting up your orders to be accepted automatically and using refunds when sellers can’t fulfill their order.

Pay on delivery

For cards, you can authorize only during checkout if you have business rules in place to capture the payment within 7 days. Otherwise, save the card at checkout and authorize later. For bank debits, you can save the bank account at checkout and initiate the payment after the seller accepts their order.

Pay on due date

You can use Stripe Billing to send an invoice to your customers who can then pay using our hosted invoice page.

Validate a payment

To handle the payment validation of your Mirakl orders, you can rely on the built-in job or call the PA01 API yourself if you have specific needs such as offering coupons.

To enable the built-in job, you have to first map the Mirakl order with the successful Charge by updating the metadata:

Command Line
curl https://api.stripe.com/v1/charges/ch_1Hmloy2eZvKYlo2C2Tx3W00V \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "metadata[mirakl_commercial_order_id]"=123

The workflow starts when a seller accepts their logistic order.

  1. The payment validation job fetches newly accepted Mirakl orders.
  2. The plugin validates the payment in Mirakl.
  3. For cards, the payment is captured when all the logistic orders are accepted or refused.

Payment split

The workflow starts when the payment is validated on Mirakl and captured on Stripe.

  1. The payment split job fetches newly validated Mirakl orders.
  2. The plugin transfers the order amount to the seller after deducting your commission.

Refund a payment

The workflow starts when you request a refund on a Mirakl order.

  1. The payment refund job fetches newly refunded Mirakl orders.
  2. The plugin creates a refund on Stripe, validates the refund on Mirakl, and then reverses the transfer used to split the payment.

Pay out to your sellers

The amount and frequency of each payout to your sellers is controlled by Mirakl based on your settings. You can customize your billing cycles under Settings > Shops > Billing Cycles. By default, your sellers receive their payouts on the 1st, 11th, and 21st of each month.

Seller settlement

The workflow starts when Mirakl generates a new invoice.

  1. The payout job fetches newly created Mirakl invoices.
  2. The plugin performs the following actions based on the invoice attributes:
Invoice attributeAction taken
total_other_credits_incl_taxTransfer from the operator to the seller.
total_other_invoices_incl_taxTransfer from the seller to the operator.
total_subscription_incl_taxTransfer from the seller to the operator.
amount_transferredPay out to the seller.

Commissions are already handled during the payment split workflow.

Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Join our early access program.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc