Versions Compared

Version Old Version 2 New Version Current
Changes made by

Khai Huynh

Khai Huynh

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Required update in FE API call

In our place order API method, under payments node, there is a field called installments. Just send the number of installments selected in the front-end.
"payment": {
    "paymentProcessorId": 0
For installments, please add the following to the payments section:
"Payment":{  
      "PaymentProcessorId":null,
      "
instalments
Instalments":
0
3,
      "
cardgatePaymentMethodId
Name":
0,    "cardgatePaymentIssuerId": 0
"DANIEL QUEIROZ",
      "
name
CreditCard":"
string
4000000000000010",
      "
creditCard
Expiration":"
string
11/2022",
      "
expiration
Cvv":"
string
123",
      "
cvv
CreditCardBrand":"
string
visa",
   
"creditCardBrand": "string",
    "cardId": "00000000-0000-0000-0000-000000000000"
  },
},

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.

Image Added

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


Sample UX

Development ticket

...

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.