付款

入口

    {api_domain}/upay/v2/pay

签名验证

请参考签名机制文档

请求参数说明

商户系统订单号必须在商户系统内唯一，支付失败订单的二次支付请求，请创建新的商户订单号

请求参数中关于goods_details说明

花呗分期交易请求参数

同步返回参数说明

返回的状态码请参考附录

请求示例

    {
      "total_amount": "1",
      "subject": "收钱吧",
      "dynamic_id": "281234305112341234",
      "operator": "Roy",
      "terminal_sn": "100003612347111234",
      "client_sn": "8529061153479888",
      "extended": 
    {
            "extend_params": 
        {
              "hb_fq_seller_percent": "0",
              "hb_fq_num": "12"
            }
      }
     }

返回示例

1. 交易成功

    {
       "result_code": "200",
       "biz_response": {
         "result_code": "PAY_SUCCESS",
         "data": {
           "sn": "7893259247405832",
           "client_sn": "w145206259311176",
           "client_tsn": "w145206259311176",
           "ctime": "1492506701411",
           "status": "SUCCESS",
           "payway": "3",
           "sub_payway": "1",
           "order_status": "PAID",
           "payer_login": "oyBevtwYm70JVPTFyGlvmKW3IO9U",
           "payer_uid": "oSTAxt7Rkjr7Jtk0vtf-cFWiHjcs",
           "trade_no": "4003262001201704187463804544",
           "total_amount": "101",
           "net_amount": "101",
           "finish_time": "1492506702864",
           "channel_finish_time": "1492506702000",
           "subject": "Apple iPhone 6s plus (A1699) 16G 玫瑰金色 移动联通电信4G手机",
           "store_id": "100ed809-af9a-11e5-9ec3-00163e00625b",
           "operator": "test",
           "payment_list": [
             {
               "type": "BANKCARD_DEBIT",
               "amount_total": "1"
             },
             {
               "type": "DISCOUNT_CHANNEL_MCH",
               "amount_total": "100"
             }
           ]
         }
       }
     }
   

2. 交易进行中

    {
        "result_code": "200",
        "biz_response": {
            "result_code": "PAY_IN_PROGRESS",
            "data": {
                "sn": "789200393929142",
                "client_sn": "230202l2-2-2002",
                "trade_no": "0019101002020384822248",
                "ctime": "2015-11-01 18:01:00",
                "status": "IN_PROG",
                "order_status": "CREATED",
                "total_amount ": "1000"
            }
        }
    }
   

3. 交易失败

    {
        "result_code": "200",
        "biz_response": {
            "result_code": "PAY_FAIL",
            "error_code": "EXPIRED_BARCODE",
            "error_message": "过期的支付条码",
            "data": {
                "sn": "7894259244067344",
                "client_sn": "12345677767776",
                "status": "FAIL_CANCELED",
                "payway": "3",
                "sub_payway": "1",
                "order_status": "PAY_CANCELED",
                "total_amount": "1",
                "net_amount": "1",
                "finish_time": "1449569494595"
            }
        }
    }
   

   4.支付失败

    {
        "result_code": "400",
        "error_code": "INVALID_PARAMS",
        "error_message": "total_amount金额为整数，长度不超过10位，以分为单位"
    }
   

支付接口接入常见问题

1.出现支付签名错误

如果使用的激活码是只能在一个终端上激活的，但是却在多个终端上使用，就会出现支付签名错误。一个激活码可以激活多个终端的则不会出现这个问题

2.client_sn是什么？支付失败后重新进行支付可以延用之前的client_sn吗？

client_sn:商户系统订单号，必须在商户系统内唯一。 支付失败后重新进行支付不可以延用之前的client_sn。 一笔交易中，前台订单号是唯一的，例如0001，提交支付失败后，再次提交支付请求，订单号就不能是0001了。

3.使用pay接口支付(b扫c)40s左右没输入密码支付会提示超时,需要重新调用支付接口去重新支付。

4.如果支付成功后没有拿到订单的最终状态（order_status里不是最终状态）,就需要调用查询接口获取最终状态。

哪些状态是订单最终状态

• PAID
• PAY_CANCELED
• REFUNDED
• PARTIAL_REFUNDED
• CANCELED

5.建议对接方加入一个手动查询的按钮去处理可能出现的单边账：

为了预防出现单边账，建议对接方手动加一个查询按钮，当支付完成后，如果消费者支付成功，但是终端显示支付失败或者状态不明确，这个时候可以给收银员一个手动查询订单状态的操作，如果查询得到的状态依旧不是成功，就需要联系收钱吧客服人工接入了。

6.支付成功后支付宝、微信显示信息分别是什么？

支付时需要传入商品名称，这个一方面是保留业务信息，另一方面是会展示在消费者的付款终端上。 支付成功后，微信APP上，商品信息显示的是商品名称。