API 说明

请求类型

POST

请求 URI

/api/v1/pay/weixin/h5-pay

请求参数

字段 类型 是否必需 说明 备注
amount 字符串 交易金额 以分为单位
callbackURL 字符串 回调 URL 支付完成后系统向这个 URL 发送通知 (最大长度 255个英文字符)
returnURL 字符串 跳转 URL 支付完成后前端跳转到此 URL (最大长度 255个英文字符)
remark 字符串 用户备注 (最大长度 128个英文字符)

请求示例:

{
  "amount": "100",
  "callbackURL": "https://your.callback.url",
  "returnURL": "https://your.return.url",
  "remark": ""
}

响应结果

字段 类型 说明 备注
payInfo 字符串 支付调转 URL 用于前端页面进一步完成支付
merchantId 字符串 商家编号
paymentId 字符串 支付编号
amount 字符串 交易金额
timeZoneId 字符串 时区编码

响应示例:

{
  "status": "SUCCESS",
  "result": {
    "payInfo": "https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx072224473808596045c0658e6e43280000&package=270306995",
    "merchantId": "ON00000097",
    "paymentId": "DEMOORDERID0000010",
    "amount": "1",
    "timeZoneId": null
  }
}

获得支付结果

OTT Pay API 服务器从支付通道获得支付结果后立即将支付结果发送到指定的 callbackURL。当然商户系统也能通过 支付状态查询 API 进行主动查询。