Setting up payments with PayUv2
At VTEX, it is possible to integrate with the PayUv2 payment provider. With this provider, your store can make sales through cards (credit, debit, private label, cob-branded), notes payable and bank slips.
To configure PayUv2, follow the steps below:
- In the VTEX Admin, go to Store Settings > Payment > Providers, or type Providers in the search bar at the top of the page.
- On the providers screen, click the
New Provider
button. - Type the name PayUv2 in the search bar and click on the name of the provider.
- In Provider Authorization, fill in the App key and App token fields with data provided by your account PayUv2.
- If you wish to modify the identification name to be displayed for the PayUv2 provider on the VTEX Admin screen, enter the information in the Name field in Basic Information.
- In Payment Control, select whether you want to activate the provider in a test environment by clicking Enable test mode.
- In the Automatic settlement field, select one of the following option:
- 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).
- Automatic capture immediately after payment authorization: Capture is automatically performed right after payment authorization, even if the transaction includes an anti-fraud analysis.
- 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".
- 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.
- If you want to use payment split in your store, select the option Enable payout split and send payment recipients and indicate the Accountable for payment processing charges and Accountable for chargebacks (marketplace, sellers or marketplaces and sellers).
- In Provider Fields, in the Tipo Authorizacion field, select whether your payment transactions are executed in one- or two-step flows. For one-step flows, select Autorizacion y Captura. For two-step flows, select Pre-Autorizacion.
- In Public Key, enter your PayU API key.
- In Idioma, select which language should be used in the PayU system.
- In Expiración pago (días), select the period in which you want to configure the expiration of payments made by notes payable.
- Click
Save
.
To configure the payment methods to be processed by PayUv2, access Configuring Payment Conditions.
To set special conditions on payment methods, go to Configuring payment special conditions.
After following the indicated steps, PayUv2 may take up to 10 minutes to appear at your store's checkout as a payment option.