{"section":"tutorials","requestedLocale":"en","requestedSlug":"how-to-configure-a-boleto","locale":"en","slug":"how-to-configure-a-boleto","path":"docs/en/tutorials/payments/payment-methods-and-conditions/bank-slips/how-to-configure-a-boleto.md","branch":"main","content":"On VTEX, your store can sell using boleto, a Brazilian payment method. To configure this payment method, follow these steps:\n\n1. [Add the boleto provider](#adding-the-boleto-provider)\n2. [Configure payment conditions](#configuring-payment-conditions)\n3. [Validate the configuration](#validating-the-configuration)\n\n## Before you begin\n\nBefore configuring a boleto, make sure your store has:\n\n- A contract with a bank or payment provider that processes boleto. To find out which providers are available in your operation, go to [List of payment providers by country](/en/docs/tutorials/list-of-payment-providers-by-country).\n- The credentials provided by the bank or payment provider, required to add the provider in the VTEX Admin.\n- Permission to access the payments module in the VTEX Admin.\n\n## Adding the boleto provider\n\nBoleto is processed by the payment provider added to your store. To add this provider, follow these steps:\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 page, click the `New provider` button.\n3. Type the name of the provider that will process the boleto into the search bar.\n4. Complete the form fields with the data provided by your payment provider or bank.\n5. Click `Save`.\n\n> ℹ️ The fields displayed in the form vary depending on the provider. For instructions on each provider, open the corresponding article in the [Payment provider list by country](/en/docs/tutorials/list-of-payment-providers-by-country).\n\n## Configuring payment conditions\n\nTo create the boleto payment condition that will be displayed at checkout, follow the steps below:\n\n1. In the VTEX Admin, go to **Store Settings > Payment > Settings**, or type **Settings** in the search bar at the top of the page.\n2. In the **Payment Conditions** tab, click the add condition button `+`.\n3. In **Boleto**, select the option **Boleto Bancário**.\n4. Activate the condition in the **Status** field.\n5. In **Process with provider**, select the previously configured provider.\n6. (Optional) Define [special payment conditions](/en/docs/tutorials/special-conditions) for boleto.\n7. Click `Save`.\n\n## Validating the configuration\n\n1. Wait up to 10 minutes after saving the payment condition.\n2. At checkout, confirm that **Boleto Bancário** is displayed as a payment option.\n\nIf the option isn't displayed after this target, see [Troubleshooting](#troubleshooting).\n\n## Boleto due date and cancellation\n\nSome payment providers allow you to set the boleto expiration date, which determines how many days the customer has to pay it, directly on the provider's configuration page. When the provider doesn't offer this field in the VTEX Admin, you'll need to handle the configuration directly with the provider's support team.\n\nThe cancellation period for an order with an unpaid boleto depends on the boleto's validity period and the inventory reservation release period. To learn how both deadlines are calculated, go to [How long does it take to cancel an order with an unpaid \"boleto\"?](/en/docs/tutorials/how-long-does-it-take-to-cancel-an-order-with-an-unpaid-boleto).\n\n## Troubleshooting\n\nIf the boleto isn't displayed at checkout after 10 minutes, check the following possible causes:\n\n- **Inactive payment condition**: In the **Payment Conditions** tab, confirm that the **Status** field of the boleto payment condition is active.\n- **Provider doesn't support boleto**: Confirm with your payment provider or bank whether boleto is available in their system for your store.\n- **Incorrect provider in the condition**: Confirm that the **Process with provider** field indicates the provider that processes the boleto.\n\n## Next steps\n\n- [How are the payments made through boletos approved?](/en/docs/tutorials/how-are-the-payments-made-through-boletos-approved)\n- [Approving payment of the bank payment slip](/en/docs/tutorials/approving-payment-of-the-bank-payment-slip)\n- [How long does it take to cancel an order with an unpaid \"boleto\"?](/en/docs/tutorials/how-long-does-it-take-to-cancel-an-order-with-an-unpaid-boleto)\n- [Changing the logo on the boleto](/en/docs/tutorials/changing-the-logo-on-the-boleto)"}