付款

入口

    {api_domain}/upay/v2/pay

签名验证

请参考签名机制文档

请求参数说明

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

同步返回参数说明

支付成功回调地址参数说明：

收到成功的回调需要响应success给服务器端

返回的状态码请参考附录

返回示例

1. 交易成功

    {
        "result_code": "200",
        "biz_response": {
            "result_code": "PAY_SUCCESS",
            "data": {
                "sn": "7894259244067349",
                "client_sn": "12345677767776",
                "status": "SUCCESS",
                "payway": "3",
                "sub_payway": "1",
                "order_status": "PAID",
                "payer_uid": "okSzXt3uY4-W8fKBH7B4z8seMzBU",
                "trade_no": "1006101016201512081965934048",
                "total_amount": "1",
                "net_amount": "1",
                "finish_time": "1449569460430",
                "channel_finish_time": "1449569460000",
                "terminal_sn": "1122234-dewls02s2",
                "store_id": "00293001928483902",
                "subject": "Domino's Pizza",
                "operator": "Kan",
            }
        }
    }
   

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上，商品信息显示的是商品名称。