On GoPay Tokenization webview flow, users will be redirected to GoPay web page to confirm their linking and payments.
Linking
When merchant initiate linking by calling the Create Pay Account API (Legacy flow) or Get Auth Code & Registration Account Binding API (BI SNAP flow), Midtrans will return GoPay web page URL. Merchant is expected to open the page so that user can input the OTP and GoPay PIN. After completion, user will be redirected back to merchant's page.
GoPay Tokenization linking page revamp
GoPay is revamping its GoPay Tokenization linking web page on the GoPay Tokenization webview integration on June 2025.
What is new?
GoPay Tokenization linking web page will have new a new look and UI design.
Before
After
Please note that there will be a change of behavior of the GoPay Tokenization linking web page. The changes will be listed below.What are the changes in the behavior?
Change Description What merchants need to do Additional GoPay web page domain We will introduce a new domain to the GoPay web pages - we are not replacing the old one, but adding a new one on top of it.
This new domain will be used for the new GoPay PIN page.
The full domain list for linking flow:
1. https://merchants-gws-app.gopayapi.com (existing)
2. https://pin-web-client.gopayapi.com (new)If merchants apply whitelisting logic, merchant should whitelist both of the domains. Removal of inner iframe In the old linking flow, the linking form was rendered within an inner iframe on the GoPay Web Page.
As part of our ongoing efforts to enhance the user experience and improve the performance of our web pages, the inner iframe will be removed, and the form will now be rendered directly on the main page.If merchant's integration includes custom handling that relies on the presence of the inner iframe - such as reading status or errorCode after redirection from within GoPay’s iframe - merchants may need to update their implementation to support this revised structure.
GoPay Tokenization linking web page will be gradually rolled out to all GoPay Tokenization webview merchants from June 2025.Please make sure that your integration have supported these changes to prevent issue on the linking flow.
Payments
After completing linking, merchant can initiate payments by calling the Charge API (Legacy flow), Direct Debit Payment API (GoPay Tokenization non Pre Auth - BI SNAP), or Auth Payment API (GoPay Tokenization Pre Auth - BI SNAP). If transaction requires user to do PIN authorization, Midtrans will return GoPay web page URL. Merchant is expected to open the web page so user can input their GoPay PIN and complete payment.


After payment completion, user will be redirected back to merchant's page
For more information on GoPay redirection, please read our technical FAQ page or directly contact your Midtrans Sales representative so we can assist you further.