Overview
Nuvei automatically generates the relevant Marketplace Platform Settlement Invoices and Seller Reports on a weekly/monthly basis.
These are presented in CSV (comma separated) files and are uploaded to the Marketplace Platform’s dedicated SFTP account created by Nuvei.
Seller Settlement Reports
Seller Settlement Calculations
The total payout amount to be paid to the seller is calculated as follows:
Formula:
Total seller payout =- + Gross amount =
- + Total Orders
- + Chargeback reversals
- – Total Refunds
- – Chargebacks
+ Refund commissions
+ Manual credits
– Order commissions
– Non-processing commissions
– Manual invoices
– Nuvei seller fees =- + Seller processing fees
- + Seller non-processing fees
Supporting Calculations:
Total Orders =
Total Refunds =
|
Refund commissions =
|
Manual credits =
|
Order commissions =
|
Non-processing commissions =
|
Manual invoices =
|
| Seller processing fees (contract dependent) = For example:
Seller non-processing fees (contract dependent) = For example:
|
Seller Settlement Report
| Field | Description | Example |
|---|---|---|
| TransactionID | The TransactionID in the Nuvei system. | 2110000000008863775 |
| Type | The type of transaction: Sales\Settle, Auth, Credit (refund), Chargeback, Chargeback Cancelled, Chargeback Duplicated (second chargeback) | Sales\Settle, Auth, Credit, Chargeback, Chargeback Cancelled, Chargeback Duplicated |
| Payment Method | The payment method name. | VISA, MC, Paypal |
| MerchantName | The name of the seller account. | Seller 1 |
| ClientUniqueID | The authorization/settle/sale/credit identifier from the seller system that you provided in the ClientUniqueID field. | 34991440-A |
| Country | The country of the payer, if available. | |
| UTCDateTime | The date and time in UTC format of the authorization/settle/sale/credit identifier. | 24-1-2022 17:19:44 |
| OrginalAmount | The amount of the transaction. | 200 |
| OrginalCurrency | The currency of the transaction in the Seller currency. | GBP |
| Transaction Result | The description of the transaction status in the Nuvei system. | Approved, Declined, Cancelled |
| ExchangeRate | The exchange rate used if the transaction was converted from the Seller currency to the settlement currency. | 1 |
| SettlementGrossAmount | The gross transaction amount converted to the settlement currency. | 200 |
| Settlement Currency | The settlement currency. | GBP |
| SettlementReportNumber | The Settlement Report number. | 220290000001 |
| SettlementReportDate | The Settlement Report date. | 25-1-2022 17:19:44 |
| MarketplaceCommission | The commission retained on behalf of the Marketplace Platform (sum of all order commissions) or returned by the Marketplace Platform (sum of refund commissions). | -20 |
| ExternalSellerID | ID of the Seller in the Marketplace Platform system. | 1111 |
| ExternalSellerName | The name of the Seller in the Marketplace Platform system. | Seller 1 |
| CustomData | The second authorization/settle/sale/credit identifier from the Seller system that you provided in the CustomData field. | 34991440-A |
| MarketplaceDocumentNumber | This is the payment_batch_number provided by you in the preSettlement API.It is an optional batchID that a Marketplace Platform can assign to any set of transactions in order to group them on the Settlement Report. For example, grouping related refund transaction to their order transaction, or for some other internal reconciliation purpose. | 10000000121 |
| SplitID | The Nuvei splitId to which the settle/sale/credit belongs. | 21531 |
| MarketplaceRemittedFees | The Marketplace Platform Remitted Commission (sum of all order commissions or sum of refund commissions). | -20 |
| SellerID | ID of the Seller in the Nuvei system. | 5681 |
Marketplace Platform Settlement Invoice
Marketplace Platform Settlement Calculations
The total payout amount to be paid to the Marketplace Platform is calculated as follows:
Formula:
Total Marketplace Platform payout =- + Order commissions
+ Non-processing commissions
+ Manual invoices
– Refund commissions
– Manual credits
– Nuvei Marketplace Platform fees =- + Marketplace Platform processing fees
- + Marketplace Platform non-processing fees
Supporting Calculations:
Order commissions =
|
Non-processing commissions =
|
Manual invoices =
|
Refund commissions =
|
Manual credits =
|
| Marketplace Platform processing fees (contract dependent) = For example:
Marketplace Platform non-processing fees (contract dependent) = For example:
|
Marketplace Platform Settlement Invoice
| Field | Description | Example |
|---|---|---|
| TransactionID | The TransactionID in the Nuvei system. | 2110000000008863775 |
| Type | The type of transaction: Sales\Settle, Auth, Credit (refund), Chargeback, Chargeback Cancelled, Chargeback Duplicated (second chargeback) | Sales\Settle, Auth, Credit, Chargeback, Chargeback Cancelled, Chargeback Duplicated |
| Payment Method | The payment method name. | VISA, MC, Paypal |
| MerchantName | The name of the seller account. | Seller 1 |
| ClientUniqueID | The authorization/settle/sale/credit identifier from the seller system that you provided in the ClientUniqueID field. | 34991440-A |
| Country | The country of the payer, if available. | |
| UTCDateTime | The date and time in UTC format of the authorization/settle/sale/credit identifier. | 24-1-2022 17:19:44 |
| OrginalAmount | The amount of the transaction. | 200 |
| OrginalCurrency | The currency of the transaction in the Seller currency. | GBP |
| Transaction Result | The description of the transaction status in the Nuvei system. | Approved, Declined, Cancelled |
| ExchangeRate | The exchange rate used if the transaction needs to be converted from transaction currency to the settlement currency. | 1 |
| SettlementGrossAmount | The gross transaction amount converted to the settlement currency. | 200 |
| Settlement Currency | The settlement currency. | GBP |
| PaymentMethodFee | The payment method transaction fee in the settlement currency. For cards payments with IC++ pricing, this is the final calculated value (IC + CSF + Nuvei acquiring). | 20.4 |
| TransactionFee | Used for refund fee and chargeback fee. This is in the settlement currency. | 10.2 |
| SettlementReportNumber | The Settlement Report number. | 220290000001 |
| SettlementReportDate | The Settlement Report date. | 25-1-2022 17:19:44 |
| MarketplaceCommission | The Marketplace Platform Commission retained from the Seller (sum of all order commissions) or returned to the Seller (sum of refund commissions). | -20 |
| ExternalSellerID | ID of the Seller in the Marketplace Platform system. | 1111 |
| ExternalSellerName | The name of the Seller in the Marketplace Platform system. | Seller 1 |
| CustomData | The second authorization/settle/sale/credit identifier from the Seller system that you provided in the CustomData field. | 34991440-A |
| MarketplaceDocumentNumber | This is the payment_batch_number provided by you in the preSettlement API.It is an optional batchID that a Marketplace Platform can assign to any set of transactions in order to group them on the Settlement Report. For example, grouping related refund transaction to their order transaction, or for some other internal reconciliation purpose. | 10000000121 |
| SplitID | The Nuvei splitId to which the settle/sale/credit belongs. | 21531 |
| MarketplaceRemittedFees | The Marketplace Platform Remitted Commission (sum of all order commissions or sum of refund commissions). | -20 |
Last modified May 2024