{"section":"tutorials","requestedLocale":"en","requestedSlug":"configuring-payment-with-cielo-in-vtex-sales-app","locale":"en","slug":"configuring-payment-with-cielo-in-vtex-sales-app","path":"docs/en/tutorials/payments/payment-settings/configuring-payment-with-cielo-in-vtex-sales-app.md","branch":"main","content":"At VTEX, it is possible to integrate with the payment provider Cielo. Through this connector, your store can offer payment transactions in physical stores via the **VTEX Sales App**, using points of sale (POS). For more information access [What is VTEX Sales App?](https://help.vtex.com/docs/tracks/vtex-sales-app-getting-started-and-setting-up).\n\n> ℹ️ To use the Cielo provider in your store through other online sales channels (except **VTEX Sales App**), visit [Setting up payments with CieloEcommerce](https://help.vtex.com/docs/tutorials/setting-up-payments-with-cieloecommerce).\n\nTo use the Cielo provider in the **VTEX Sales App**, you need to:\n\n- [Configure keys in the Cielo environment](#configure-keys-in-the-cielo-environment)\n- [Install payment app on VTEX](#install-payment-app-on-vtex)\n- [Configure Cielo connector (VTEX Sales App) on VTEX](#configure-cielo-connector-vtex-sales-app-on-vtex)\n- [Configure payment condition](#configure-payment-condition)\n\n> ⚠️ Settings configured in an environment external to VTEX may be discontinued or modified without prior notice. Please check your Cielo account for the latest information.\n\n## Configure keys in the Cielo environment\n\nThe following steps describe the minimum configurations to be carried out so that the Cielo connector is properly configured. Other personalized settings applied to customers, enabling specific payment methods or particular features of the platform, must be carried out in accordance with Cielo's documentation.\n\n1. Access the [Cielo developer portal](https://desenvolvedores.cielo.com.br/api-portal/en) to create a new account.\n\n    > ⚠️ The Cielo developer portal allows the user to obtain information on all the keys necessary to configure the connection between VTEX and Cielo Lio. We recommend that the procedure below be carried out by a user who already has access to the other keys in their Cielo account.\n\n2. Log in with your Cielo account.\n3. Request the creation of SalesApp keys through the [link](https://devcielo.zendesk.com/hc/pt-br/requests/new?ticket_form_id=526108) or by accessing **Suporte > Cielo Smart LIO > Envie sua pergunta > Token de integração remota** in [Cielo portal](https://devcielo.zendesk.com/hc/pt-br).\n4. Enter the following data:\n\n    - **Subject:** Request for production keys.\n    - **PDV Name:** SalesApp.\n\n5. Send the request by clicking the confirmation button.\n\n> ℹ️ The keys will be available on the Cielo developer portal within 2 business days.\n\n## Install payment app on VTEX\n\n1. In the [VTEX IO CLI](https://developers.vtex.com/docs/guides/vtex-io-documentation-vtex-io-cli-install), execute the command `vtex login {{accountName}}` to log in to your account.\n2. Install the payment app **vtex.challenge-wait-for-confirmation** by executing the command `vtex install app vtex.challenge-wait-for-confirmation`.\n\n> ℹ️ For more information, see [Payment Provider Protocol for Point of Sale (POS) - VTEX Sales App](https://developers.vtex.com/docs/guides/payments-integration-ppp-applied-to-pos).\n\n## Configure Cielo connector (VTEX Sales App) 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 **CieloEcommerce** in the search bar and click on the name of the provider.\n4. In **App Key**, enter the name of your **MerchantID** provided by Cielo.\n5. In **App token**, insert the **Client token** key generated on the Cielo developer portal.\n6. If you wish to modify the identification name to be displayed for the Cielo provider on the VTEX Admin screen, enter the information in the **Name** field in **Basic information**.\n7. In **Payment Control**, disable the test environment by unchecking the **Enable test mode** option.\n8. Leave the option **Enable payout split and send payment recipients** unchecked.   \n9. In **Integration**, select the option **Adquirencia** (Cielo 3.0 customers) or **Gateway** (Braspag customers).\n10. In **Provider**, select the option **Cielo** (Cielo 3.0 customers) or **Cielo30** (Braspag customers).\n11. In **IsSplit**, select the **False** option.\n12. In **useCieloMDR**, select the **Not Defined** option.\n13. In **UseMpi**, select the **False** option.\n14. Leave the following fields blank: **MpiClientId**, **MpiClientSecret**, **MpiMerchantName**, **MpiMCC**, **MpiEstablishmentCode** and **SoftDescriptor**.\n15. In **AntifraudProvider**, select the **Not Defined** option.  \n16. In **Antifraud**, select the **Not Defined** option.\n17. In **AntifraudSequenceCriteria**, select the **Not Defined** option.\n18. Under **Captura**, select the **Imediatamente** option.\n19. In **UseVerifyCard**, select the **False** option.\n20. In **AcceptInternationalCard**, select the **True** option.\n21. In **AcceptPrePaidCard**, select the **True** option.\n22. In **SaveCard**, select the **False** option.\n23. In **CancelRefundType**, select the **Automático Sempre que possível** option.\n24. In **CieloLIOClientId**, fill in the Lio key provided by Cielo.\n25. Click **Save**.\n\n## Configure payment condition\n\n1. In the VTEX Admin, go to **Store Settings > Payments > Settings**, or type **Settings** in the search bar at the top of the page.\n2. In the **Payment Conditions** tab, click on the `+` button.\n3. Click on **Venda Direta Debito** or **Venda Direta Credito**.\n4. Under **Process with provider**, select the previously configured connector.\n5. Activate the condition in the **Status** field.\n6. If you want to use an anti-fraud system, select the option **Use anti-fraud solution**.\n7. If you want, you can also [configure special payment conditions](https://help.vtex.com/docs/tutorials/special-conditions).\n8. Click `Save`.\n\nAfter completing these steps, the Cielo provider may take up to 10 minutes to appear as a payment option in your store's **VTEX Sales App**."}