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 | 银联营销二级子商户简称 |