1. 6. Repayment
Starpay Merchant Disbursement API
  • 1. Revision History
  • 2. Signature
    • 2.1 API connection check
    • 2.2 Signing a message
    • 2.3 Use the SHA256WithRSA algorithm to calculate the To-Be-Signed String
    • 2.4 Sample
    • 2.5 Method of Signature
  • 3. Procedure Diagram
  • 4. API List
  • 5. Disbursement
    • 5.1 Fund Disbursement List
      POST
    • 5.2 Fund Disbursement
      POST
    • 5.3 Fund Disbursement (Starpay to Starpay Fund Transfer)
      POST
    • 5.4 Fund Disbursement Query
      POST
    • 5.5 Disbursement State Notification
      POST
    • 5.6 Disbursement Balance Query
      POST
    • 5.7 Scan QR
      POST
    • 5.8 Fund Disbursement (Pay P2M QR)
      POST
    • 5.9 Fund Disbursement (Pay P2P QR)
      POST
  • 6. Repayment
    • 6.1 Repayment
      POST
    • 6.2 Repayment State Query
      POST
    • 6.3 Repayment State Notification
      POST
    • 6.4 Repayment Static Qr Generate
      POST
    • 6.5 Repayment Static Qr Order Notify
      POST
    • 6.6 Repayment Balance Query
      POST
    • 6.7 Edit Repayment Static QR Status
      POST
    • 6.8 Repayment transaction Query through RefNo
      POST
    • 6.9 Repayment Cancel
      POST
  • 7. Error code list
  • 8. 3rd Party Error Code List
  • 9.Instapay Error Code List
  • 10. Appendix
    • 10.1 Test demo
  1. 6. Repayment

6.8 Repayment transaction Query through RefNo

POST
https://financeapi-uat.wallyt.net/finance-payment-service/v1/starpay/refNoQuery
This interface allows merchants to query repayment orders using the Instapay RefNo provided by the user, in order to locate the user's transaction. To improve query efficiency, this interface is limited to searching for transaction orders from a specified date.

Request

Body Params application/json

Example
{
    "request": {
        "msgId": "{{timestamp}}",
        "mchId": "101510000001",
        "originalMsgId": "1754377510490",
        "service": "starpay.repayment.refno.query",
        "tradeTime": "2025-05-06T19:18:51+08:00",
        "refNo": "059050",
        "payerBank": "GCash",
        "payerName": "Luke Lee",
        "payerAccountNumber": "639488881964"
    },
    "signature": "UmpUywtNP4Jux86Dc6PsuXBmjUZSg792Rsu6/JIziuuRQuInDRhzGwHynPUotnWIQtiYKpHzAtWcE0QgWnLhT5mPWXBrZ171Yqihth5ClU5cKT8oUIv/VXTaKksYXhw6YWR7FnHmBZWUtP8P9I/fQpZzDRLiUCpTFL3i0l1hXHrVXUMp+xUfHoJrLze41tsWqgVreBAv+qgCYfh7hypCgxkUOATYqDXRr+hvBeSJ3LrpFeP+asNUS03/871x4gR3XILL+upQcf0GOeQc7xDN5oV53JHxaoyeIhaz1iDdGADVuZimbrJaYZ/Xsc2dJ2OT55nUR9Aj/Li+UHRGA8lb8A=="
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://financeapi-uat.wallyt.net/finance-payment-service/v1/starpay/refNoQuery' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request": {
        "msgId": "{{timestamp}}",
        "mchId": "101510000001",
        "originalMsgId": "1754377510490",
        "service": "starpay.repayment.refno.query",
        "tradeTime": "2025-05-06T19:18:51+08:00",
        "refNo": "059050",
        "payerBank": "GCash",
        "payerName": "Luke Lee",
        "payerAccountNumber": "639488881964"
    },
    "signature": "UmpUywtNP4Jux86Dc6PsuXBmjUZSg792Rsu6/JIziuuRQuInDRhzGwHynPUotnWIQtiYKpHzAtWcE0QgWnLhT5mPWXBrZ171Yqihth5ClU5cKT8oUIv/VXTaKksYXhw6YWR7FnHmBZWUtP8P9I/fQpZzDRLiUCpTFL3i0l1hXHrVXUMp+xUfHoJrLze41tsWqgVreBAv+qgCYfh7hypCgxkUOATYqDXRr+hvBeSJ3LrpFeP+asNUS03/871x4gR3XILL+upQcf0GOeQc7xDN5oV53JHxaoyeIhaz1iDdGADVuZimbrJaYZ/Xsc2dJ2OT55nUR9Aj/Li+UHRGA8lb8A=="
}'

Responses

🟢200Success
application/json
Body

Examples
{
    "response": {
        "code": "200",
        "message": "success",
        "dates": [
            {
                "trxState": "SUCCESS",
                "orderNo": "202410281100594000",
                "originalMsgId": "1730108635695",
                "tradeTime": "2025-05-06T19:18:51+08:00",
                "trxAmount": 223,
                "refNo": "20240903SPEYPHM2XXXB000000000059050"
            }
        ]
    },
    "signature": "gmBOsygbE5r6pOLJGga8UPNecUlH/1KUG5i9xxaUAJ/375MioWvTLht3MXrYqMpItMelSHls4KZRDlTV9TS9vfkuU9wNsPvtgEAYepwx5Cn1h1yV7q55qa1/scViFcwSzxRVyb6NR/fdf90sY2akJpavVfjRjoB0qjUGB7FJVYIjsQxTfpuNd90JdXUSIVA5jYvL/rpYEdqkmWKV49Mosoi/KDTGi9sOxdq6lrZ/paxfJbbJv+h5KFKdD78rQgO6NSTrdGZ22p0MRLkKSqZmWS72akebpjaxhDu/TJTQAj7TqIHK1GdSdGu9l04yTXgJds9Bufh9RrST3WjKg69NGA=="
}
Previous
6.7 Edit Repayment Static QR Status
Next
6.9 Repayment Cancel
Built with