Login with GoPay

A flow where users authenticate using their GoPay account via phone number.

What is Login with GoPay?

Login with GoPay allows users to sign in to a your application using their GoPay account. Authentication is handled by GoPay and uses built-in multi-factor authentication (MFA), including OTP, PIN, and face verification. After successful login and user consent, a secure token is returned to confirm the user’s identity.

Scenarios of Login with GoPay

Login with GoPay works using an input of a phone number. Based on that we are going to check if a GoPay account exists or not with it and each will have different result.

ScenarioConditionSteps RequiredOutcome
New UserGoPay account does not existOTP verification → Set display nameAccount created + Linking Token issued
Existing UserGoPay account exists, no PIN setOTP verificationLinking Token issued
Existing User with PINGoPay account exists, PIN is setOTP verification → PIN verificationLinking Token issued
GoPay Plus UserGoPay account exists and is KYC-verifiedFace Recognition (FR) onlyLinking Token issued

Once the flow is completed, a Linking Token is returned — a permanent token that links the user's GoPay account to your platform. Store this token securely as it will be used for subsequent GoPay interactions on behalf of the user.

Note: The Linking Token is issued only upon successful completion of the required verification steps. Incomplete or failed flows will not produce a token.