{"section":"tutorials","requestedLocale":"en","requestedSlug":"setting-up-payments-with-nuvei","locale":"en","slug":"setting-up-payments-with-nuvei","path":"docs/en/tutorials/payments/payment-settings/setting-up-payments-with-nuvei.md","branch":"main","content":"At VTEX, it is possible to integrate with Nuvei. Through this provider, your store can make sales with credit, debit cards, OXXO, PSE, notes payable, among others.\n\nTo use Nuvei, follow the steps below:\n\n- [Configure Nuvei on VTEX](#configuring-nuvei-provider-on-vtex)\n- [Configure the DMN Url in the Cloud](#configurar-dmn-url-in-the-cloud)\n\n## Configuring Nuvei provider on VTEX\n\n1. In the VTEX Admin, go to **Store Settings > Payment > Providers**, or type **Providers** in the search bar at the top of the page.\n2. On the providers screen, click the **New Provider** button.\n3. Type the name **nuvei-payment-provider** in the search bar and click on the name of the provider.\n4. In **Provider Authorization**, fill in the **App key** and **App token** fields with with your Nuvei account information.\n5. If you wish to modify the identification name to be displayed for the Nuvei provider on the VTEX Admin screen, enter the information in the **Name** field in **Basic Information**.\n6. In **Payment Control**, select whether you want to activate the provider in a test environment by clicking **Enable test mode**.\n7. In the **Automatic settlement** field, select one of the following option:\n- **Use behavior recommended by the payment processor**: Capture is not automatic; it is scheduled according to the period specified by the acquirer. The acquirer indicates whether the payment has been authorized and can determine or recommend a number of days for the capture upon payment authorization. (This is the platform's default behavior).\n- **Automatic capture immediately after payment authorization**: Capture is automatically performed right after payment authorization, even if the transaction includes an anti-fraud analysis.\n- **Automatic capture immediately after anti-fraud analysis**: Capture is automatically performed right after payment authorization and anti-fraud analysis. If you select this behavior and do not have anti-fraud analysis, the system will perform the payment capture as in \"Automatic capture immediately after payment authorization\".\n- **Disabled**: Capture takes place only when the order is invoiced. If you select this behavior, it is important to pay attention to the invoicing time, as invoicing can exceed the capture time agreed with the payment provider and lead to the cancellation of the transaction.\n\n8. If you want to use [payment split](/en/docs/tutorials/split-payment) in your store, select the option **Enable payout split and send payment recipients** and indicate the **Accountable for payment processing charge** and **Accountable for chargebacks** (marketplace, sellers or marketplaces and sellers).\n9. To fill in the fields **Merchant Id**, **Merchant Site Id** and **Client Secret** (Secret Key), access the information available in **Settings > My Integration Settings** within the control panel of your account in the Nuvei environment.\n\n> ⚠️ Nuvei has specific credentials (Merchant Id, Merchant Site Id and Client Secret) for each type of environment. Access the test [(Integration)](sandbox.nuvei.com) and [Live](cpanel.nuvei.com) environments to identify the credentials relating to each of them.\n\n10. In **Environment**, select whether you want to configure the Nuvei provider in the **Integration** or **Live** environment.\n11. In **Test 3ds challenge Integration only**, if you have selected the test environment (**Integration**) it is possible to perform 3DS security tests using the **Force 3ds Challenge**, **Force 3ds Frictionless** or **User cardHolder name** options. For more information about the tests, access the [Nuvei](https://docs.nuvei.com/documentation/integration/testing/testing-cards/?highlight=test%20cards#3d-secure-v2-test-scenarios) documentation.\n\n> ⚠️ Whenever the provider's **Environment** is configured as **Live**, the option selected for the **Test 3ds challenge Integration only** field must be **User cardHolder name**.\n\n12. In **3DS**, select whether you want to use 3DS authentication.\n13. In **Marketplace (Split) - Payaut API Key** and **Marketplace account code - Payaut**, fill in as indicated by the provider.\n14. Click `Save`.\n\n## Configuring DMN Url on Nuvei\n\nTo configure DMN Url information on Nuvei, follow the steps below:\n\n1. Access your Nuvei test environment ([Integration](sandbox.nuvei.com)) or [Live](cpanel.nuvei.com).\n2. On the **Settings** menu, click **My Integration settings**.\n3. In **DMN URL**, replace the **\\{account-name\\}** field with the name of your VTEX account.\n\n`https://master--{account-name}.myvtex.com/_v/api/nuvei-payment-provider/v0/dmn`\n\nTo configure the payment methods to be processed by Nuvei, access [Configuring Payment Conditions](/en/tutorial/how-to-configure-payment-conditions--tutorials_455#).\n\nTo set special conditions on payment methods, go to [Configuring payment special conditions](/en/tutorial/special-conditions--tutorials_456#).\n\nAfter following the indicated steps, Nuvei provider may take up to 10 minutes to appear at your store's checkout as a payment option."}