Marketplace Overview

Marketplace offers a unified shopping experience, allowing your customers to access a wide range of products and services from you and other managed sellers. Customers can complete their purchases with a single payment, simplifying the entire transaction process within the Marketplace ecosystem. Operating on behalf of its sellers, the Marketplace provides a seamless, one-stop shopping experience, enabling customers to shop from multiple sellers in one convenient location through one transaction.

Our solution provides the necessary tools to efficiently manage a large number of sellers and their transactions. With real-time updates via API, you can control when and how much sellers are paid through an automated, streamlined process.

Key Features

• Automated Transaction & Settlement Reconciliation - Our API integration automatically reconciles transactions and settlements, ensuring accuracy and efficiency in managing the financial operations of the Marketplace.
• Seamless Customer Experience - Provide your customers with a seamless shopping experience, enabling them to purchase goods from multiple sellers in one convenient location. Ensure a smooth and efficient transaction process, all while generating value through the Marketplace as a service.
• Merchant Dashboard Access - Access the Merchant Dashboard to view all transaction data for your sellers in one centralized place. This comprehensive tool helps you monitor and analyze sales performance, ensuring you stay informed and in control.
• Flexibility & Scalability - Our solution with API integration offers the flexibility to onboard and manage sellers dynamically through your marketplace.

Understanding The Marketplace

Definition	Description
Marketplace	A Marketplace facilitates the exchange of goods and services between buyers and sellers across a range of products. This solution streamlines transactions from multiple sellers on a single platform, all managed by the Marketplace Operator on behalf of its sellers.
The Marketplace Operator (MPO)	The Marketplace is governed by the Marketplace Operator, managing multiple sellers on a platform to list and sell their products or services to a wide audience of customers. The MPO operates on behalf of its seller, handling the transactions and settlements for them.
Sellers	A seller is a supplier of goods belonging to the Marketplace with each seller configured against a Marketplace Operator. Sellers leverage the relationship with the Marketplace to enable settlement, disbursement and reconciliation for the customer purchases of their goods on the Marketplace.
Staging Account	Deutsche Bank’s Staging account serves as an escrow account, gathering funds from your seller's Marketplace transactions and securely holding them under Deutsche Bank's custody until they are ready to be disbursed to your seller. Deutsche Bank will give you the control to disperse these funds from the Staging Account to your sellers, under Deutsche Bank’s supervision.

Seller Onboarding

Every time we onboard a seller, we will send you a Webhook. This Webhook will contain the Seller ID. This Seller ID will be used to initiate any Payout specific to this seller in the Payout API.

Marketplace Settlement

To streamline the settlement of funds for both Marketplace Operators and sellers, the disbursal process is divided into two distinct stages:

Tier 1 Processing

Tier 1 Processing is centered on the settlement of funds from Deutsche Bank to the Marketplace's Staging Account. Here’s how it works:

1. Transaction Collection - Deutsche Bank collects and stores all transactions related to the Marketplace and its sellers.
2. Fund Settlement - Deutsche Bank then settles these funds into the Marketplace's Staging Account, notifying the MPO of the Settlement via a Webhook.

Learn more about Webhooks here - What are Webhooks? | DMG DocHub

Tier 2 Processing

Once Tier 1 Processing is complete, the MPO assists Deutsche Bank in disbursing the funds to all their sellers via the Payout API. Here’s how it works:

1. Monitor Staging Account Funds - Use our Balance API to check the available funds in your staging account
2. Disbursement Instructions - Use our Payout API to inform Deutsche Bank about which sellers should receive funds and specify the how much should be disbursed.
3. Disbursement Updates - Configure the Payout Complete Webhook to receive notifications confirming that funds have been successfully disbursed to your sellers.

You can view the settlements in two different ways:

1. High-Level Overview - View mass settlements for all sellers, providing a broad perspective on disbursements.
2. Detailed Insights - Dive into individual seller settlements for more granular information.

Marketplace APIs

Order API

The order_line_items field in Marketplace allows merchants to specify individual items from multiple sellers within a single order, including unique identifiers for each seller and customizable metadata fields.

This structure enables detailed tracking of seller-specific items and order reconciliation at a granular level.

{
  "order_request": {
      ...OtherOrderFields,
      "order_line_items": [
          {
              "details_format": "details",
              "order_line_item_type": "seller_line_item",
              "order_line_item_details": [
                  {
                      "seller_id": "e67a0b0b-695a-47f9-ad93-680ec190c70c",
                      "total_price": {
                          "value": 100
                      },
                      "extra_fields": [
                          {
                              "key": "customerEmail",
                              "value": "john@doe.com"
                          },
                          {
                              "key": "internalId",
                              "value": "3456"
                          }
                      ]
                  }
              ]
          }
      ]
  }
}

Field	Type	Description
seller_id	String	The unique identifier for the seller associated with this line item.
total_price	Object	The price for this specific item from the seller.
total_price.value	Number	The total value of the item (e.g., 100).
extra_fields	Array	An array of key-value pairs for additional metadata related to the item. During settlement, all entries in extra_fields are exported to assist merchants in internal reconciliation.
extra_fields.key	String	A key representing metadata for the item (e.g., "customerEmail" for tracking buyer contact information). Merchants can define custom keys without specific validation.
extra_fields.value	String	The value associated with the key (e.g., "john@doe.com"). This data is provided as-is, without validation, to support merchant-specific needs.

Settlement API - Tier 1 Processing

The Settlement process in Marketplace finalizes transactions for each seller’s items, providing a detailed record for MPOs to reconcile funds received into their Staging account. During Tier 1 Processing, all entries in extra_fields under order_line_items are exported, making it easy to track each seller’s item with associated metadata.

Learn how to use the Settlement API here - API Integration | DMG DocHub