Skip to main content

Overview​

Used to query the QuickPay ID information and status currently bound to the user or merchant, and to confirm whether it exists and can be used for subsequent payment operations.

Process Flow​

How It Works​

  1. Set Request Headers:
'Content-Type:application/json',
'account:995149',
'terminal:99514901',
'secureCode:12345678'
  1. Call Oceanpayment Submit Required Parameters to query the QuickPay ID.
  • order.referenceId
  • merchant.referenceId
  • customer.id
  • quickpay.id
    Select one of four options.
cURL -X POST 'https://checkout-s.oceanpayment.com/pg/quickPay/query' \
-d 
{
    "order": {
        "referenceId": "260401093541829655068",
    },
    "merchant": {
        "referenceId": "test20250116094234"
    },
    "customer": {
        "id": "",
    },
    "quickpay": {
        "id": "c6db7a28-7639-4d24-b7c5-6cd222c3e0fc",
    }
}

Handling the Response​

Check the QuickPay ID status and expiration time: quickpay.status.

{
    "message": "SUCCESS",
    "code": "000",
    "data": {
        "account": "995149",
        "terminal": "99514901",
        "order": {
            "methods": "{{methods}}",
            "referenceId": "250117093828061010584",
            "remark": "",
            "description": ""
        },
        "merchant": {
            "referenceId": "test20250117093730"
        },
        "quickpay": {
            "id": "test20250117093730",
            "status": "1",
            "expiryTime": "2030-10-01",
        },
        "customer": {
            "id": ""
        }
    }
}