银联商务天满服务平台
Java PHP Python



import com.chinaums.open.api.OpenApiCache;
import com.chinaums.open.api.OpenApiContext;
import com.chinaums.open.api.constants.ConfigBean;
import com.chinaums.open.api.internal.util.http.HttpTransport;
import java.util.UUID;

public class OpenApiSdkTest {
    public static void main(String[] args) throws Exception{
        String url = "https://api-mop.chinaums.com/取请求的notifyUrl值.";
        //开发者ID
        String appId = "平台分配";
        //开发者秘钥
        String appKey = "平台分配";
        //实例化客户端
        ConfigBean configBean = new ConfigBean();
        OpenApiContext context = new OpenApiContext();
        String request = "{\"connectSys\":\"\",
                    \"tid\":\"\",
                    \"bankInfo\":\"\",
                    \"billFunds\":\"\",
                    \"billFundsDesc\":\"\",
                    \"totalAmount\":\"\",
                    \"couponAmount\":\"\",
                    \"buyerPayAmount\":\"\",
                    \"invoiceAmount\":\"\",
                    \"merOrderId\":\"\",
                    \"payTime\":\"\",
                    \"seqId\":\"\",
                    \"settleDate\":\"\",
                    \"status\":\"\",
                    \"targetOrderId\":\"\",
                    \"targetSys\":\"\",
                    \"notifyId\":\"\",
                    \"signType\":\"\",
                    \"sign\":\"\",
                    \"cardAttr\":\"\",
                    \"mid\":\"\",
                    \"contractId\":\"\",
                    \"contractSignedTime\":\"\",
                    \"contractExpiredTime\":\"\",
                    \"attachedData\":\"\",
                    \"bankCardNo\":\"\",
                    \"buyerId\":\"\",
                    \"buyerUsername\":\"\",
                    \"refId\":\"\",
                    \"refundAmount\":\"\",
                    \"refundDesc\":\"\",
                    \"subBuyerId\":\"\"}";
        context.setStartTime(System.currentTimeMillis());
        context.setRequestId(UUID.randomUUID().toString().replace("-", ""));
        context.setOpenServUrl(url.split("/v")[0].concat("/"));
        context.setApiServiceUrl(url);
        context.setVersion(url.split("/")[3]);
        context.setAppId(appId);
        context.setAppKey(appKey);
        context.setConfigBean(configBean);
        context.setServiceCode(url.split("/v")[1].substring(1));
        OpenApiCache.getCurrentToken(context);
        System.out.println(HttpTransport.getInstance().doPost(context, request));
    }
}
<?php
require_once "../utils/Log.php";
require_once "../utils/Tools.php";
require_once "../DefaultOpenApiClient.php";
class DataRequest

{
    public $url = "";
    public $serviceCode = "";
    public $apiVersion ="";
    public $needToken = true;
    public $needDataTag = false;
    public $data;

    function __construct($data, $url)
    {
        $this->data = $data;
        $apiVersion = preg_split("/[/]+/s",$url)[2];
        $this->apiVersion = $apiVersion;
        $serviceCode = strstr($url,$apiVersion);
        $this->url = strstr($url,"/".$apiVersion,true);
        $this->serviceCode = preg_replace("/^" . preg_quote($apiVersion, "/") . "/", "", $serviceCode);
    }
}

class DataDemo{
    public function main(){
        $appid = "平台分配";
        $appkey = "平台分配";
        $url = "https://api-mop.chinaums.com/取请求的notifyUrl值.";
        $data = json_encode(array("connectSys"=>"",
                    "tid"=>"",
                    "bankInfo"=>"",
                    "billFunds"=>"",
                    "billFundsDesc"=>"",
                    "totalAmount"=>"",
                    "couponAmount"=>"",
                    "buyerPayAmount"=>"",
                    "invoiceAmount"=>"",
                    "merOrderId"=>"",
                    "payTime"=>"",
                    "seqId"=>"",
                    "settleDate"=>"",
                    "status"=>"",
                    "targetOrderId"=>"",
                    "targetSys"=>"",
                    "notifyId"=>"",
                    "signType"=>"",
                    "sign"=>"",
                    "cardAttr"=>"",
                    "mid"=>"",
                    "contractId"=>"",
                    "contractSignedTime"=>"",
                    "contractExpiredTime"=>"",
                    "attachedData"=>"",
                    "bankCardNo"=>"",
                    "buyerId"=>"",
                    "buyerUsername"=>"",
                    "refId"=>"",
                    "refundAmount"=>"",
                    "refundDesc"=>"",
                    "subBuyerId"=>""));
        $reqiest = new DataRequest($data,$url);
        $client = new DefaultOpenApiClient();
        $content = $client->execute($reqiest,$appid,$appkey);
        $obj = json_decode($content);
        print_r($obj->errCode);
        print_r($obj->errInfo);
    }
}
$p = new DataDemo();
$p->main();
?>
# -*- coding: utf-8 -*-
from webapi.DefaultOpenApiClient import DefaultOpenApiClient

url = "https://api-mop.chinaums.com/取请求的notifyUrl值."

class DataRequest(object):
    def __init__(self, data: dict) -> dict:
        self.data = data
        self.serviceCode = url[len(url.split("/v")[0])+len(url.split("/")[3])+1: len(url)]
        self.apiVersion = url.split("/")[3]
        self.needToken = True
        self.needDataTag = True

appId="平台分配"
appKey="平台分配"
client = DefaultOpenApiClient(appId, appKey)
cls = DataRequest({\"connectSys\":\"\",
                    \"tid\":\"\",
                    \"bankInfo\":\"\",
                    \"billFunds\":\"\",
                    \"billFundsDesc\":\"\",
                    \"totalAmount\":\"\",
                    \"couponAmount\":\"\",
                    \"buyerPayAmount\":\"\",
                    \"invoiceAmount\":\"\",
                    \"merOrderId\":\"\",
                    \"payTime\":\"\",
                    \"seqId\":\"\",
                    \"settleDate\":\"\",
                    \"status\":\"\",
                    \"targetOrderId\":\"\",
                    \"targetSys\":\"\",
                    \"notifyId\":\"\",
                    \"signType\":\"\",
                    \"sign\":\"\",
                    \"cardAttr\":\"\",
                    \"mid\":\"\",
                    \"contractId\":\"\",
                    \"contractSignedTime\":\"\",
                    \"contractExpiredTime\":\"\",
                    \"attachedData\":\"\",
                    \"bankCardNo\":\"\",
                    \"buyerId\":\"\",
                    \"buyerUsername\":\"\",
                    \"refId\":\"\",
                    \"refundAmount\":\"\",
                    \"refundDesc\":\"\",
                    \"subBuyerId\":\"\"})
response = client.execute(cls)
print(str(response.get("data")))
print(response.get("errCode"))
print(response.get("errInfo"))
print(response.get("resultCode"))
print(response.get("resultInfo"))

扣款结果通知

URL

  • 生产环境: POST https://api-mop.chinaums.com/取请求的notifyUrl值.
  • 测试环境: POST https://test-api-open.chinaums.com/取请求的notifyUrl值.

描述:扣款完成后,渠道方会通知网付前置账单系统,账单系统收到通知后会组织结果信息发送通知到商户的通知地址。商户的通知地址可以在商户信息中配置,也可以在上送详单信息时上送,若都多处都配置了通知地址,那么账单系统会把结果通知到所有的地址上。 注意:商户收到通知后,需要对通知做出响应:成功收到时响应”SUCCESS”;失败时响应”FAILED”。 针对重复收到通知的问题处理: 如果网付没有收到商户响应的SUCCESS,或者网络异常,系统会在24小时内尝试多次通知。商户收到重复通知时可以执行以下1或2进行处理: 1.商户主动调网付查询接口,以查询结果为准。 2.通知报文里面有商户订单号,商户可根据订单号和订单状态判断是否是重复通知,并忽略已经处理了的订单的重复通知。

ContentType:HTTP(S)

请求参数

名称 类型 必填 最大长度 描述 示例值
connectSys string - 链接系统
tid string - 终端号
bankInfo string - 银行信息
billFunds string - 资金渠道
billFundsDesc string - 资金渠道说明
totalAmount number - 订单金额,单位分
couponAmount number - 网付计算的优惠金额,单位分
buyerPayAmount number - 实付金额
invoiceAmount number - 开票金额
merOrderId string - 商户订单号
payTime string - 支付时间 格式yyyy-MM-dd HH:mm:ss
seqId string - 系统交易流水号
settleDate string - 结算日期 格式yyyy-MM-dd
status string - 交易状态
targetOrderId string - 渠道订单号
targetSys string - 支付渠道
notifyId string - 通知ID 通知唯一ID,重发通知的notifyId不变
signType string - 签名算法
sign string - 签名 签名规则
cardAttr string -
mid string - 商户号
contractId string - 签约协议号
contractSignedTime string - 协议签约时间
contractExpiredTime string - 协议到期时间
attachedData string - 附加数据
bankCardNo string - 支付银行信息
buyerId string - 卖家ID
buyerUsername string - 买家用户名
refId string - 支付银行卡参考号
refundAmount number - 退款金额
refundDesc string - 退款说明
subBuyerId string - 卖家子ID

响应示例

{

}

响应参数

错误码