Introduction — Marketplace Payouts Export

The Marketplace Payouts Export feature allows operators to generate a CSV file containing marketplace payout data for reconciliation, financial reporting, and analysis purposes.

Marketplace payouts represent the commissions earned by the marketplace on supplier transactions. This export provides a detailed view of all marketplace payouts and their statuses.

Exports are asynchronous: the user triggers the export, and once the file is generated, an email with a download link is sent automatically.

This feature follows the same pattern as the Supplier Payouts - Export and Funding Transfers - Export.

Scope and Visibility

The marketplace payouts export is available to operators only (dj-client: OPERATOR).

The export includes all marketplace payouts for the tenant.

Launching a Marketplace Payouts Export

From the Back Office

• Connect to the Back Office as an operator.
• Open the DJUST Pay section.
• Navigate to Marketplace Payouts.
• Click on Export CSV.
• Optionally add CC recipients in the modal.
• Confirm the export.

Email Delivery

Once the file is generated, an email containing the download link is sent to the connected user (the user who initiated the export).

When launching the export, the user may optionally provide CC email addresses:

• The CC field accepts valid email addresses.
• Multiple emails must be comma-separated.
• All recipients (main recipient and CC) receive the same email with the same download link.

✅

Tip: If the email is lost or not received, you can resend it without regenerating the export — see the Export Email Resend feature.

Export Lifecycle

The export request does not immediately return the file. It is processed asynchronously.

Possible statuses:

flowchart LR
  %% Styles (Readme)
  classDef create   fill:#e8f1ff,stroke:#2f6feb,stroke-width:2px,color:#0b3d91;
  classDef read     fill:#ede9fe,stroke:#7c3aed,stroke-width:2px,color:#1e1b4b;
  classDef update   fill:#e0f7fa,stroke:#06b6d4,stroke-width:2px,color:#0c4a6e;
  classDef add      fill:#ecfdf5,stroke:#10b981,stroke-width:2px,color:#064e3b;
  classDef remove   fill:#fee2e2,stroke:#ef4444,stroke-width:2px,color:#7f1d1d;
  classDef decision fill:#fff4e5,stroke:#f59e0b,stroke-width:2px,color:#7a3e00;
  classDef place    fill:#dcfce7,stroke:#16a34a,stroke-width:2px,color:#14532d;
  classDef sys      fill:#f2f4f7,stroke:#475569,stroke-width:2px,color:#111827;
  classDef ok       fill:#ecfdf5,stroke:#10b981,stroke-width:2px,color:#064e3b;
  classDef stop     fill:#fee2e2,stroke:#ef4444,stroke-width:2px,color:#7f1d1d;

  A["📘 Launch export"]:::create
  B["⏳ PENDING"]:::update
  C{{"📩 Generation result"}}:::decision
  D["✅ READY<br>Email sent"]:::place
  E["❌ FAILED"]:::stop
  F["⏰ EXPIRED<br>Link no longer valid"]:::sys

  A --> B --> C
  C -->|Success| D
  C -->|Error| E
  D -->|After expiration| F

  style A rx:8,ry:8
  style B rx:8,ry:8
  style D rx:8,ry:8
  style E rx:8,ry:8
  style F rx:8,ry:8

Export History

A dedicated page in the Back Office displays the history of marketplace payout exports.

Columns

Filters

Downloading

• When status = READY: the file can be downloaded directly from the export history page.
• When status = EXPIRED: the download link is no longer valid. Use the Export Email Resend feature to get a new email, or relaunch the export.

API Reference

The marketplace payouts export is also available programmatically via the DJUST API.

Trigger an Export

POST /v1/payments/marketplace-payouts/export
dj-client: OPERATOR
dj-api-key: {{apiKey}}
Content-Type: application/json

Request Body

Example

{
  "cc": ["[email protected]", "[email protected]"]
}

Response: 202 Accepted

The export is queued for asynchronous processing. The file will be sent by email once generated.

List Export History

GET /v1/payments/marketplace-payouts/export
dj-client: OPERATOR
dj-api-key: {{apiKey}}

Returns the paginated list of marketplace payout exports, with their current status.

Get Export Detail

GET /v1/payments/marketplace-payouts/export/{exportId}
dj-client: OPERATOR
dj-api-key: {{apiKey}}

When the export status is READY, the response includes a download URL for the CSV file.

Best Practices

1. Use CC for team distribution — add finance or accounting team members in CC so they receive the export file directly.
2. Download before expiration — export download links expire after a defined period. Download or forward the file promptly.
3. Monitor export statuses — check the export history page or API to confirm your export completed successfully.
4. Use the email resend feature — if an email is lost, resend it via POST /v1/exports/{exportId}/resend-email instead of regenerating the entire export.

Common Mistakes

Error Reference

For the complete list of DJUST error and warning codes, refer to the dedicated page: Error / Warning codes

Related Documentation

• Marketplace Payout Lifecycle
• Supplier Payouts - Export
• Funding Transfers - Export
• Export Email Resend
• Introduction to Djust Pay