{"section":"tutorials","requestedLocale":"en","requestedSlug":"setting-up-payments-with-iugu","locale":"en","slug":"setting-up-payments-with-iugu","path":"docs/en/tutorials/payments/payment-settings/setting-up-payments-with-iugu.md","branch":"main","content":"iugu is a VTEX partner solution that offers the following payment options through [transparent checkout](/en/docs/tutorials/what-is-transparent-checkout): credit card, pix and bank slip. Furthermore, it is possible to carry out [recurrence](/en/docs/tutorials/how-to-set-up-recurrence-in-payment-conditions) and [split payment](/en/docs/tutorials/split-payment) operations (receivables and transactions) between marketplaces.\n\nTo add iugu to your store, follow the steps below:\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 __iugu__ in the search bar and click on the name of the provider.\n4. In the __App key__ and __App token__ fields, enter the information provided by iugu ([Account ID and API Key](https://dev.iugu.com/docs/configurando-conector-iugu-na-vtex#localizando-id-da-conta-e-chave-api-no-painel-da-iugu)).\n5. If you wish to modify the identification name to be displayed for the iugu 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. 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 charges__ and __Accountable for chargebacks__ (marketplace, sellers or marketplaces and sellers).\n8. If you wish to use the bank slip as a payment method, in __Provider fields__, fill in the field __Prazo de vencimento do boleto (em dias)__ with the same value configured in your customer area on the iugu portal.\n9. In __Tempo limite de validade do Pix (minutos)__, select the period available for the customer to make the payment through Pix.\n10. Click `Save`.\n\n## Setting up payment conditions\n\nTo process credit card, pix and bank slip payment methods with iugu in your store, 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 on the `+` button.\n3. Click on the desired payment method (credit card brand name, pix or bank slip).\n4. Fill the __Condition name__ field with a name of your choice for identification.\n5. Activate the condition in the __Status__ field.\n6. In __Process with provider__ select the iugu option.\n7. For credit card payments, select whether you want to use an anti-fraud system by selecting the __Use anti-fraud solution__ option. It is also possible to configure whether credit card payments should be made [in full or in installments (with and without interest)](/en/docs/tutorials/how-to-configure-payment-conditions#payment-in-full).\n8. If you wish, you can also configure [special payment conditions](/en/docs/tutorials/special-conditions).\n9. Click `Save`.\n\nAfter following the indicated steps, iugu provider may take up to 10 minutes to appear at your store's checkout as a payment option.\n\n> ⚠️ Before carrying out transactions by credit card, PIX or bank slip with iugu in your store, check whether these payment methods are already enabled in [your customer area on the iugu portal](https://dev.iugu.com/docs/configurando-conector-iugu-na-vtex#configurando-condi%C3%A7%C3%B5es-de-pagamento).\n\n## Setting up split payment on the marketplace with iugu\n\nTo process payments on [marketplace with split payment](/en/docs/tutorials/payments-in-vtex-marketplaces#payment-split) with iugu it is necessary to register sellers of your store with the same CNPJ (seller identification number) in the VTEX Admin and in your customer area on the iugu portal.\n\nFind out more about creating sellers on VTEX at [Adding a seller](/en/docs/tutorials/adding-a-seller) and access iugu documentation to create subaccounts (sellers) via [area of client](https://support.iugu.com/hc/pt-br/articles/4411276874779-Como-criar-uma-subconta-pelo-painel-iugu-) or [API](https://dev.iugu.com/docs/configurar-subconta-por-api).\n\n### Enable payout split with iugu\n\nTo enable payout split with iugu in your store, follow the steps below:\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. Type the name __iugu__ in the search bar and click on the name of the provider.\n3. In __Details__, click on the `Edit` button.\n4. In __Payment control__, 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).\n5. Click `Save`.\n\n> ⚠️ The payout split option is not available for use in a test environment.\n\nAfter following the steps indicated, the payout split functionality with the iugu provider may take up to 10 minutes to be activated in your store.\n\n> ⚠️ To define specific commissions for each seller in your store, access **Marketplace > Sellers> Management** in the VTEX Admin, select the desired seller and enter the commission values in **Commissions**.\n\n## Setting up recurrence with iugu\n\nTo make [recurrence](/en/docs/tutorials/how-to-set-up-recurrence-in-payment-conditions) available as a special payment condition through iugu, it is necessary:\n\n- Enable recurrence mode in the VTEX Admin.\n- Configure credit card or bank slip payment methods in the VTEX Admin and iugu.\n- Configure the [subscriptions](/en/docs/tutorials/how-to-configure-subscriptions) functionality in your store."}