银联商务天满服务平台
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/uac/order";
        //开发者ID
        String appId = "平台分配";
        //开发者秘钥
        String appKey = "平台分配";
        //实例化客户端
        ConfigBean configBean = new ConfigBean();
        OpenApiContext context = new OpenApiContext();
        String request = "{\"requestTimestamp\":\"2022-04-19 10:25:03\",
                    \"merOrderId\":\"1000220413916204214422\",
                    \"mid\":\"898201612345678\",
                    \"tid\":\"88880001\",
                    \"instMid\":\"H5DEFAULT\",
                    \"totalAmount\":\"1\",
                    \"msgId\":\"\",
                    \"srcReserve\":\"保留字段\",
                    \"goods\":\"[{\"goodsId\":\"\",\"goodsName\":\"\",\"quantity\":\"\",\"price\":\"\",\"goodsCategory\":\"\",\"body\":\"\",\"subMerchantId\":\"\",\"merOrderId\":\"1000220413916204214422\",\"subOrderAmount\":\"\"}]\",
                    \"attachedData\":\"\",
                    \"orderDesc\":\"\",
                    \"goodsTag\":\"\",
                    \"originalAmount\":\"\",
                    \"expireTime\":\"\",
                    \"secureTransaction\":\"\",
                    \"notifyUrl\":\"\",
                    \"returnUrl\":\"\",
                    \"systemId\":\"\",
                    \"sceneType\":\"\",
                    \"merAppName\":\"\",
                    \"merAppId\":\"\",
                    \"limitCreditCard\":\"\",
                    \"divisionFlag\":\"\",
                    \"platformAmount\":\"\",
                    \"subOrders\":\"[{\"mid\":\"898201612345678\",\"merOrderId\":\"1000220413916204214422\",\"totalAmount\":\"1\"}]\",
                    \"name\":\"\",
                    \"mobile\":\"\",
                    \"certType\":\"\",
                    \"certNo\":\"\",
                    \"fixBuyer\":\"\",
                    \"bankCardNo\":\"\",
                    \"installmentNumber\":\"\",
                    \"retCommParams\":\"{\"foodOrderType\":\"\"}\",
                    \"instalFlag\":\"\",
                    \"mchntInstalRatio\":\"\",
                    \"mchntDiscountRatio\":\"\",
                    \"cardNoLockFlag\":\"\",
                    \"custId\":\"\",
                    \"thirdPartyInstalSubsFlag\":\"\",
                    \"asynDivisionFlag\":\"\",
                    \"largeScreenFlag\":\"\",
                    \"clientIp\":\"\",
                    \"discountCode\":\"\",
                    \"ylyxId\":\"\",
                    \"ylyxName\":\"\",
                    \"ylyxMerAbbr\":\"\"}";
        context.setApiServiceUrl(url);
        context.setAppId(appId);
        context.setAppKey(appKey);
        context.setConfigBean(configBean);
        System.out.println(HttpTransport.getInstance().doGet(context, request));
    }
}
<?php
require_once "../utils/Log.php";
require_once "../DefaultOpenApiClient.php";

