Introduction

Get real-time updates about events happening in your division.

Nuvei for Platforms uses notifications to inform you when important events occur, such as changes to a seller’s KYC status, payout status updates, or transaction status changes. Notifications can be delivered via webhooks (HTTP callbacks) or email.

Available notification types

NotificationDescription
KYC Status UpdateTriggered when a seller’s KYC status changes. Possible statuses: MISSING_DATA, IN_PROGRESS, ACTIVE, FAILED, REJECTED.
Payout Status UpdateTriggered when the status of a payout changes. Possible statuses: WAITING, ACCEPTED, PROCESSED, RETURNED, CANCELLED, FAILED.
Transaction Status UpdateTriggered when a transaction status changes. Possible statuses: PENDING_SPLIT, PENDING_SETTLEMENT, RECONCILED, CANCELLED.

How to configure notifications

You can configure notifications through the Nuvei for Platforms dashboard or via the API.

Dashboard

Navigate to Configuration > Notifications in the dashboard. For each notification type, you can configure:

  • Webhook URL: The HTTP endpoint where you want to receive webhook notifications.
  • Email: One or more email addresses to receive email notifications. Separate multiple addresses with commas.

API

Use the notification configuration API endpoints to programmatically manage your notification settings:

  • POST /v2/notification — Create a new webhook configuration
  • GET /v2/notification — List all webhook configurations
  • PUT /v2/notification/{configurationId} — Update a webhook configuration
  • POST /api/v2/notification/email/configuration — Create a new email notification configuration
  • GET /api/v2/notification/email/configuration — List all email notification configurations
  • PUT /api/v2/notification/email/configuration/{configurationId} — Update an email notification configuration

For detailed API documentation, see the API Reference.