创建 Order 对象

通过创建 order 对象完成一笔订单的下单动作(确认一笔订单的付款信息),下单时用户可以使用优惠券对订单折扣,下单完成后该订单状态会变成 created 状态。当用户被禁用时,该请求会被拒绝。

请求参数描述
app required string订单应用,对应 app 对象的 id,查看 如何获取App ID
merchant_order_no required string商户订单号,适配每个渠道对此参数的要求,必须在商户的系统内唯一。长度限制 8~20 位,要求数字或字母,不允许特殊字符。
amount required int订单原始金额,单位为分。
currency required string3 位 ISO 货币代码,人民币为 cny
client_ip required string发起支付请求客户端的 IP 地址,格式为 IPv4 整型,如 127.0.0.1。
subject required string商品标题,该参数最长为 32 个 Unicode 字符。银联全渠道限制在 32 个字节;支付宝部分渠道不支持特殊字符。
body required string商品描述信息,该参数最长为 128 个 Unicode 字符。yeepay_wap 对于该参数长度限制为 100 个 Unicode 字符;支付宝部分渠道不支持特殊字符。
uid optional stringuser 对象的 id,默认值为 "0"。若后续需使用 balance 渠道进行支付,则此参数必传,且支付 extra 参数 user 无需传。若订单使用优惠券,则此处需传入接收优惠券的用户 id。
coupon conditional string使用的 coupon 对象的 id。此参数需要与 uid 同时传入。
actual_amount conditional int订单应付金额,单位为分。值为订单原始金额减去优惠券折扣金额(amount - coupon_amount)。传入该值则校验是否和 Ping++ 计算出的应付金额一致,不传则不校验。
time_expire optional timestamp订单过期时间,用 Unix 时间戳表示。时间范围在订单创建后的 5 分钟到 7 天,默认值为 1 天,创建时间以 Ping++ 服务器时间为准。如果订单到达过期时间仍未完成付款,则会自动变为 canceled 状态。
receipt_app optional string收款方 app 对象的 id,默认为订单应用。订单使用收款方应用的渠道参数进行支付。
service_app optional string服务方 app 对象的 id,默认为订单应用。表示承接该交易服务的应用,由服务方和平台确定订单的层级链都能查询到该 order 对象。
royalty_users optional list分润的用户信息列表,默认为[],不分润。详见下方的 royalty_users 字段说明
royalty_template optional string使用的 royalty_template 对象的 id。该参数与 royalty_users 同时传时将会被忽略。
balance_settlement optional hash余额结算信息。订单支付完成时,将扣除用户手续费后的支付金额结算到指定的用户余额账户。仅对开通了 balance 渠道的应用有效。详见下方的 balance_settlement 字段说明
description optional string附加说明,最多 255 个 Unicode 字符。
metadata optional hash详见 元数据
royalty_users 字段说明描述
user required string分润的 user 对象 id
amount required int分润的金额,单位为分。
balance_settlement 字段说明描述
user required string结算的 user 对象的 id
user_fee optional int结算时收取的用户手续费,由被结算用户承担,单位分,默认值为 0。

返回

返回一个 order 对象,或者返回一个错误,详见 错误

定义

POST https://api.pingxx.com/v1/orders
待补充
待补充
待补充
待补充
待补充
待补充
待补充

请求示例

curl https://api.pingxx.com/v1/orders \
-H "Pingplusplus-Signature: SIGNATURE" \
-H "Pingplusplus-Request-Timestamp: 1475029155" \
-H "Content-Type: application/json" \
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC:
-d '{
 "app": "app_1Gqj58ynP0mHeX1q",
  "uid": "user_007",
  "merchant_order_no": "2017081400000006",
  "coupon": "300317081415225500002001",
  "amount": 1000,
  "client_ip": "127.0.0.1",
  "currency": "cny",
  "subject": "Your Subject",
  "body": "Your Body",
  "time_expire": 1502781019
}'
待补充
待补充
待补充
待补充
待补充
待补充
待补充

返回示例

{
    "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": null,
    "metadata": {},
    "charge_essentials": {},
    "receipt_app": "app_1Gqj58ynP0mHeX1q",
    "service_app": "app_1Gqj58ynP0mHeX1q",
    "available_methods": [
        "balance"
    ],
    "charges": {
        "object": "list",
        "url": "/v1/charges",
        "has_more": false,
        "data": []
    }
}