Web Integration
Zoho Payments offers a seamless way to accept online payments through its easy-to-integrate checkout widget. By embedding the widget into your website, you can securely process transactions and enable customers to pay directly.
Prerequisite:
- Create a Zoho Payments account and complete the KYC process. For detailed instructions, refer to the Onboarding Help Documentation for detailed instructions.
- Generate an OAuth token to authenticate your API calls with Zoho Payments. This token allows secure access to the API for creating sessions and processing payments. Follow the instructions in the OAuth Help Documentation.
- Use the API key to embed the checkout widget on your website. You can view or generate it from Zoho Payments > Settings > Developer Space.
Authenticating APIs
To begin interacting with the Zoho Payments API, your application must be authenticated to ensure secure and authorized access. Authentication verifies that only approved users can make API requests. Admins or Account owners can authenticate their applications using OAuth and API keys:
- OAuth provides secure, token-based access, allowing delegated interactions between your application and Zoho Payments.
- API keys provide a simpler and more direct method for authentication.
Both OAuth and API keys are required to secure access to Zoho Payments' APIs.
Authentication Failure
To ensure seamless authentication, the OAuth credentials must be generated only by the Account Owner or a current Admin. If the Admin who generated the credentials is removed from the account or loses their Admin role, any attempt to create a payment session using those credentials will fail.
Reasons for authentication failure:
- The user is no longer an Admin or an Account Owner.
- The user has been removed from the account.
- OAuth credentials have expired or been revoked.
- API keys have been regenerated.
To resolve this, a current Admin or the Account Owner must generate new OAuth credentials. If the API key has been regenerated, ensure to use the new key for API authentication. After updating, you can create payment sessions.
If you’re facing any authentication errors, refer to the error messages to identify and resolve the issue.