Introduction — Supplier Payouts Export

The Supplier Payouts Export feature allows operators to generate a CSV file containing the complete list of supplier payouts, for reconciliation, reporting, and financial analysis purposes.

Exports are asynchronous: the file is generated in the background and delivered by email once ready.

This feature follows the same pattern as the Transactions Export.

Scope and Visibility

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

The export is total — it includes all supplier payouts without filter. Unlike the Transactions export, no date range or status filter is applied at export time.

Access is controlled by the user's permissions.

Launching a Supplier Payouts Export

From the Back Office

Connect to the Back Office as an operator.
Open the DJUST Pay section.
Click on the Actions menu.
Select Export Supplier Payouts.
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 will receive the same download link.

If no CC is provided, only the connected user receives the email.

Export Lifecycle

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

Possible statuses:

Status	Description
`PENDING`	Export request created and processing
`READY`	File generated and email sent
`FAILED`	Generation or email sending failed
`EXPIRED`	Download link expired

Export History

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

Columns

Column	Description	Notes
Export ID	Unique identifier of the export
Recipients	Email addresses of all recipients
Created at	Timestamp of the export request	Sortable
Status	Current status of the export

Filters

Filter	Type
Status	Multi-select
Date range	Start / end date

Filters are persisted in the URL for easy sharing and bookmarking.

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. The export must be relaunched.

API Reference

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

Trigger an Export

POST /v1/payments/supplier-payouts/export
dj-client: OPERATOR
dj-api-key: {{apiKey}}

Response: 202 Accepted

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

Request Body

Field	Type	Required	Description
`cc`	string[]	No	List of CC email addresses

Example

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

List Export History

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

Returns the paginated list of supplier payout exports, with the same columns and filters as the Back Office view.

Best Practices

Use CC for team distribution — add finance or accounting team members in CC so they receive the export file directly.
Download before expiration — export download links expire after a defined period. Download or forward the file promptly.
Monitor export statuses — check the export history page to confirm your export completed successfully.

Common Mistakes

Mistake	Consequence	How to avoid
Not downloading before link expiration	File becomes inaccessible (`EXPIRED` status)	Download the file as soon as you receive the email
Launching multiple exports simultaneously	Only one export can be in `PENDING` state at a time	Wait for the current export to complete before launching a new one

Error Reference

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

Supplier Payouts - Export