This documentation introduces the new API for accepting payments (v3), which includes updated features to simplify the integration process.
Currently, the API is available only in our staging environment. Please contact your Flip PIC or the Flip B2B API Integration team to request staging access. For detailed information on functionality, refer to the sections in this guide.
You can access the previous version of the API documentation (v2) here.
The link_id and bill_link_id fields will change from variable-length (1-10 digits) to exactly 19 digits on April 10, 2026.
All partners are expected to comply with this change no later than April 10, 2026. If your system uses INT or 32-bit integer types, you must update to BIGINT or VARCHAR before the deadline to avoid service disruptions.
Overview
Flip Checkout is a user-friendly, customizable payment solution that integrates easily into your website. Enables you to accept payments from your customers using a variety of methods, including Bank Transfers, Virtual Accounts, E-Wallets, QRIS, Credit Cards, and Retail options. Whether you choose a pop-up or redirection payment page, Flip Checkout lets you embed the payment experience with minimal code.
As a Hosted Payment Page (HPP), Flip Checkout manages the entire payment process for you, handling security and compliance so you don't have to. This makes integration simpler and faster, allowing you to focus on delivering a great user experience.
You can integrate with the Accept Payment APIs based on the specific flow you want to offer your customers.
Redirection
With the Redirection flow, customers are directed from your website to the Flip Checkout payment page to complete their transaction. After confirming the payment, they are automatically redirected back to your website to view the order confirmation or receipt.
This method is ideal if you prefer not to embed the payment process within your site and want to offload payment handling to Flip Checkout. By using the redirection flow, you can provide a seamless, secure payment experience with minimal setup, while ensuring customers return to your site after payment.
PopUp
With the Pop-Up flow, the payment process is embedded directly within your website through a modal. Customers can complete their transaction without being redirected to a separate page, offering a more seamless and integrated experience.
This method is ideal if you want to retain customers on your website while still leveraging Flip Checkout’s secure payment handling. The pop-up provides the same variety of payment methods and ensures a smooth user experience with minimal disruption.
By using the Pop-Up flow, you keep the entire payment journey on your site while still enjoying the benefits of Flip Checkout's simplicity and compliance management.