银联商务天满服务平台
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/v1/netpay/wx/app-pre-query";
        //开发者ID
        String appId = "平台分配";
        //开发者秘钥
        String appKey = "平台分配";
        //实例化客户端
        ConfigBean configBean = new ConfigBean();
        OpenApiContext context = new OpenApiContext();
        String request = "{\"requestTimestamp\":\"2022-04-15 10:29:59\",
                    \"mid\":\"898340149000005\",
                    \"tid\":\"00000001\",
                    \"instMid\":\"APPDEFAULT\",
                    \"msgId\":\"0DUNOje1Bwtue6XinEs7DWhKS2NmUCVg\",
                    \"srcReserve\":\"C20220119000001\",
                    \"merOrderId\":\"ZS2022041417244897253911\",
                    \"targetOrderId\":\"13L5202307191359352116202556\"}";
        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/v1/netpay/wx/app-pre-query";
        $data = json_encode(array("requestTimestamp"=>"2022-04-15 10=>29=>59",
                    "mid"=>"898340149000005",
                    "tid"=>"00000001",
                    "instMid"=>"APPDEFAULT",
                    "msgId"=>"0DUNOje1Bwtue6XinEs7DWhKS2NmUCVg",
                    "srcReserve"=>"C20220119000001",
                    "merOrderId"=>"ZS2022041417244897253911",
                    "targetOrderId"=>"13L5202307191359352116202556"));
        $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/v1/netpay/wx/app-pre-query"

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({\"requestTimestamp\":\"2022-04-15 10:29:59\",
                    \"mid\":\"898340149000005\",
                    \"tid\":\"00000001\",
                    \"instMid\":\"APPDEFAULT\",
                    \"msgId\":\"0DUNOje1Bwtue6XinEs7DWhKS2NmUCVg\",
                    \"srcReserve\":\"C20220119000001\",
                    \"merOrderId\":\"ZS2022041417244897253911\",
                    \"targetOrderId\":\"13L5202307191359352116202556\"})
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/v1/netpay/wx/app-pre-query
  • 测试环境: POST https://test-api-open.chinaums.com/v1/netpay/wx/app-pre-query

描述:钱包支付时,因通讯故障、服务器故障等原因,造成收银机最终没有收到支付结果通知,收银员不确定该笔支付后台处理结果,可以在收银机上发起“查询”交易,查询该笔交易订单在钱包后台的支付结果,并将支付结果返回给收银机。

ContentType:HTTP(S) + JSON

请求头

名称 必填 描述 示例值
Authorization 认证内容 (认证参考天满开发者中心->接入指引->平台认证方式:开发者中心 OPEN-BODY-SIG AppId="****",Timestamp="20170606135700",Nonce="99930a147f5353dd8a8f29a5329f37e9",Signature="IPmdGHYCcfN+mto0/02zkwoUF1NT3YqPKaUykMaec1T="

请求参数

名称 类型 必填 最大长度 描述 示例值
requestTimestamp string 报文请求时间 格式:yyyy-MM-dd HH:mm:ss 2022-04-15 10:29:59
mid string 15 商户号 898340149000005
tid string 8 终端号 00000001
instMid string - 业务类型 APPDEFAULT APPDEFAULT
msgId string <=64 消息ID 原样返回 0DUNOje1Bwtue6XinEs7DWhKS2NmUCVg
srcReserve string <=255 请求系统预留字段 C20220119000001
merOrderId string 6..64 商户订单号 ZS2022041417244897253911
targetOrderId string 6..64 支付订单号 13L5202307191359352116202556

响应示例

{
  "errCode":"SUCCESS",
  "responseTimeStamp":"2022-07-19 16:29:59",
  "mid":"898310148160568",
  "tid":"88880001",
  "instMid":"APPDEFAULT",
  "billFunds":"",
  "billFundsDesc":"",
  "payTime":"2022-07-19 16:29:59",
  "couponMerchantContribute":"300",
  "couponOtherContribute":"500",
  "errMsg":"查询成功",
  "msgId":"0DUNOje1Bwtue6XinEs7DWhKS2NmUCVg",
  "srcReserve":"C20220119000001",
  "seqId":"35313847324N",
  "settleRefId":"35313847324N",
  "refId":"35313847324N",
  "status":"TRADE_SUCCESS",
  "totalAmount":"8800",
  "merName":"测试商户",
  "merOrderId":"327M202204141724489725391",
  "targetOrderId":"327M202204141724489725391",
  "targetSys":"",
  "targetStatus":"",
  "buyerId":"otdJ_uIwURPSMF1VsZmQ67ZmpFQQ",
  "targetMid":"898321386513087",
  "bankCardNo":"",
  "bankInfo":"",
  "buyerPayAmount":0,
  "billPayment":
  {

  },
  "buyerUsername":"张*三",
  "couponAmount":"200",
  "invoiceAmount":"100",
  "receiptAmount":"800",
  "settleDate":"2022-07-19",
  "subBuyerId":"otdJ_uIwURPSMF1VsZmQ67ZmpFQQ",
  "yxlmAmount":"200",
  "activityIds":""
}

响应参数

名称 类型 必填 最大长度 描述 示例值
errCode string 错误代码
平台错误码
业务错误码
SUCCESS
responseTimeStamp string 报文应答时间 格式:yyyy-MM-dd HH:mm:ss 2022-07-19 16:29:59
mid string 15 商户号,原样返回 898310148160568
tid string 8 终端号,原样返回 88880001
instMid string 8..32 业务类型 APPDEFAULT
billFunds string 支付渠道列表 格式为:方式:金额(单位:分)\
billFundsDesc string 支付渠道描述
payTime string 支付时间 格式:yyyy-MM-dd HH:mm:ss 2022-07-19 16:29:59
couponMerchantContribute number - 商户出资优惠金额,目前支持微信返回,其他渠道产品规划中 300
couponOtherContribute number - 其他出资优惠金额,目前支持微信返回,其他渠道产品规划中 500
errMsg string 错误说明 查询成功
msgId string <=64 消息ID,原样返回 0DUNOje1Bwtue6XinEs7DWhKS2NmUCVg
srcReserve string <=255 请求系统预留字段 C20220119000001
seqId string 平台流水号 35313847324N
settleRefId string 清分ID 如果来源方传了bankRefId就等于bankRefId,否则等于seqId 35313847324N
refId string 检索参考号 用在银联体系交易中 35313847324N
status string 交易状态 TRADE_SUCCESS
totalAmount number 支付总金额 单位:分 8800
merName string 商户名称 测试商户
merOrderId string 商户订单号 327M202204141724489725391
targetOrderId string 目标平台单号 327M202204141724489725391
targetSys string 目标平台代码
targetStatus string 目标平台状态
buyerId string 买家ID otdJ_uIwURPSMF1VsZmQ67ZmpFQQ
targetMid string 支付渠道商户号 各渠道情况不同,酌情转换 898321386513087
bankCardNo string 银行卡号
bankInfo string 银行信息
buyerPayAmount number 买家付款的金额 单位:分,支付宝会有
billPayment object 账单支付信息 若涉及营销联盟优惠,则账单流水总金额为优惠后的总金额
buyerUsername string 买家用户名 张*三
couponAmount number 渠道优惠金额 单位:分 200
invoiceAmount number 交易中可给用户开具发票的金额 100
receiptAmount number 商户实收金额 单位:分,支付宝会有 800
settleDate string 结算日期 格式:yyyy-MM-dd 2022-07-19
subBuyerId string 子买家ID 如微信的subOpenId otdJ_uIwURPSMF1VsZmQ67ZmpFQQ
yxlmAmount number 营销联盟优惠金额 单位:分 200
activityIds string 微信活动ID

错误码