Technical Q&A

Technical Q&A

Common technical questions and answers for PayHub API integrators.


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 a 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 may later become success (late bank confirmation)
  • success may later become 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 amount cannot be modified.


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. If your endpoint is unavailable, retries occur:

  • 5 attempts
  • Every 5 minutes

Q3. How should errors be handled if the server responds with a non-200 status?
A. Treat the request as failed or rejected.


Endpoints & URLs

Q1. Which base URLs should be used?

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

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


Errors & Troubleshooting

Q1. What are the possible error codes?

Payins:

  • 200, 400, 401, 403, 500

Payouts:

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

Q2. Are icons for GSX and payment methods (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 decimal places are recommended (e.g., 2.35).