Skip to main content

General / FAQ

PayLater Installment Plans

  1. Why is the installment plans different in the Checkout URL and in the redirected page?

    • Xendit PayLater has two displayed installment plans:
      • In PayLater Plans API or Xendit Checkout: Only for estimation, the plans are defined based on your details in the API request. This will not be 100% accurate because the goal is to show an estimation for end-users and give them more information upfront before deciding which plan they should choose.
      • In the redirected page of PayLater partners': This is when end-user has been redirected and logged in to the PayLater provider. At this point, the PayLater providers have read the end-users' credit profile so that the provider can determine the plans based on their risk engine.
  2. How do PayLater Providers decide end-users' credit limit and available plans?

    • Credit Limit is determined by Paylater partners based on individual information, such as name, identity number like KTP, income, and other personal details provided sign up. Credit limit can be increased over time based on the end-users' activities. Xendit is not involved in this process.
    • To determine installment plans, Paylater providers use their risk engine with the following variables to assess installment plans:
      • In the transactional level: Items, amount, shipping address, etc. This is mainly to define the installment plans available, e.g. small amounts may not get a longer tenure.
      • Transaction history: Available credit limit, outstanding loan payments, whether end-users have been paying on time so far, etc. - This is to determine the credit limit available for the end-users.
  3. Are the installment plans for each user different?

    • Yes, the PayLater providers define installment plans using a risk engine based on end-users individual information, transaction history, and the transaction itself. Each end-users will get different available plans from the PayLater providers.

PayLater Transactions

  1. What happens later when my customer pays in installment?

    • After the transaction on your store is done, the installments will only happen between your customer and the PayLater Provider
    • The Provider will settle the full amount upfront, regardless of the plans your customers choose
    • Xendit and you will not be involved anymore in the customer repayment
  2. How do I increase my payment success rate?

    • We recommend you display the available installment plans for end-customers to decide the Provider for the payment completion
    • It is also advised to put customer educational content in your store to increase their payment success rate
  3. How do I know when the PayLater transaction is a success?

    • There are many ways to know:

      • Xendit Dashboard - Transactions : Successful PayLater transactions will be shown on Transactions

      • Xendit Dashboard - Invoice: If you are using XenInvoice, you can also check the status in the Invoice tab on the Xendit

        Dashboard. The details will reflect the information if the invoice was paid using PayLater

      • Callback/webhook: If you are using PayLater API, we will send you a callback/webhook to the Callback URL you have set on the Xendit Dashboard

PayLater Providers and End-Customers

  1. What's the average processing time for installment approval in your Partners?
    • As long as your customer has an active and enough credit limit in the PayLater Provider’s platform, the installment approval will be done instantly during the checkout process
  2. What if my customer doesn’t have enough credit limit in the PayLater provider?
    • Most likely the transaction will fail. However, if your customer increases their credit limit by completing their previous debts in the PayLater provider, they can try paying again as long as the Checkout URL has not been expired yet
    • In some cases, our Partner will prompt the end-customer to pay a downpayment and the rest will be available via installment
  3. What if my customer doesn’t have an account in the PayLater provider?
    • By clicking on the checkout URL, our PayLater provider will prompt the customer to log in or sign up to their PayLater account
    • If they don’t have an account, they can easily sign up online and get a credit limit in their instant activation
  4. Do we need customers to input their personal data?
    • Yes, we will relay the customer detailed information to our PayLater partner as it is a requirement on their end for the credit score and risk
    • However, you can save the customer details and use it for another transactions, be it for PayLater, or another payment methods in Xendit

API Integration

  1. Why am I getting INVALID_CUSTOMER_ID during Initiate PayLater Plans even though I have created the customer in advance?
    • There is a high chance that in the customer you have created during Create Customer, you did not include the required parameters inside the customer_id
    • This is because PayLater transactions require more details about customers’ data for the Provider’s credit risks.
    • So, even though the initial step (create customer), you already succeeded without some of those details, you will still get the error in initiate plans if it’s tied to a PayLater transactions.
    • Please edit or make a new customer for the PayLater transaction. You can find the list required parameters here.
  1. Do we have to give HTTPS in the callback URL to test the integration?
    • Yes, Xendit requires HTTPS for security purposes in both Test and Production environments
    • If you want to test an end-to-end flow from charge creation to receiving callbacks, please do have a proper server test using HTTPS, which complies to Xendit security guideline
    • If you want to see the callback format and general flow without having a proper server yet, you can use free webhook site for testing purposes