星图云开放平台
生成待支付订单
更新时间:2025-09-12 16:30:32
接口说明

生成待支付订单

调用方式

使用 API 前,需要先注册账号并完成用户认证,查看 开发指南

服务地址https://api.open.geovisearth.com/pay/access/prepay
请求方式POST 方法
接口鉴权服务密钥授权,您需要 申请 token将 token 作为必填参数拼接在服务地址中一起请求【只支持静态token】
调用限制服务调用量的限制请点击 这里 查阅
请求参数
参数类型说明必选缺省值
productNamestring商品名称 
totallong订单金额: 正整数, 单位为分 
payModestring支付枚举值: alipay, wxpay 
payChannelstring支付渠道: NATIVE, APP, H5&JSAPIOpenPlatform
callbackUrlstring回调地址: 支付成功后的回调接口地址,此接口地址需要外网可直接访问,必须为POST接口 url地址需要协议类型前缀,如:https:// http:// 
returnUrlstring跳转地址:支付成功后的跳转地址,支付宝APP、H5支付,微信的JSAP、H5需要填写 url地址需要协议类型前缀,如:https:// http:// 
clientIpstring客户端ip: 微信H5下单需要上传该字段 
timeExpireint订单超时时间,单位:分钟 
userIdstring用户的ssoUserId 
返回参数
参数类型说明
code int响应状态码
message string状态码描述
data object返回数据
 codeUrlstring信PC支付二维码链接,微信PC支付返回该字段,PC客户端生成二维码,供用户扫码支付
 h5Urlstringh5地址,支付宝H5支付返回该字段,1. 支付宝支付,客户端直接打开h5Url
 nonceStrstring微信app支付,微信JSAPI支付,返回该字段
 orderNostring订单编号
 orderSourcestring订单来源
 orderStrstring支付宝app支付返回该字段,app用该字段拉起支付宝app
 packageValuestring微信app支付返回该字段
 pageUrlstring微信H5和JSAPI返回该字段,客户端需要打开该页面
 partnerIdstring微信app支付返回该字段
 payChannelstring支付渠道
 payModestring支付方式
 payUrlstring支付宝PC支付返回该字段,是支付宝收银台页面
 prepayIdstring微信app支付返回该字段
 productNamestring商品名称
 signstring微信app支付返回该字段
 timeStampint微信app支付,微信JSAPI支付,返回该字段
 totalint订单金额
调用示例

请求示例

{
    "orderNo": "订单编号",
    "productName": "商品名称",
    "total": 1000, // 订单金额,单位为分
    "payMode": "alipay", // 支付方式,可选值为alipay或wxpay
    "payChannel": "NATIVE", // 支付渠道,可选值为NATIVE, APP, H5&JSAPI
    "orderSource": "OpenPlatform", // 订单来源
    "callbackUrl": "http://test-pay.open1.geovisearth.com/api-pay/payment/openPayCallback", // 支付成功后的回调接口地址
    "returnUrl": "http://test-pay.open1.geovisearth.com/api-pay/payment/openPayNotify?", // 支付成功后的跳转地址
    "clientIp": "192.168.1.1", // 客户端ip,微信H5下单需要上传该字段
    "timeExpire": 30, // 订单超时时间,单位:分钟
    "userId": "eca640ac-8616-4c43-9557-f500ba524419"
}

返回示例

{
    "data": {
        "orderNo": "d56b13d3c6d249b49d69f3670e49b228",
        "orderSource": "OpenPlatform",
        "payChannel": "NATIVE",
        "payMode": "alipay",
        "payUrl": "https://openapi.alipay.com/gateway.do?app_cert_sn=fa4d3373abf0daa04653d61deeca216f&alipay_root_cert_sn=687b59193f3f462dd5336e5abf83c5d8_02941eef3187dddf3d3b83462e1dfcf6&method=alipay.trade.page.pay&app_id=2021003154652517&charset=utf-8&version=1.0&sign_type=RSA2&timestamp=2024-02-29%2017%3A45%3A23&notify_url=https%3A%2F%2Fapi1.geovisearth.com%2Fpay%2Fv1%2Fnotify%2Falipay%2FOpenPlatform&return_url=http%3A%2F%2Ftest-pay.open1.geovisearth.com%2Fapi-pay%2Fpayment%2FopenPayNotify%3F&sign=RWt0qpVh4UJH7HUnIQn%2B%2Biv4d1jiCvb7eDVRJNvp1gbnGBhCrSkZmlQ8yxWLteAMreqem0eCwWcEh5PstLw3nU9dZuHrhQvfaHE7o3UMhcd9G%2FV%2BlFWoh5dc4twxfsgU%2BcEvLNqAwZpgRx1Bq8XnZEKiEA1Q7Vew04Ms%2BjMAG9YdGVXNADyNKHaKYBnMzvsa7SKlchbeUhpnXeP1EILPilykFV1WeR0Q73z2jvVf5rgG2MWB9HP8%2BVxb%2F8SLW%2Fbb5igSGhz2%2BXB6Ow8IyuL%2Fg02vVHk4NJRjxZBN%2F1CH%2BhANVER6Ct3qcy827L522v0sG8vLi7WR%2FXav73twrT7vEg%3D%3D&alipay_sdk=alipay-sdk-nodejs-3.6.1&biz_content=%7B%22out_trade_no%22%3A%22d56b13d3c6d249b49d69f3670e49b228%22%2C%22total_amount%22%3A10%2C%22subject%22%3A%22%E5%95%86%E5%93%81%E5%90%8D%E7%A7%B0%22%2C%22product_code%22%3A%22FAST_INSTANT_TRADE_PAY%22%2C%22body%22%3A%22%22%2C%22store_id%22%3A%22OpenPlatform%22%2C%22time_expire%22%3A%222024-02-29%2018%3A15%3A23%22%7D",
        "productName": "商品名称",
        "timeStamp": 30,
        "total": 1000
    },
    "message": "成功",
    "code": 200
}