Skip to main content

Technical Q&A

This section answers common technical questions developers and integrators have while working with PayHub APIs and services.

Authentication & Security​

Q1. Is it required to use a specific API version?
A. No.

Q2. Is it required to use special containers or an SDK?
A. No.

Q3. Can different data types appear in request/response?
A. Yes — for example, an integer in the request and string in the response.

Payins (Deposits / UPI Intent)​

Q1. What are the possible transaction statuses?
A. success, failed, expired, chargeback.

Q2. Which operational statuses are considered final?
A. success, failed, expired, chargeback.
Note: expired can later change to success (late bank confirmation), and success can change to chargeback or failed.

Q3. Which statuses can only be received after a redirect?
A. success, failed, expired, chargeback.

Q4. Is a transaction created before redirect?
A. Yes.

Q5. Can the customer change the deposit amount in the UPI app?
A. No — the customer cannot change the amount.

Payouts (Disbursements / IMPS)​

Q1. What are the possible transaction statuses?
A. pending, success, failed.

Q2. Which statuses are final?
A. success, failed.

Callbacks & Webhooks​

Q1. Which transaction statuses trigger callbacks?
A. Only final statuses trigger callbacks.

  • Payins: success, failed, expired, chargeback
  • Payouts: pending, success, failed

Q2. What is the webhook retry mechanism?
A. 5 retries are performed at intervals of 5 minutes if your endpoint is unavailable.

Q3. How should errors be handled if the server responds with a code other than 200?
A. Treat the request as failed/rejected.

Endpoints & URLs​

Q1. Which base URLs should be used?
A.

  • Payins: https://server.payhub.link
  • Payouts: https://payout.payhub.link

Q2. What is the lifetime of the redirect URL (responseData.url)?
A. Expiry is 15 minutes and cannot be configured in the Dashboard.

Errors & Troubleshooting​

Q1. What are the possible error codes?
A.

  • Payins: 200, 400, 401, 403, 500
  • Payouts: 200, 400, 401, 403, 422 (low balance), 500

Q2. Are icons for GSX and each payment method (UPI, IMPS) available?
A. Yes.

Other Details​

Q1. Do you support currencies with 0 or 3 minor units (e.g., KWD 15.375)?
A. Amounts with up to 2 minor units are recommended (e.g., 2.35).