Nuvei
Re-tokenize stored payment credentials into a merchant's Nuvei account during a processor migration.
Re-tokenize your stored payment credentials into a merchant's Nuvei account during a processor migration.
Nuvei is a token migration connection. Preczn takes payment credentials already held in the Preczn vault and creates matching tokens in Nuvei, so a merchant can begin transacting there without asking cardholders to re-enter anything. It does not route new transactions.
Nuvei does not process payments through PrecznA Nuvei connection cannot be added to a plan and will not accept a transaction. Use it to move stored credentials into Nuvei, then transact through Nuvei directly. See Supported Connections for connections that accept transactions.
Supported Capabilities
| Capability | Status | Notes |
|---|---|---|
| Card token migration | Supported | Stored cards are re-tokenized into the merchant's Nuvei account |
| Bank token migration | Supported | Stored bank accounts are re-tokenized the same way |
| Payment Processing | Not supported | Transactions cannot be routed to Nuvei |
| Merchant Onboarding | Not supported | Merchants sign up with Nuvei directly |
Adding Merchant Credentials
Nuvei requires three values, all from the merchant's Nuvei account. All three are required — a connection saved without any one of them is rejected.
| Credential | API field | Description |
|---|---|---|
| Merchant ID | mid | Identifies the merchant in Nuvei |
| Merchant Site ID | key | Identifies the site under that merchant |
| Secret Key | secret | Signs each request Preczn makes to Nuvei |
Enter them on the merchant's Nuvei connection in the Dashboard, or send them to the connection update endpoint — see Linking Existing Credentials.
Preczn verifies all three by opening a session with Nuvei before saving them, so a mistyped value is caught at configuration time rather than partway through a migration.
Token Migration
A migration reads the payment tokens already stored in the Preczn vault and creates the Nuvei equivalent for each one. Both stored cards and stored bank accounts are supported.
For each token, Preczn creates a customer record in the merchant's Nuvei account and attaches the re-tokenized payment credential to it, so the resulting Nuvei token is usable for repeat and recurring charges rather than a bare one-time reference.
Migration runs synchronously — each token's result is known as it is created, so there is no callback to wait on and no later reconciliation step.
Re-running a Migration
A migration can be run more than once safely. A token that already has a Nuvei counterpart is skipped rather than duplicated, so re-running after a partial or interrupted run picks up only what is missing.
Sensitive data never leaves the vault in the clearPreczn decrypts each stored credential only to hand it to Nuvei, and discards it immediately afterward. The underlying card and bank details are never exposed through the Preczn API, and are not returned in migration results.
FAQ
Can I route transactions to Nuvei?
No. Nuvei is a token migration connection in Preczn — it moves stored credentials into Nuvei, but new transactions cannot be routed to it. Once the tokens exist in Nuvei, transact through Nuvei directly, or route new volume to a Preczn connection that accepts transactions.
Where do I find the Merchant ID, Merchant Site ID, and Secret Key?
All three come from the merchant's Nuvei account. A merchant who cannot locate them should ask their Nuvei representative — Preczn cannot retrieve them.
Do cardholders need to re-enter their card details?
No. That is the point of a migration: the stored credential moves from the Preczn vault into Nuvei without the cardholder being involved.
What happens if a migration is interrupted?
Re-run it. Tokens that already reached Nuvei are skipped, so a second run creates only what is still missing and will not duplicate anything.
Can I migrate stored bank accounts as well as cards?
Yes. Both stored cards and stored bank accounts are re-tokenized into the merchant's Nuvei account.
Can I board new merchants to Nuvei through Preczn?
No. Preczn works with merchants who already hold a Nuvei account. Merchants sign up with Nuvei directly, then their credentials can be migrated.
Updated about 15 hours ago