🔁 Smart Webhooks

🔐 Secure Tokenisation

📦 Bulk Payout Support

Integrate PayHub. Fast. Secure.

Powerful APIs for Payments and Payouts

All the tools and guides you need to integrate PayHub quickly and securely.

🔁 Smart Webhooks🚀 Fast Onboarding📊 Transparent Logs🔐 Secure Tokenisation📦 Bulk Payout Support

View Full Documentation

API Version: v1.2 • Last updated: Apr 2025

📊 Transparent Logs🚀 Fast Onboarding

PayIns

Accept payments seamlessly

Collect payments instantly via UPI, cards, wallets, or netbanking. PayHub’s PayIn APIs ensure fast settlements, tokenized security, and real-time webhook support.

Endpoint: /api/v1/payin

Authentication: Bearer Token

View PayIn Docs →

PayOut

Disburse funds with precision

Disburse funds to users, vendors, or bank accounts in seconds. Ideal for commissions, refunds, and bulk payouts — complete with audit-ready logs.

Endpoint: /api/v1/payout

Authentication: Bearer Token

View PayOut Docs →

FAQ

Frequently Asked Questions

Find answers to your questions here, and don't hesitate to contact us if you don't find what you're looking for:

What are the sandbox (test) and production (live) URLs?

Sandbox/Test URL: Available in the merchant dashboard

Production/Live URL: Available in the merchant dashboard

Do I need to whitelist IPs for payouts?

Yes, IP whitelisting is required for payouts in both test and production environments.

What are the differences between test and production environments?

In the sandbox, transactions don’t need to be completed — you can simulate callbacks directly from the dashboard. In production, real money movement occurs.

Can the transaction amount or currency change during processing?

No, the amount and currency remain consistent throughout the process.

Can a successful transaction later change status?

Yes, for example, a successful transaction can later become a chargeback(payins).

Can customers pay without being redirected to the payment page?

Yes, this is possible via UPI Intent.

Will a transaction ever succeed if there’s an API or processing error?

No, transactions only succeed when a valid transaction ID is issued.

Does every error mean the transaction failed?

Yes, a transaction is only accepted if you receive a valid transaction ID.

What are the statuses available for IMPS transactions?

IMPS supports three statuses: pending, success, and failed.

Are there any integration exceptions not covered in documentation?

No, everything is covered in the documentation.

What are the minimum and maximum transaction amounts?

Payins: Min ₹100, Max ₹10,000

Payouts: Min ₹100, Max ₹50,000 (For amounts above ₹50,000, use Corporate API).

Do you have an API rate limit?

No, there are no rate limits on the API.

What is the lifetime of the payment page?

The payment page remains active for 15 minutes.

What is the transaction expiration timeout?

Deposits: 6–8 hours

Payouts: No expiry (only success or failed).

How long does transaction processing usually take?

Processing is instant (99% of the time) for both UPI Intent and IMPS.

What should I do if an error occurs during processing?

It depends on the error type. Typically, wait for webhook updates or use the check-status API.

When is a transaction considered successful?

Only after funds are successfully credited to the destination account (non-risky flow).

Do you support decimal amounts for deposits and withdrawals (e.g., 500.55)?

Yes — amounts with two decimal places are supported.

Can the transaction expiration timeout be customized per MID?

No.

Are the min/max limits the same in both test and production environments?

Yes.

Deposit (Payins): Min ₹100, Max ₹10,000

Withdrawal (Payouts): Min ₹100, Max ₹50,000

Do you support an amount mismatch flow (customer pays a different amount than initialized)?

No. If the paid amount differs from the initialized amount, the transaction is considered invalid and the amount is refunded to the customer's wallet.

Is INR the only currency used given there is no currency parameter in callback or check-status?

Yes — only INR is supported.

What response should our system return to your callback (webhook) requests?

HTTP 200 OK.

Can we share our IP addresses in chat to be added to the whitelist?

Yes.