Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Tutorials
Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Payments
Payment Settings
Setting up payments with Culqi
Setting up payments with Culqi

At VTEX, it is possible to integrate with the Culqi payment provider. With this provider, your store can make sales through the Culqi.

To configure Culqi, follow the steps below:

  1. In the VTEX Admin, go to Store Settings > Payment > Providers, or type Providers in the search bar at the top of the page.
  2. On the providers screen, click the New Provider button.
  3. Type the name Culqi in the search bar and click on the name of the provider.
  4. Fill in the Application Key, Application Token and Public Key fields with the data provided by Culqi.
  5. In the Payment 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".
  • Scheduled: Schedules The Automatic Capture: By selecting this option, the field Scheduled time frame in hours for automatic capture will be displayed, and it must be completed with the period in which the automatic capture will take place. This period must be in accordance with the limits allowed by the payment provider.

  • Deactivated: Not Automatically Captured: 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.
  1. In Aceptar tarjetas de crédito, select whether you want to accept credit cards as a payment method.
  2. In Aceptar YAPE, select whether you want to accept YAPE as a payment method.
  3. In Aceptar billeteras móviles, select whether you want to accept digital wallets as a payment method.
  4. In Aceptar banca móvil o internet, select whether you want to accept payments via mobile devices and internet banking.
  5. In Aceptar agentes y bodegas, select whether you want to accept payments via agents and bodegas (warehouses).
  6. In Aceptar cuotéalo BCP, select whether you want to accept payments in installments via cuotéalo BCP.
  7. In Tiempo de expiración de pago, select the period (in days) for payments to expire.
  8. In the URL de logo, Tema elegido, RSA Id, Llave pública RSA, Usuario Webhook and Password Webhook fields, enter the information provided by Culqi.
  9. In Ativar divisão e enviar recebedores?, select whether split payments will be available for the marketplace and sellers.
  10. Click Save.

Setting up the payment condition

  1. In the VTEX Admin, go to Store Settings > Payment > Settings, or type Settings in the search bar at the top of the page.
  2. In the Payment Conditions tab, click on the + button.
  3. Choose the payment condition Culqi.
  4. Fill the Rule Name field with a name of your choice for identification.
  5. Activate the condition in the Status field.
  6. If you want to use an anti-fraud system, select the option Use anti-fraud.
  7. If you want, you can also configure special payment conditions.
  8. Click Save.

After following the indicated steps, Culqi may take up to 10 minutes to appear at your store's checkout as a payment option.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback