CPAY接口文档


支付结果异步通知

支付结果异步通知

接口描述

  • 对于各类预先生成支付订单(C扫B,公众号支付,小程序支付,APP支付等)的支付方式,在订单支付成功后,若下单时传入了notify_url参数,则服务端会通过此接口通知商户端支付成功的结果。
  • 该接口的请求参数由服务端生成,返回参数是需要商户端响应的参数。
  • 有可能重复通知,商户后台系统需要做幂等处理,避免重复发送。

接口地址

支付请求中的notify_url 参数

请求方式

POST

请求头部

Content-Type:application/json

回调参数

参数 类型 必填 约束 示例
return_code string M 响应码:SUCCESS成功,FAIL失败,响应码仅代表通信 SUCCESS
return_msg string M 返回信息提示,“支付成功”,“支付中”,“参数不合法” 等 支付成功
result_code string M 支付成功:PAY_SUCCESS成功 ,PAY_FAIL失败,TRADE_REFUND 退款成功,TRADE_REFUND_FAIL 退款失败 PAY_SUCCESS
pay_type string M 支付类型,300.支付宝,400.微信,600.云闪付,700.翼支付,800.数字人民币,900.龙支付 300
pay_trace_no string M 请求支付流水号 51c7d68424e5492199cf7f4734a2b977
pay_time string M 请求交易时间,格式yyyyMMddHHmmss 20181116155621
end_time string 支付完成时间,yyyyMMddHHmmss 20181116155621
inst_no string M 机构号 900024
mch_no string M 商户号 851811130002
mch_name string M 商户名称 小猫生活
shop_no string 门店号 86000033007
shop_name string 门店名称 小猫生活
trade_no string M 平台订单号 20000002814118090716435200001
td_trade_no string 微信订/支付宝订单号 4200000337201905279610829271
qd_trade_no string 渠道订单号 MYBKJHZF2019052717474162270360
o_trade_no string 退款订单原订单号 20000131214619052717474113721
total_amount string M 支付金额,单位:分 100
receipt_amount string 商户实收金额(单位:分)= 订单金额-商户优惠金额 100
pay_amount string 用户实付(单位:分)= 订单金额-平台优惠金额-商家优惠金额 100
coupon_amount string 商家优惠金额,单位:分 0
discount_amount string 平台优惠金额,单位:分 100
user_id string 付款方用户id、微信openid、支付宝账户、qq号”等 odpmp5Y-AmAMgPE1alyynzngzfTg
attach string 附加数据,原样返回 1234
sign string M 签名 336437c53711dd466154c4162cbe1c52

参数示例:

{
    "attach": "5300640076",
    "end_time": "2019-07-20 12:36:27.0",
    "inst_no": "900052",
    "mch_name": "糖糖西饼屋",
    "mch_no": "851902260011",
    "pay_time": "20190720123623",
    "pay_trace_no": "19988763891732480",
    "pay_type": "300",
    "qd_trade_no": "",
    "receipt_amount": "9500",
    "result_code": "PAY_SUCCESS",
    "return_code": "SUCCESS",
    "return_msg": "交易成功,且可对该交易做操作,如:多级分润、退款等",
    "shop_name": "糖糖小店",
    "shop_no": "861902260012",
    "sign": "dbd1e9e9c0d47f1852cda1751876c3af",
    "td_trade_no": "2019072022001498650585123932",
    "total_amount": "9500",
    "pay_amount": "100",
    "coupon_amount": "0",
    "discount_amount": "0",
    "trade_no": "20000345563319072012362422114",
    "user_id": "2088222426898650"
}

商户收到平台回调后,须返回参数:

参数 类型 约束 描述 示例
return_code string M SUCCESS接收成功,FAIL接收失败 SUCCESS
return_msg string M 返回信息提示,“支付成功”等 成功

返回示例

{
    "return_code": "SUCCESS",
    "return_msg": "成功"
}

页面列表

ITEM_HTML