Introduction

The Digital Trade Account lets you onboard buyers who can then order multiple times throughout the billing period. At the end of a billing period, Mondu sends out a consolidated statement with an overview of all open invoices, so that buyers can pay the full amount in one sum instead of needing to pay every invoice separately.

👍

Good to Know

The Digital Trade Account requires additional configuration on your merchant account. If you'd like to use our Digital Trade Account, please get in touch with your Mondu Sales Rep.

Prerequisites

To start using the Digital Trade Account, we'll need the following parts of Mondu's API

• Mondu Digital Trade Account
• Orders API
• Invoices API
• Webhooks

Buyer Onboarding

Legal Requirements

Before onboarding starts, you need to make the buyer aware of data processing by Mondu. You can use this snippet:

Information on the processing of your personal data by Mondu GmbH can be found here.

Technical Buyer Onboarding

To be able to use the Digital Trade Account feature, buyers first have to go through Mondu's buyer onboarding flow. This is done using the Create trade account API call:

{
  "redirect_urls": {
    "success_url": "https://yoursite.com/buyer_success",
    "cancel_url": "https://yoursite.com/buyer_cancel",
    "declined_url": "https://yoursite.com/buyer_declined"
  },
  "company_details": {
    "registration_address": {
      "country_code": "DE",
      "city": "Berlin",
      "zip_code": "10179",
      "address_line1": "Alexanderstr. 36"
    }
  },
  "external_reference_id": "buyer-01"
}

{
  "hosted_page_url": "https://onboarding.demo.mondu.ai?session_uuid=020b95dc-69da-45da-a37a-0bda12be8824&session_token=0e296567-1afb-4c71-9879-60fefc72335e"
}

Only redirection URLs to your site, an address and a buyer ID are required, though it's beneficial to add all known company details for the buyer here, so buyers don't have to fill in their data twice.

Afterwards, you'll have to redirect the buyer to Mondu's Hosted Onboarding Page:

Buyers can be onboarded on Mondu's system with the follwing statuses: accepted, declined and pending. Refer to Pending States for info on how to treat pending buyers.

If a buyer is in pending, Mondu will review them manually and either accept or decline them within 48 hours. You will be notified of the final decision by a Webhook.

{
  "topic": "buyer/{TOPIC_NAME}",
  "buyer": {
    "uuid": "12345667-890a-bcde-f123-34567890abcd",
    "state": "accepted",
    "external_reference_id": "buyer-01",
    "company_name": "2023-02-07T15:14:22.301Z",
    "first_name": "John",
    "last_name": "Smith",
    "legal_form": "Einzelunternehmen"
  }
}

📘

Buyer UUID

Keep note of the buyer uuid in the webhook, as this uuid will be used in subsequent order requests.

Orders for Onboarded Buyers

Once onboarded, you can start creating orders for your trade account buyers: Create Order

Legal Requirements

Please again make the buyer aware of Mondu's data processing policy.

Information on the processing of your personal data by Mondu GmbH can be found here.

Necessary Parameters for Digital Trade Account

Make sure to use Mondu's Hosted Checkout and send the Buyer UUID from the webhook before in the buyer object.

{
  "currency": "EUR",
  "billing_address": {
    "country_code": "DE",
    "city": "Berlin",
    "zip_code": "10179",
    "address_line1": "Alexanderstr. 36"
  },
  "shipping_address": {
    "country_code": "DE",
    "city": "Berlin",
    "zip_code": "10179",
    "address_line1": "Alexanderstr. 36"
  },
  "language": "en",
  "buyer": {
    "is_registered": false,
    "uuid": "12345667-890a-bcde-f123-34567890abcd",
    "email": "[email protected]",
    "first_name": "John",
    "last_name": "Smith"
  },
  "payment_method": "billing_statement",
  "source": "hosted",
  "state_flow":"authorization_flow",
  "external_reference_id": "order-01",
  "gross_amount_cents": 10000,
  "success_url": "https://yoursite.com/order_success",
  "cancel_url": "https://yoursite.com/order_cancel",
  "declined_url": "https://yoursite.com/order_declined",
  "lines": [
    {
      "tax_cents":190,
      "line_items": [
        {
          "quantity": 1,
          "external_reference_id": "product-01",
          "title": "product",
          "net_price_per_item_cents": 10000
        }
      ]
    }
  ]
}

Invoices

Create Invoice requests work exactly like with Mondu's other products. Make sure to issue an invoice whenever you ship an order for onboarded buyers.

Legal requirements

Please refer to Mondu Invoice Snippets for Collective Statement for legal information that has to be present on your Invoices.

Credit Notes

Credit Notes work exactly the same when issued in a Digital Trade Account context. Just make sure to create them before the billing period ends if you want to prevent already credited invoices showing up in the collective statement.

Consolidated Statement

When the billing period is over, the buyer will receive a collective statement by Mondu, asking to pay the total amount of invoices issued in the billing period with the configured net terms.