通过该接口对待支付的 order 对象发起一次支付请求,每次请求时需指定用户付款的支付渠道。可以通过多次调用切换付款的渠道,同时生成多个 charge 对象。如果使用测试模式的 API Key,则不会发生真实交易。订单付款完成后,会发送 Webhooks 通知。
| 请求参数 | 描述 | 
|---|---|
| ORDER_ID required string | Ping++ 返回的 order对象的id,用于商品订单查询、退款,该参数仅需要填写在请求地址内。 | 
| charge_amount required int | 支付金额,单位分(大于 0,仅优惠券全额抵扣时可填 0)。和组合支付的金额(无组合支付则忽略)相加后,值必须等于订单中的应付金额 - 已付金额 + 已退金额。 | 
| channel required string | 支付使用的渠道(优惠券全额抵扣时,可不填)。渠道详情请参考 支付渠道属性值,若创建订单时传入了 balance_settlement,则此处不可使用balance渠道。除此之外,还支持使用自定义渠道custom,该渠道不需要真实付款,并且会同步返回成功结果。 | 
| extra conditional hash | 特定渠道发起交易时需要的额外参数,以及部分渠道支付成功返回的额外参数,详细参考 支付渠道 extra 参数说明 。 | 
| charge_order_no optional string | 支付使用的商户订单号,默认使用订单对象中的商户订单号。当商户订单号在渠道被使用时,需更换新的商户订单号。推荐使用 8-20 位,要求数字或字母,不允许特殊字符。 | 
| time_expire optional timestamp | 订单失效时间的 Unix 时间戳。时间范围在订单创建后的 1 分钟到 24 小时,创建时间以 Ping++ 服务器时间为准。默认值为订单过期时间或渠道支持的最大过期时间中较小的那一个,但不会超过 24 小时。微信默认为 2 小时,wx_wap 渠道对该参数的有效值限制为 5 分钟; upacp、upacp_pc、upacp_wap、cp_b2b、applepay_upacp渠道对该参数的有效值限制为 1 小时内;upacp_b2b对该参数的有效值限制为 1 天内;upacp_qr渠道对该参数的有效期默认为 1 天,最大为 30 天;此参数对paypal及scan类渠道无效。 | 
| combined_with optional hash | 组合支付信息。组合支付是指该次支付和另一渠道共同支付完成,目前仅支持和余额组合支付,如果订单存在未全额退款的 Charge 对象则不能组合支付。详见下方的 combined_with 参数说明 。 | 
combined_with 参数说明
| 参数 | 说明 | 
|---|---|
| channel required string | 支付使用的另一个渠道。不能和支付的 channel相同,目前仅支持balance。 | 
| charge_amount required int | 支付金额(必须大于 0)。单位分,该金额必须小于订单应付金额。 | 
| charge_order_no optional string | 该渠道使用的商户订单号,默认和支付的 charge_order_no 值相同。推荐使用 8-20 位,要求数字或字母,不允许特殊字符。 | 
返回
返回一个 order 对象,或者返回一个错误,详见 错误。
POST https://api.pingxx.com/v1/orders/{ORDER_ID}/pay待补充
待补充
待补充
待补充
待补充
待补充
待补充
curl https://api.pingxx.com/v1/orders/2001608270000004428/pay \
-H "Pingplusplus-Signature: SIGNATURE" \
-H "Pingplusplus-Request-Timestamp: 1475029155" \
-H "Content-Type: application/json" \
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC:
-d '{
	"channel": "alipay_qr",
  	"charge_amount": 800
  	}'待补充
待补充
待补充
待补充
待补充
待补充
待补充
{
    "id": "2001708140000017551",
    "object": "order",
    "created": 1502695388,
    "livemode": false,
    "paid": false,
    "refunded": false,
    "status": "created",
    "app": "app_1Gqj58ynP0mHeX1q",
    "uid": "user_007",
    "available_balance": 0,
    "merchant_order_no": "2017081400000006",
    "amount": 1000,
    "actual_amount": 800,
    "amount_refunded": 0,
    "amount_paid": 0,
    "coupon_amount": 200,
    "currency": "cny",
    "subject": "Your Subject",
    "body": "Your Body",
    "client_ip": "127.0.0.1",
    "time_paid": null,
    "time_expire": 1502781019,
    "coupon": "300317081415225500002001",
    "description": "",
    "metadata": {},
    "charge_essentials": {
        "channel": "alipay_qr",
        "transaction_no": null,
        "failure_code": null,
        "failure_msg": null,
        "credential": {
            "object": "credential",
            "alipay_qr": "http://sissi.pingxx.com/mock.php?ch_id=ch_1Kyn50DyjXbHbvnv5SGK4qDK&channel=alipay_qr"
        },
        "extra": {}
    },
    "receipt_app": "app_1Gqj58ynP0mHeX1q",
    "service_app": "app_1Gqj58ynP0mHeX1q",
    "available_methods": [
        "balance"
    ],
    "charges": {
        "object": "list",
        "url": "/v1/charges",
        "has_more": false,
        "data": [
            {
                "id": "ch_1Kyn50DyjXbHbvnv5SGK4qDK",
                "object": "charge",
                "created": 1502695440,
                "livemode": false,
                "paid": false,
                "refunded": false,
                "reversed": false,
                "app": "app_1Gqj58ynP0mHeX1q",
                "channel": "alipay_qr",
                "order_no": "2017081400000006",
                "client_ip": "127.0.0.1",
                "amount": 800,
                "amount_settle": 800,
                "currency": "cny",
                "subject": "Your Subject",
                "body": "Your Body",
                "extra": {},
                "time_paid": null,
                "time_expire": 1502781019,
                "time_settle": null,
                "transaction_no": null,
                "refunds": null,
                "amount_refunded": 0,
                "failure_code": null,
                "failure_msg": null,
                "metadata": {},
                "credential": {
                    "object": "credential",
                    "alipay_qr": "http://sissi.pingxx.com/mock.php?ch_id=ch_1Kyn50DyjXbHbvnv5SGK4qDK&channel=alipay_qr"
                },
                "description": null
            }
        ]
    }
}