银联商务天满服务平台
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/inip/sign/uac/card-list-query";
        //开发者ID
        String appId = "平台分配";
        //开发者秘钥
        String appKey = "平台分配";
        //实例化客户端
        ConfigBean configBean = new ConfigBean();
        OpenApiContext context = new OpenApiContext();
        String request = "{\"requestTimestamp\":\"2024-01-18 16:14:31\",
                    \"mid\":\"898100054115259\",
                    \"planId\":\"d2041b5c28474a2c9bb8b70128d71160\",
                    \"orderId\":\"319420240118161431096111\",
                    \"trId\":\"99988877779\",
                    \"contractId\":\"NjIxODQwMDAwMDAxMDAwOTI0Nw==\",
                    \"reqReserved\":\"12345678qwer@#$%^碶\"}";
        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/inip/sign/uac/card-list-query";
        $data = json_encode(array("requestTimestamp"=>"2024-01-18 16=>14=>31",
                    "mid"=>"898100054115259",
                    "planId"=>"d2041b5c28474a2c9bb8b70128d71160",
                    "orderId"=>"319420240118161431096111",
                    "trId"=>"99988877779",
                    "contractId"=>"NjIxODQwMDAwMDAxMDAwOTI0Nw==",
                    "reqReserved"=>"12345678qwer@#$%^碶"));
        $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/inip/sign/uac/card-list-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\":\"2024-01-18 16:14:31\",
                    \"mid\":\"898100054115259\",
                    \"planId\":\"d2041b5c28474a2c9bb8b70128d71160\",
                    \"orderId\":\"319420240118161431096111\",
                    \"trId\":\"99988877779\",
                    \"contractId\":\"NjIxODQwMDAwMDAxMDAwOTI0Nw==\",
                    \"reqReserved\":\"12345678qwer@#$%^碶\"})
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/inip/sign/uac/card-list-query
  • 测试环境: POST https://test-api-open.chinaums.com/v1/inip/sign/uac/card-list-query

描述:查询卡列表

ContentType:HTTP(S)

请求头

名称 必填 描述 示例值
Authorization 认证内容(认证参考天满开发者中心->接入指引->平台认证方式:开发者中心

请求参数

名称 类型 必填 最大长度 描述 示例值
requestTimestamp string 19 报文请求时间 格式yyyy-MM-dd HH:mm:ss 2024-01-18 16:14:31
mid string 15 商户代码 银商商户号 898100054115259
planId string 1-32 协议模板id 无感(免密极速)产品模板 ID,与接入产品对应。 d2041b5c28474a2c9bb8b70128d71160
orderId string 8..40 请求单号 商户生成。不能含“-”或“_” 自定义并发送,同一交易日期内不可重复; 319420240118161431096111
trId string 8..11 标记请求者id 银联分配:标记请求者 trId 99988877779
contractId string 44 银联免密支付签约协议号 云闪付侧的签约协议号,由银联生成。即标记化支付信息域的token BASE64 NjIxODQwMDAwMDAxMDAwOTI0Nw==
reqReserved string 1024 请求方保留域 请求方保留域:商户自定义保留域,交易应答时会原样返回 12345678qwer@#$%^碶

响应示例

{
  "errCode":"",
  "responseTimeStamp":"",
  "mid":"",
  "contractId":"",
  "orderId":"",
  "reqReserved":"",
  "cardList":
  [
    {
      "cardNoDesen":"",
      "issHeadCode":"",
      "issHeadName":"",
      "payCardType":"",
      "maskedReservedMobile":""
    } 
  ],
  "errMsg":""
}

响应参数

名称 类型 必填 最大长度 描述 示例值
errCode string <=64 错误代码
平台错误码
业务错误码
responseTimeStamp Date 19 报文应答时间 格式yyyy-MM-dd HH:mm:ss
mid string 15 商户代码 银商商户号
contractId string 44 银联免密支付签约协议号 BASE64
orderId string 8.40 请求单号 商户生成。不能含“-”或“_” 自定义并发送,同一交易日期内不可重复;
reqReserved string 1024 请求方保留域 请求方保留域:商户自定义保留域,交易应答时会原样返回
cardList array 卡列表
   cardNoDesen string 1..128 脱敏卡号 脱敏卡号:前6后4,中间用*掩码
   issHeadCode string 1..11 发卡总行机构代码 发卡总行机构代码
   issHeadName string 1..40 发卡总行机构中文名称 发卡总行机构中文名称
   payCardType string 2 卡性质 卡性质(01:借记卡02:货记卡,03:准贷记卡,04:借贷合一卡,05:预付费卡)
   maskedReservedMobile string 11 预留手机号 银行卡在发卡机构的预留手机号(如有〉根据商户,前三后三 中间补充*
errMsg string <=255 错误信息

错误码