EBANX Installment Payment in Brazil

Owned by Khai Huynh
Last updated: Nov 26, 2018

Context

We need to offer credit card payment installment payment in Brazil. This will be within the credit card payment method and allow the customer to pay outright or select their card to be charged each month for a period of 2-12 months (12 options). This can be a drop down menu that defaults to pay in full. They can select how many payments they would like to make on the purchase.

Approach

First, we need the capability setup on CRM and then we need to have the front end be able to send this to CRM and CRM to Ebanx with the details.

Initially, this should be set up for TV Surf BR and TV Radius BR campaigns.

Required update in FE API call

For installments, please add the following to the payments section:
"Payment":{  
      "PaymentProcessorId":null,
      "Instalments":3,
      "Name":"DANIEL QUEIROZ",
      "CreditCard":"4000000000000010",
      "Expiration":"11/2022",
      "Cvv":"123",
      "CreditCardBrand":"visa",
   },

Requirements for widget

  • Should allow to select multiple installment periods. E.g. 1-12 months, 3-6-9 months, or 4-5-6 months.
  • Should allow to select a default installment period.
  • Add installment payment information to product list based on the selected period.

Reference Design: https://dfoglobal.invisionapp.com/share/NMJXHNNA8SB


Sample UX

Development ticket

DFSB-413 - Getting issue details... STATUS

Documentation

Feedback from EBANX

Here is some feedback we received from Ebanx:
  • Installments: Regarding theinstallmentsimplementation, I'd like to share some important information that will help you better understand how it works and also the best way to work with this important local credit card feature:
    • How it works: Basically, the client will share the total payment amount between smaller amounts throughout each month. For example: if a purchase cost USD 100 and the client chooses to pay in 3 times, he will pay USD 33.33 each month, during 03 months. In Brazil, the client may choose to pay all at once (1x) or to divide the payment up to 12 months (12x). However, it's usual to see similar merchants like DFO offering up to 3installmentswith or without additional cost. 
    • How the customer usually pay byinstallments: The customers choose how manyinstallmentsthey would like to pay by themselves at the checkout page. It means that the major websites that offerinstallmentswork with a multi-checkbox (drop-down menu) where the customers can choose the number ofinstallments, as the template below:

  

    • InstallmentFee:As a default, we charge theinstallmentrate from the merchant. However, you may choose to absorb this cost, split it with the client, or transfer the totalinstallmentfee to your customer. This decision should be also applied in your integration process at the pricing set. As the checkout-template shows above, the term "sem juros" means that the merchant will absorb the cost of offering theinstallmentto the customer. However, below is another model where the merchant chooses to absorb the cost only until a specific number ofinstallmentsand charge the corresponding interest for the rest of it.