本站不支持IE浏览器访问,请升级你的浏览器。 点击升级

请认准绿点支付官方网站:https://www.greenyep.com。请勿对接赌博、色情、网络欺诈等违反国家法律法规的业务! 关闭

订单创建

说明

用于生成指定平台及金额的订单数据。商户可选择直接跳转至官方的收银台供用户支付,也可以使用接口返回的数据自定义收银台。在用户支付成功后,系统将即时进行回调通知。

接口地址

POST https://www.greenyep.com/api/transaction/create

接口参数

参数名 含义 验证 类型 说明
uid 商户 uid 必填 string(16) 商户 uid。
amount 价格 必填 float 单位:元。精确小数点后2位。
type 支付方式 必填 int 支付宝:1; 微信:2
account 账号名称 选填 string(32) 通过此参数指定该订单关联的支付宝或微信账号。type = 1 时,为支付宝账号。type = 2 时,为微信账号。该参数主要用于多账户轮询。
order_id 商户自定义订单号 必填 string(64) 系统在回调商户接口时,会带上这个参数。例:201710192541。
customer_id 商户自定义用户编号 选填 string(32) 该参数会显示在后台的订单列表中,方便商户对用户付款进行对账。
product_name 商户自定义商品名称 选填 string(64) 该参数会显示在后台的订单列表中,方便商户对订单进行归类。
notify_url 通知回调网址 必填 string(256) 用户支付成功后,系统会自动发送一个 post 消息到这个网址。该参数不需要 urlencode。例如:http://商户的域名/pay_notify。
redirect_url 同步跳转网址 选填 string(256) 用户支付成功后,系统会自动跳转到这个地址。该参数不要 urlencode。例如:http://www.xxx.com/pay_return。
signature 签名串 必填 string(32) 安全校验签名串。

说明

signature 的生成规则为:toLowerCase(md5(uid + amount + type + account + order_id + customer_id + product_name + notify_url + redirect_url + token))。

接口返回

参数名 含义 类型 说明
txn_id 官方订单编号 string(128) 可通过该字段,调用支付状态查询接口,核实用户是否支付成功。
amount 订单金额 float 订单金额。
amount_pay 支付金额 float 用户实际需要支付的金额。
timeout 过期时间 int 支付过期时间,单位秒。
cahier_url 官方收银台地址 string(128) 官方收银台地址。可直接跳转至此地址供用户支付。
qrcode_url 收款码地址 string(128) 订单收款码地址。供商户自定义收银台使用。
query_url 支付结果查询地址 string(128) 订单支付结果查询地址。详细信息请参考后续订单查询接口。
signature 签名串 string(32) 安全校验签名串。

说明

signature 的生成规则为:toLowerCase(md5(txn_id + amount + amount_pay + timeout + cashier_url + qrcode_url + query_url + token))。

返回示例

    
    {
        "content": {
            "txn_id": "p3rlvc24zsgq5f5rf6j6bxik2e6q9kti",
            "amount": "1.00",
            "amount_pay": "1.00",
            "timeout": 180,
            "cashier_url": "http://www.greenyep.com/api/transaction/cashier?txn_id=p3rlvc24zsgq5f5rf6j6bxik2e6q9kti",
            "qrcode_url": "http://www.greenyep.com/api/transaction/qrcode?txn_id=p3rlvc24zsgq5f5rf6j6bxik2e6q9kti",
            "query_rl": "http://www.greenyep.com/api/transaction/query?txn_id=p3rlvc24zsgq5f5rf6j6bxik2e6q9kti",
            "signature": "0cdb5ed4b7bae2d20bd2e7c8f151eb42"
        },
        "code": 200
    }