Enable Co-Branded Onboarding (OAuth) for Partners
The following are the major steps involved to enable Co-Branded Onboarding (OAuth) for partners:
- Create a partner account at https://partner.payu.in if required. For more information, refer to Register a Partner Account
- Request enablement of OAuth with your PayU Key Account Manager. You need to ensure that the following OAuth scope is configured for your account.
Scope name: credentials_using_oauth- Configure the URLs in the application. For more information, refer to Configure URLs and Logo.
- Update the brand logo and theme colour for the onboarding journey and save.
Note: Brand Logo should be in jpg/jpeg, less than 5MB in size, and width and height should be 90 pixels. For more information on configuring the brand logo, refer to Configure URLs and Logo.
-
Show case the onboarding URL details at your website so that your merchants can sign up:
{{onboarding_base_url}}/app/account?reseller_id={{reseller_id}}
Note: The following environment or base URLs must be used based on the Test or Production environment:
| Test | <https://uat-onboarding.payu.in> |
| Production | <https://onboarding.payu.in> |
- Merchants can perform any of the following steps:
- For merchants who need to register, refer to Workflow for Co-Branded Onboarding
- For merchants who have already registered, refer to Workflow for Co-Branded Onboarding
The partner can pass the email of the merchant in the URL and the user will be taken to the Sign-in or Signup page. For example:
Here, the state parameter is the unique identifier of the session. Once the merchant is redirected beck to your platform, PayU will post the merchant id, auth code & the same state parameter to your configured redirect URL.
Sample Oauth Callback payload
After the successful completion of the oauth, PayU will trigger a callback to Partner's callback URL which will consist the Merchant ID that was created during the signup, the authcode, & the state parameter that was sent in the Oauth link.
https://xn6vqico31.execute-api.ap-south-1.amazonaws.com/prod/webhook/payu?auth_code=ce38ce1370c46e6830067d2726f3e254b0ea1d271788300ac9e4f347e9587aeb&merchantId=8235901&reseller_id=11ec-ccfb-4a042936-a698-0a696b110fde&state=null