How Do I Configure the Tilopay Payment Method for Installment Payments in VTEX Payment Terms?

VTEX is the platform that lets your store accept credit and debit cards in Central America and the Caribbean.

You need to install the app that interacts with the VTEX connector and payment flow. You can find it at the following link: https://{VTEXACCOUNT}.myvtex.com/admin/apps/tilopaypartnercr.tiloappcreditcard@1.0.0/install

Replace {VTEXACCOUNT} with your VTEX account to install the app.

To install this connector:

1. Click Settings

2. Then click Providers

3. Then click New Provider

4. Search for TilopayOnSite.
   

   

5. Complete the form using the API information from the Tilopay Admin Portal.

6. From the Tilopay Admin Portal.

   1. Go to the Tools module, click Platform Integration, and select VTEX from the drop-down list.

   2. Copy the API credentials into the form for your VTEX store referenced in step 5.

To create different Tilopay payment terms in VTEX:

1. Go to the Payment terms tab and click the plus sign ( + ).

2. Then select the card brands you'll process in your VTEX store: Visa, MasterCard, and Amex.

3. Then configure the Payment term as follows:

a. Status: Activate the payment term by clicking the corresponding toggle.

b. Process with affiliation: Select the TilopayOnSite connector from the drop-down list.

c. Add special condition: If you'd like, you can add special conditions to each payment term.

d. Save: Always remember to save your selections.

To configure Tilopay in VTEX for local or alternative payment methods

1. Go to the Custom payments tab and complete the fields with the requested information.

2. Then create the Payment term just as you did when configuring the TilopayOnSite connector in VTEX.

You need to do this for every payment type you want to add: card payments, recurring payments, SINPE, etc.

To configure installment payments in VTEX

To configure Installment Payments, go to the Store Settings menu in VTEX, select the Providers section, click the New Provider button, then find and select TilopayOnSite from the list.

Then enter your Tilopay API credentials in the fields shown on the screen and follow the same steps used to activate card payments, but this time select In installments to activate installment payments.

In the Total number of installments field, define the installments you'll offer using the Single format. In other words, always include the single-payment option (1) in the number of installments.

For example, if you'll only accept 2, 6, and 10 installments for Visa, enter 1,2,6,10 under Total number of installments.

You need to do the same for every card brand you'll accept for installment payments.