银联商务天满服务平台
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/bills/preauthed";
        //开发者ID
        String appId = "平台分配";
        //开发者秘钥
        String appKey = "平台分配";
        //实例化客户端
        ConfigBean configBean = new ConfigBean();
        OpenApiContext context = new OpenApiContext();
        String request = "{\"requestTimestamp\":\"2023-07-19 13:31:16\",
                    \"mid\":\"89844035541APR4\",
                    \"tid\":\"APR40001\",
                    \"instMid\":\"QRPAYDEFAULT\",
                    \"billNo\":\"124F2023071912562344830889\",
                    \"billDate\":\"2023-07-19\",
                    \"authedOrderId\":\"124F2023071913311600836127\",
                    \"authIdRespCd\":\"987275\",
                    \"totalAmount\":\"1908\",
                    \"msgId\":\"\",
                    \"srcReserve\":\"\",
                    \"authedDesc\":\"\"}";
        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/bills/preauthed";
        $data = json_encode(array("requestTimestamp"=>"2023-07-19 13=>31=>16",
                    "mid"=>"89844035541APR4",
                    "tid"=>"APR40001",
                    "instMid"=>"QRPAYDEFAULT",
                    "billNo"=>"124F2023071912562344830889",
                    "billDate"=>"2023-07-19",
                    "authedOrderId"=>"124F2023071913311600836127",
                    "authIdRespCd"=>"987275",
                    "totalAmount"=>"1908",
                    "msgId"=>"",
                    "srcReserve"=>"",
                    "authedDesc"=>""));
        $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/bills/preauthed"

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\":\"2023-07-19 13:31:16\",
                    \"mid\":\"89844035541APR4\",
                    \"tid\":\"APR40001\",
                    \"instMid\":\"QRPAYDEFAULT\",
                    \"billNo\":\"124F2023071912562344830889\",
                    \"billDate\":\"2023-07-19\",
                    \"authedOrderId\":\"124F2023071913311600836127\",
                    \"authIdRespCd\":\"987275\",
                    \"totalAmount\":\"1908\",
                    \"msgId\":\"\",
                    \"srcReserve\":\"\",
                    \"authedDesc\":\"\"})
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/bills/preauthed
  • 测试环境: POST https://test-api-open.chinaums.com/v1/netpay/bills/preauthed

描述:商户上送授权标识应答码,银商订单号完成预授权交易。

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 2023-07-19 13:31:16
mid string 15 商户号 89844035541APR4
tid string 8 终端号 APR40001
instMid string - 业务类型 QRPAYDEFAULT QRPAYDEFAULT
billNo string 31 账单号 124F2023071912562344830889
billDate string - 账单日期 格式:yyyy-MM-dd 2023-07-19
authedOrderId string 32 完成交易的订单号 如商户指定,须以4位来源编号(由银商分配)开头 124F2023071913311600836127
authIdRespCd string 255 授权标识应答码 987275
totalAmount number 100000000 要完成的金额,单位:分 1908
msgId string 64 消息ID 原样返回
srcReserve string 255 请求系统预留字段
authedDesc string 255 完成说明

响应示例

{
  "errCode":"SUCCESS",
  "errMsg":"",
  "responseTimestamp":"2023-07-19 13:31:17",
  "mid":"89844035541APR4",
  "tid":"APR40001",
  "instMid":"QRPAYDEFAULT",
  "authIdRespCd":"987275",
  "authedBillPayment":
  {
    "merOrderId":"124F2023071913311600836127",
    "billBizType":"bills",
    "paySeqId":"35313909095N",
    "totalAmount":"1908",
    "buyerPayAmount":"954",
    "invoiceAmount":"954",
    "discountAmount":0,
    "buyerId":"",
    "buyerUsername":"",
    "payDetail":"现金支付9.54元,优惠支付9.54元",
    "payTime":"2023-07-19 13:31:16",
    "settleDate":"2023-07-19",
    "status":"TRADE_SUCCESS",
    "targetOrderId":"11230719465844515723",
    "targetSys":"ACP",
    "activityIds":""
  },
  "msgId":"",
  "srcReserve":"",
  "billNo":"124F2023071912562344830889",
  "billDate":"2023-07-19",
  "billQRCode":"",
  "billStatus":"PAID",
  "authedOrderId":"",
  "cardAttr":""
}

响应参数

名称 类型 必填 最大长度 描述 示例值
errCode string - 错误代码
平台错误码
业务错误码
SUCCESS
errMsg string - 错误说明
responseTimestamp string - 报文响应时间 格式:yyyy-MM-dd HH:mm:ss 2023-07-19 13:31:17
mid string 15 商户号 89844035541APR4
tid string 8 终端号 APR40001
instMid string 32 业务类型 QRPAYDEFAULT QRPAYDEFAULT
authIdRespCd string - 授权标识应答码 987275
authedBillPayment object 预授权账单信息
   merOrderId string - 商户订单号 124F2023071913311600836127
   billBizType string - 账单业务类型 bills
   paySeqId string - 交易参考号 35313909095N
   totalAmount number - 账单流水总金额 若涉及联盟优惠,则为优惠后的总金额,单位:分 1908
   buyerPayAmount number - 实付金额,单位:分 954
   invoiceAmount number - 开票金额,单位:分 954
   discountAmount number - 折扣金额,单位:分
   buyerId string - 买家ID
   buyerUsername string - 买家用户名
   payDetail string - 支付详情 现金支付9.54元,优惠支付9.54元
   payTime string - 支付时间 格式:yyyy-MM-dd 2023-07-19 13:31:16
   settleDate string - 结算时间 格式:yyyy-MM-dd 2023-07-19
   status string - 交易状态 TRADE_SUCCESS
   targetOrderId string - 目标平台单号 11230719465844515723
   targetSys string - 目标系统 ACP
   activityIds string - 微信活动ID
msgId string 64 消息ID 原样返回
srcReserve string 255 请求系统预留字段
billNo string 31 账单号 124F2023071912562344830889
billDate string - 账单日期 格式:yyyy-MM-dd 2023-07-19
billQRCode string - 账单二维码
billStatus string - 账单状态 PAID
authedOrderId string - 完成订单号
cardAttr string - 借贷记标识
DEBIT_CARD(借记卡);
CREDIT_CARD(贷记卡)

错误码