Skip to main content
Nuvei is a global payment provider that provides comprehensive payment processing solutions across multiple payment methods and regions. Wero is a digital wallet payment method available in Belgium and Germany that allows customers to make instant payments using their Wero account. It provides a fast and secure checkout experience for online purchases.

​
Setup

Please follow the common Nuvei instructions to get set up with Nuvei. After setting up your Nuvei account, make sure Wero is enabled as a payment method on your account. Nuvei requires the following fields to be collected during checkout for Wero transactions:
  • First name and last name
  • Billing country
  • Email address

​
Features

Nuvei Wero payments support the following features:
  • Refunds - Refund transactions in full or in part
  • Transaction synchronization - Keep payment statuses synchronized with Nuvei

​
Supported countries

Nuvei supports transactions from buyers in BE, DE.

​
Supported currencies

Nuvei supports processing payments in EUR.

​
Limitations

The following features are not supported by this connector:
  • Delayed capture - Authorization and capture must happen together
  • Partial capture - Cannot capture a portion of the authorized amount
  • Void - Cannot cancel transactions once initiated
  • Payment method tokenization - Cannot store payment methods for recurring transactions
  • Zero auth - Zero-dollar verification transactions are not supported
  • Settlement reporting - Settlement reporting is not available

​
Integration

For Wero, the default integration for Nuvei is through a redirect to a hosted payments page. Start by creating a new transaction with the following required fields. 
var transaction = await client.Transactions.CreateAsync(
  transactionCreate: new TransactionCreate()
  {
    Amount = 1299,
    Currency = "EUR",
    Country = "DE",
    PaymentMethod =
      TransactionCreatePaymentMethod.CreateCheckoutSessionWithUrlPaymentMethodCreate(
        new RedirectPaymentMethodCreate()
        {
          Method = "wero",
          RedirectUrl = "https://example.com/callback",
        }
      ),
  }
);
After the transaction is created, the API response includes payment_method.approval_url and the buyer_approval_pending status. 
{
  "type": "transaction",
  "id": "ea1efdd0-20f9-44d9-9b0b-0a3d71e9b625",
  "payment_method": {
    "type": "payment-method",
    "approval_url": "https://cdn.sandbox.spider.gr4vy.app/connectors/nuvei/apm.html?token=..."
  },
  "method": "wero"
}
Redirect the buyer to the approval_url so they can complete authentication and approve the payment. After approval the buyer is redirected to the redirect_url you provided when creating the transaction. Do not rely solely on the redirect - either poll the transaction or (recommended) rely on webhooks to detect the final status (for example capture_succeeded or failure states).

​
Testing

Testing Wero transactions in the Nuvei sandbox requires using the Wero Simulator.
  1. Initiate a Transaction: Start a Wero payment in your checkout using the Nuvei sandbox credentials.
  2. Locate the Short Code: On the Wero checkout page (or in the redirection), identify the 10-character Short Code (for example, 536-6CRN-CBT).
    • Note: You do not need to decode the full QR string; the simulator requires the short text code.
  3. Access the Simulator: Open the Wero Example Consumer PSP portal for the integration environment.
  4. Create a Test Consumer:
    • In the simulator, go to Quick Tools > Local Profiles.
    • Create a new consumer or select an existing one.
    • Ensure the consumer has a linked Account (Payment Mean). If not, add one (select SCT Inst and any country/bank).
  5. Approve Payment:
    • Click on the Consents tab for your consumer.
    • Click Give Consent.
    • Enter the Short Code you retrieved in Step 2.
    • Confirm the transaction.
Your Nuvei Wero transaction should now be approved and automatically complete.