Introduction
PayU provides payment workflows for collecting online payments. Your choice of workflow affects the customer checkout experience, the data handled by your systems, and the development effort required for integration.
What is a payment gateway?
A payment gateway transfers payment information between a customer, a merchant, and the payment service. Depending on the integration, customers can pay using cards, UPI, wallets, EMI, Net Banking, and other supported payment methods.
Choose an integration path
Before you start, consider:
- Which payment methods you need to accept
- Whether your customers pay on a website, mobile app, or both
- How much control you need over the checkout experience
- Which payment data your system will handle
- Whether you need features such as saved cards, retries, recurring payments, split settlements, or payment links
- The testing, security, and operational requirements of your business
Use Choose your integration to compare the available approaches. Then use Choose your payment gateway to review PayU products and related workflows.
Why use v2 APIs?
PayU v2 APIs use structured JSON request objects and the v2 authentication format documented in the PayU v2 Authentication reference. Existing v1 integrations should continue to follow their current documentation; migration is a separate implementation project.
Authentication
- Use the canonical Authentication reference for the exact request-signature algorithm, required headers, and examples.
- Do not assume that a v1 authentication header or hash can be used with a v2 endpoint.
- Keep merchant credentials on the server side and use sandbox credentials while testing.
Structured requests
v2 request examples group related data into objects such as:
paymentMethodfor payment-method configurationpaymentCardfor card-specific data where requiredorderfor order and product informationpaymentChargeSpecificationfor supported pricing or charge informationadditionalInfofor endpoint-specific optionscallBackActionsfor payment-flow actions or URLsbillingDetailsfor customer billing informationauthorizationfor supported authorisation flows
The exact field names, types, required flags, and nesting are endpoint-specific. Use the relevant v2 reference page as the source of truth.
Security and testing
- Do not place API credentials in browser or mobile-app code.
- Use synthetic or PayU-approved sandbox data in documentation and testing.
- Validate the exact request and response examples against the target sandbox endpoint before releasing an integration.
- Confirm the production environment, endpoint, required headers, and go-live checklist before switching credentials.
Next steps
- Register for a merchant account
- Check your API key and salt
- Choose your integration
- Read the PayU v2 API Reference
Get support
If you encounter an integration issue, visit PayU Help and raise a ticket.
Updated 18 days ago