class DataDemo{
    public function main(){

        $appid = "平台分配";
        $appkey = "平台分配";
        $url = "https://api-mop.chinaums.com/v1/netpay/uac/order";
        $data = json_encode(array("requestTimestamp"=>"2022-04-19 10=>25=>03",
                    "merOrderId"=>"1000220413916204214422",
                    "mid"=>"898201612345678",
                    "tid"=>"88880001",
                    "instMid"=>"H5DEFAULT",
                    "totalAmount"=>"1",
                    "msgId"=>"",
                    "srcReserve"=>"保留字段",
                    "goods"=>"json_encode(array([{"goodsId"=>"","goodsName"=>"","quantity"=>"","price"=>"","goodsCategory"=>"","body"=>"","subMerchantId"=>"","merOrderId"=>"1000220413916204214422","subOrderAmount"=>""}]))",
                    "attachedData"=>"",
                    "orderDesc"=>"",
                    "goodsTag"=>"",
                    "originalAmount"=>"",
                    "expireTime"=>"",
                    "secureTransaction"=>"",
                    "notifyUrl"=>"",
                    "returnUrl"=>"",
                    "systemId"=>"",
                    "sceneType"=>"",
                    "merAppName"=>"",
                    "merAppId"=>"",
                    "limitCreditCard"=>"",
                    "divisionFlag"=>"",
                    "platformAmount"=>"",
                    "subOrders"=>"json_encode(array([{"mid"=>"898201612345678","merOrderId"=>"1000220413916204214422","totalAmount"=>"1"}]))",
                    "name"=>"",
                    "mobile"=>"",
                    "certType"=>"",
                    "certNo"=>"",
                    "fixBuyer"=>"",
                    "bankCardNo"=>"",
                    "installmentNumber"=>"",
                    "retCommParams"=>"{"foodOrderType"=>""}",
                    "instalFlag"=>"",
                    "mchntInstalRatio"=>"",
                    "mchntDiscountRatio"=>"",
                    "cardNoLockFlag"=>"",
                    "custId"=>"",
                    "thirdPartyInstalSubsFlag"=>"",
                    "asynDivisionFlag"=>"",
                    "largeScreenFlag"=>"",
                    "clientIp"=>"",
                    "discountCode"=>"",
                    "ylyxId"=>"",
                    "ylyxName"=>"",
                    "ylyxMerAbbr"=>""));
        $client = new DefaultOpenApiClient();
        $content = $client->executeGet($appid,$appkey,$url,$data);
        $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/uac/order"

class DataRequest(object):
    def __init__(self, data: dict) -> dict:
        self.data = data
appId = "平台分配"
appKey = "平台分配"
client = DefaultOpenApiClient(appId, appKey,url)
cls = DataRequest({\"requestTimestamp\":\"2022-04-19 10:25:03\",
                    \"merOrderId\":\"1000220413916204214422\",
                    \"mid\":\"898201612345678\",
                    \"tid\":\"88880001\",
                    \"instMid\":\"H5DEFAULT\",
                    \"totalAmount\":\"1\",
                    \"msgId\":\"\",
                    \"srcReserve\":\"保留字段\",
                    \"goods\":\"[{\"goodsId\":\"\",\"goodsName\":\"\",\"quantity\":\"\",\"price\":\"\",\"goodsCategory\":\"\",\"body\":\"\",\"subMerchantId\":\"\",\"merOrderId\":\"1000220413916204214422\",\"subOrderAmount\":\"\"}]\",
                    \"attachedData\":\"\",
                    \"orderDesc\":\"\",
                    \"goodsTag\":\"\",
                    \"originalAmount\":\"\",
                    \"expireTime\":\"\",
                    \"secureTransaction\":\"\",
                    \"notifyUrl\":\"\",
                    \"returnUrl\":\"\",
                    \"systemId\":\"\",
                    \"sceneType\":\"\",
                    \"merAppName\":\"\",
                    \"merAppId\":\"\",
                    \"limitCreditCard\":\"\",
                    \"divisionFlag\":\"\",
                    \"platformAmount\":\"\",
                    \"subOrders\":\"[{\"mid\":\"898201612345678\",\"merOrderId\":\"1000220413916204214422\",\"totalAmount\":\"1\"}]\",
                    \"name\":\"\",
                    \"mobile\":\"\",
                    \"certType\":\"\",
                    \"certNo\":\"\",
                    \"fixBuyer\":\"\",
                    \"bankCardNo\":\"\",
                    \"installmentNumber\":\"\",
                    \"retCommParams\":\"{\"foodOrderType\":\"\"}\",
                    \"instalFlag\":\"\",
                    \"mchntInstalRatio\":\"\",
                    \"mchntDiscountRatio\":\"\",
                    \"cardNoLockFlag\":\"\",
                    \"custId\":\"\",
                    \"thirdPartyInstalSubsFlag\":\"\",
                    \"asynDivisionFlag\":\"\",
                    \"largeScreenFlag\":\"\",
                    \"clientIp\":\"\",
                    \"discountCode\":\"\",
                    \"ylyxId\":\"\",
                    \"ylyxName\":\"\",
                    \"ylyxMerAbbr\":\"\"})
response = client.executeGet(cls)
print(str(response.text))

银联云闪付下单

URL

  • 生产环境: GET https://api-mop.chinaums.com/v1/netpay/uac/order
  • 测试环境: GET https://test-api-open.chinaums.com/v1/netpay/uac/order

描述:本接口为商户的订单信息发向银商网络支付前置系统以获取支付要素商户需遵循商户订单号生成规范,即以银商分配的4位来源编号作为账单号的前4位,且在商户系统中此账单号保证唯一。总长度需大于6位,小于等于32位。银商的推荐规则为(无特殊情况下,建议遵守此规则) 调用该接口时所有上送报文里的上送字段值,若包含了特殊字符的 须进行urlencode加密(1. urlencode加密是utf-8格式; 2.只对上送报文的字段值进行加密,生成签名时的待签字串仍用原始字符) 银联在线无卡如果需要支持指定付款人付款,则需要输入付款人姓名、手机号、证件号、卡号,证件类型,目前银联在线无卡证件类型只支持身份证。用户下单后,则跳转到无卡支付页面,页面显示传送的银行卡号和手机号,用户接着输入短信码完成支付,支付完后由无卡支付页面跳转回商家页面展示支付结果。敏感信息如姓名,手机号,证件号,卡号需要Base64编码。 如果商户APP接入云闪付h5支付(银联云闪付:uac.order)需要商户改造自己的APP,改造说明请参考part4;非商户app接入云闪付h5支付不需要改造。 如果需要实名认证(H5实名认证暂只支持支付宝和云闪付)。 支付宝必传姓名name,证件类型certType,证件号certNo,强制校验位fixBuyer=T。注意:支付宝支持的证件类型包括:身份证IDENTITY_CARD、护照PASSPORT、军官证OFFICER_CARD、士兵证SOLDIER_CARD、户口本HOKOU". 云闪付实名认证必传姓名name,证件类型certType,证件号certNo,强制校验位fixBuyer=T。注意:云闪付支持的证件类型包括:身份证IDENTITY_CARD、护照PASSPORT、军官证OFFICER_CARD、士兵证SOLDIER_CARD、港澳证HM_EXIT、台湾证TW_EXIT、警官证POLICE_CERTIFICATE、其他OTHER。 敏感信息如姓名、证件号和手机号信息需要 base64编码。{来源编号(4位)}{时间(yyyyMMddmmHHssSSS)(17位)}{11位随机数}

ContentType:HTTP(S)

URL参数

参数名称 说明 类型 长度 必填 备注
authorization 认证方式 string 值为OPEN-FORM-PARAM
appId AppId string <=32
timestamp 时间戳 string 14 yyyyMMddHHmmss
nonce 随机数 string <=128
content 业务内容 string
signature 签名 string Base64_Encode(HmacSHA256(appId + timestamp + nonce + SHA256_HEX(content), AppKey))

业务内容

名称 类型 必填 最大长度 描述 示例值
requestTimestamp string 报文请求时间 格式:yyyy-MM-dd HH:mm:ss 2022-04-19 10:25:03
merOrderId string 6..32 商户订单号 商户自行生成 1000220413916204214422
mid string 15 商户号 898201612345678
tid string 8 终端号 88880001
instMid string 8..32 业务类型 H5DEFAULT H5DEFAULT
totalAmount number 1..100000000 支付总金额 单位:分 若divisionFlag为true,则:
totalAmount =subOrders字段中的所有totalAmount值之和
platformAmount值 =goods中的所有subOrderAmount值之和。
1
msgId string <=64 消息ID 原样返回
srcReserve string <=255 请求系统预留字段 保留字段
goods array 商品信息 在传分账标记的情况下,若传子商户号,子商户商品金额必传,即goods字段中每个元素中subMerchantId与subOrderAmount不能为空,元素不能超过20个。(goods里所有子商户商品总额要与支付总额totalAmount相等)
   goodsId string 商品ID
   goodsName string 商品名称
   quantity string 商品数量
   price string 商品单价 单位:分
   goodsCategory string 商品分类
   body string 商品说明
   subMerchantId string 15 子商户号
   merOrderId string 6..32 商户子订单号 1000220413916204214422
   subOrderAmount number 0..100000000 子商户商品总额 单位:分
attachedData string <=255 商户附加数据
orderDesc string <=255 账单描述
goodsTag string <=32 商品标记 用于优惠活动
originalAmount number 1..100000000 订单原始金额 单位:分,用于记录前端系统打折前的金额
expireTime string 订单过期时间 格式:yyyy-MM-dd HH:mm:ss
secureTransaction string 担保交易标识 取值:true或false,默认false 若上送为true,则交易的金额将会被暂缓结算。调用担保完成接口后,完成部分金额会在t+1日结算给商户,剩余部分金额退还用户。调用担保撤销接口,则全部资金退还给用户。30天后没有主动调用担保完成 且 没有主动调用担保撤销的交易 将会自动按撤销处理。
notifyUrl string <=255 支付结果通知地址
returnUrl string <=255 支付结果回跳商户页面
systemId string <=32 系统ID
sceneType string <=16 业务应用类型 微信H5支付必填,
用于苹app应用里值为IOS_SDK ;用于安卓app
应用里值为AND_SDK;用于手机网站,
值为IOS_WAP 或AND_WAP
merAppName string <=64 应用名称 微信H5支付必填,
用于苹或安卓app 应用中,传分别 对应在 AppStore和安卓分发市场中的应用名(如:全民付);用于手机网站,传对应的网站名(如:银联商务官网)
merAppId string <=128 应用标识 微信H5支付必填。
用于苹果或安卓 app 应用中,苹果传 IOS 应用唯一标识(如: com.tencent.wzryIOS )
安卓传包名 (如: com.tencent.tmgp.sgame)
如果是用于手机网站 ,传首页 URL 地址 , (如: https://m.jd.com ) ,支付宝H5支付参数无效
limitCreditCard string 是否需要限制信用卡支付 取值:true或false,默认false
divisionFlag boolean 分账标记 暂时只支持微信、支付宝支付和银联云闪付。 若为true,则goods字段和subOrders字段不能同时为空,且secureTransaction字段上送false或不上送。
platformAmount number 0..100000000 平台商户分账金额 单位:分,若分账标记传,则分账金额必传
subOrders array 子订单信息 在传分账标记的情况下,若传子商户号,子商户分账金额必传,即subOrders每个元素的mid和totalAmount非空且mid不超过20个。(分账方案subOrders里子商户分账总额+platformAmount要与支付总额totalAmount相等)。 +在传分账标记的情况下,接口中goods和subOrders二者必传其一(建议使用subOrders字段);若传goods则分账信息会按goods中每个商品的总额占支付总额减平台分账金额等比例生成;若传subOrders,则分账信息则严格按subOrders里的分账方案生成。
   mid string 15 子商户号 898201612345678
   merOrderId string 6..32 商户子订单号 1000220413916204214422
   totalAmount number 0..100000000 子商户分账金额 单位:分 1
name string <=32 实名认证姓名 Base64编码
mobile string <=20 实名认证手机号 Base64编码
certType string 实名认证证件类型
1.无卡支付指定付款人时必传;
2.实名认证时必传;
certNo string <=32 实名认证证件号 Base64编码
fixBuyer string <=32 是否需要实名认证 需要实名认证时置为T
bankCardNo string <=19 卡号 Base64编码 +银联云闪付(网页支付)可指定卡号付款
installmentNumber number 分期付款期数 仅支持花呗分期和云闪付支付分期;支付宝花呗分期仅支持3、6、12
retCommParams object 返佣字段 目前支持支付宝渠道
   foodOrderType string 扫码点餐字段 pre_order
instalFlag boolean 分期标识 仅支持云闪付支付
false:不强制分期
true:强制分期
默认false
mchntInstalRatio string 商户分期费率 仅支持云闪付支付百分比值,例如4.5%填写4.5仅在商户与发卡机构存在个性化分期全手续费协定的情况下进行填写,对于适用发卡机构提供的标准分期全手续费率的交易,该域为空
mchntDiscountRatio string 商户贴息费率 仅支持云闪付支付百分比值,例如1.2%填写1.2在商户确有补贴时,由受理侧据实填写,如为持卡人全额支付手续费模式,则为零
cardNoLockFlag boolean 卡号锁定标识 仅支持银联云闪付(网页支付),上送true,则页面会锁定卡号,默认false
custId string 客户ID 仅支持银联云闪付(网页支付),上传客户ID后可以页面记忆卡号
thirdPartyInstalSubsFlag boolean 是否开启第三方分期交易贴息 true为本笔交易启用第三方贴息,false或者不传为本笔交易不启用第三方贴息。目前只针对花呗分期交易。
asynDivisionFlag boolean 异步分账标记 若为true,则goods字段和subOrders字段不能同时为空;且secureTransaction字段上送false或不上送。 退货订单不允许做子订单操作 已确认的子订单,不允许隔天再确认
largeScreenFlag boolean 大屏标识 取值true或false,仅支持云闪付支付。传入大屏标识,跳转至银联在线页面后,银联展示二维码(仅PC端),用户可扫码支付
clientIp string - 客户端IP 用户客户端的ip地址
discountCode string - 优惠码 仅支持云闪付渠道
ylyxId string 5..15 银联营销代码
ylyxName string 40 银联营销名称
ylyxMerAbbr string 16 银联营销二级子商户简称