获取新订单

  1. QPay
  2. 文档
  3. 获取新订单
提交订单

此功能用于生成特定数字货币的支付数据。商户可使用支付链接引导用户到 UPay 收银台付款，支付成功后系统会立即通知用户。

注意：用户必须严格按照订单金额支付，金额不一致将不处理订单。

请求参数

请求 URL
https://api.qpay.ink/apply

请求方式
POST

请求参数

名称 字段类型 是否必填？ 签名 描述
AppId string 是 是 项目 APP ID
fiatAmount number 是 是 USDT 金额，精确到四位小数
chainType string 否 否 trc20、erc20
merchantOrderNo string 是 是 商户自行生成的订单号，在商户系统内必须唯一。
notifyUrl string 否 否 接收异步通知的回调地址，必须为可直接访问的 URL，不能带参数、会话验证或 CSRF 验证。
redirectUrl string 否 否 支付成功后，前端跳转地址必须包含 http:// 或 https://
timestamp string 是 是 时间戳，用于参与签名计算
signature string 是 是 数据签名，参考下方签名算法
签名方法 (PHP)

              
function makeSignAPi($params, $appKey)
{

    $str = $params['AppId']
        .$params['merchantOrderNo']
        . $params['fiatAmount']
        . $params['timestamp'];
    return strtoupper(hash_hmac('sha256', $str, $appKey));
}
参考上述方法计算签名。

响应参数

响应体结构：

{
    "code": 1,
    "message": "success",
    "data": {
         "orderNo": "20210721111111111111111111",
         "merchantOrderNo": "20210721111111111111111111",
         "status": "pending",
         "payUrl": "https://pay.qpay.com/pay/20210721111111111111111111",
            }
}
orderNo: string, QPay 订单号。
merchantOrderNo: string, 商户订单号。
status: string, 订单状态。
payUrl: string, 支付页面，收到后跳转至此地址进行付款。