Interface Guideline

Request flow

---

Show terms of use and privacy policy

Koin is regulated by the central bank of Brazil and for this reason we need to follow some rules described in the terms of use. Due to some data protection legislation, the buyer also needs to agree with our privacy policy. Here is an example of how to display and request buyer consent for these two required items:

Links to the terms of use and privacy policy are as follows;

Termos of use: https://termos.koin.com.br/

Privacy policy: https://www.koin.com.br/politica-de-privacidade/

❗️

IMPORTANT

Before calling any koin method, whether availability or order, it is necessary to obtain consent that the buyer has read the terms of use and privacy policy

---

Show detailed list of installment options

It is mandatory to display all installment data, such as date of the first installment, interest rate, cet and IOF. The total financing amount should also be displayed, as shown in the example below:

---

📘

NOTE

Each installment option may contain a different interest rate or other information. Therefore, each installment option must display its respective fees and taxes

---

Show detailed by status

After the request is made to complete the financing, there may be different transaction statuses as described in Guides -> BNPL Transparent checkout. Below are highlighted the main statuses and how to display the information to the buyer:

Type: Waiting ---> Reason: FirstPayment

The financing request has been approved and created and is now awaiting the first payment to be made. At this point, it is necessary to display the PIX QR Code and the copy paste so that the buyer can pay the first installment. Only after payment of the first installment will financing be approved. Below is an example of how pix information can be displayed:

Type: Collected

After paying the first installment, the financing is finally approved. Below is an example of how it can be communicated to the buyer:

Type: Waiting ---> Reason: EmailValidation

The financing request has been created and is now awaiting email validation. At this point it is necessary to display the message so that the buyer can validate their email. Only after validating the email will the buyer be able to proceed to the pix payment flow. Below is an example of how the message might be displayed::

Type: Waiting ---> Reason: ProviderReview

The financing request has been created and is now pending provider review. At this point it is necessary to display the message so that the buyer wait the provider review process. Only after finish provider review will the buyer be able to proceed to the pix payment flow. Below is an example of how the message might be displayed:

Type: Waiting ---> Reason: WhatsAppValidation

The financing request has been created and is now awaiting WhatsApp validation. At this point it is necessary to display the message so that the buyer can validate their WhatsApp. Only after validating the WhatsApp will the buyer be able to proceed to the pix payment flow. Below is an example of how the message might be displayed:

Type: Failed

After the validations that were left waiting or even after the financing was created, the buyer may not be able to purchase with Koin. In these cases, a message must be displayed informing the buyer. An example of how this can be demonstrated is below: