Workflow for Co-Branded Onboarding

Co-Branded (OAuth) Onboarding or OAuth Workflow (technical workflow) involves the steps as illustrated in the following diagram:

The merchant’s workflow involves the following steps:

1. Merchant clicks on the link at the partner website and gets redirected to PayU for onboarding.
2. After onboarding on PayU, they are asked to give consent to their partner for sharing their credentials.
3. On acceptance, the merchant is redirected to the URL specified in the partner account.

Example: If the redirect URL is https://abc.com, the merchant will be redirected to the following URL:

https://abc.com?auth_code=${code}&merchantId=${mid}

Note: The steps to get the merchant credentials require only two APIs. This removes the entry of merchant key and salt on a partner website. PayU recommends this for the seamless onboarding of merchants.

4. From the above authorization code, call valid Auth code and client API. For more information, refer Validate Auth Code and Client.

{{hub_base_url}}/oauth/token

Partner will get access token in response

5. Call the Credential API using the access token from Step 4. For more information, refer to Get Merchant Credentials API

{{partner_base_url}}/api/v1/merchants/{{mid}}/credential

Merchant Sign-Up Workflow with Co-Branded Onboarding

To sign up a merchant using OAuth:

1. Navigate to the OAuth link appended with the new email id in the following format:

https://onboarding.payu.in/app/account/signup?reseller_id=<Merc ID>&email=<Merchant mail ID to sign-up>

Where <Merchant ID> is substituted with reseller ID and <Merchant mail ID to sign-up> is substituted with merchant mail ID to sign-up.

For example:

https://onboarding.payu.in/app/account/signup?reseller_id=11ea-c29b-c691cce0-8256-02aa98a2d2b0&[email protected]

The Merchant Sign-up page is displayed.

2. Enter the merchant’s phone and password.
3. Click Next.

Note: If the mobile number already exists, the following message is displayed.

4. Enter the OTP sent to the mobile number that was entered by you in Step 1.

1. Enter the OTP sent to your email ID.

5. Select any of the following roles:
   • Business Owner
   • Developer
   • Customer

A list of questions is displayed on the What are you looking for from PayU? page similar to the following screenshot:

6. Provide input for each question on the What are you looking for from PayU? page.

A welcome message is displayed similar to the following screenshot.

7. Click Activate Account.

The Complete your full KYC page, similar to the following screenshot is displayed. For more information on completing your KYC, refer to Activate Account

Merchant Login Workflow with Co-Branded Onboarding

The merchant login workflow with Co-Branded (OAuth) Onboarding involves:

1. Navigate to the OAuth link appended with the new email id in the following format:

https://onboarding.payu.in/app/account?reseller_id=<Merchant ID>&email=<Merchant mail ID to sign-up>

Where <Merchant ID> is substituted with reseller ID and <Merchant mail ID to sign-up> is substituted with merchant mail ID to sign-up.

For example:

https://onboarding.payu.in/app/account?reseller_id=11ea-c29b-c691cce0-8256-02aa98a2d2b0&email=[[email protected]](mailto:[email protected])

The Merchant Login page is displayed.

2. Enter the merchant password and click Verify.

   The Authorize Your Account page is displayed.

3. Click Allow access to the account to provide consent.

   A confirmation message is displayed, similar to the following screenshot:

4. Click Back to <app name> app.