Status Query Types on PG System
There are several types of status requery on PG system:
| Description & Script | Max Result Count | Performance | Rate Limit per Call | Time Range Limit at Live Range |
|---|---|---|---|---|
| Query by unique transaction ID: q_by_tid | 1 | Fast | 30 | 180D |
| Query by order ID : q_by_oid | 1 | Moderate | 10 | 30D |
| Query by order ID & get 10 latest matched results: q_oid_batch | 10 | Slow | 5 | 24H / 1D |
| Query by multiple order ID: q_by_oids | 10 | Slow | 5 | 24H / 1D |
| Query by multiple transaction ID: q_by_tids | 10 | Moderate | 10 | 30D |
| Query by master merchant & transaction ID: q4master_tid | 1 | Moderate | 10 | 30D |
| Query by master merchant & order ID : q4master_oid | 10 | Slow | 5 | 24H / 1D |
Important Notes
Status inquiry is a backup approach to get a final payment status in a proactive way, yet a more reliable integration should be established using 3 endpoints or webhooks to obtain real-time passive notification from the PG.
For bulk requery, best practice is to utilize one of these APIs once every half an hour for transactions with pending and unknown status only. Excessive and rapid API calls will be blocked without prior notice.
Note: No result available for transactions created more than 24 hours, 30 or 180 days, depending on the query type.