银联商务天满服务平台
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 = "/v6/poslink/transaction/voidpayment";
        //开发者ID
        String appId = "平台分配";
        //开发者秘钥
        String appKey = "平台分配";
        //实例化客户端
        ConfigBean configBean = new ConfigBean();
        OpenApiContext context = new OpenApiContext();
        String request = "{\"merchantCode\":\"103290070111417\",
                    \"terminalCode\":\"12340511\",
                    \"systemTraceNum\":\"123456\",
                    \"merchantOrderId\":\"20200227163036011978864947\",
                    \"originalOrderId\":\"20200227163036011978864947\",
                    \"merchantRemark\":\"test\",
                    \"limitCrossDevice\":\"true\",
                    \"bizIdentifier\":\"\"}";
        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 = "/v6/poslink/transaction/voidpayment";
        $data = json_encode(array("merchantCode"=>"103290070111417",
                    "terminalCode"=>"12340511",
                    "systemTraceNum"=>"123456",
                    "merchantOrderId"=>"20200227163036011978864947",
                    "originalOrderId"=>"20200227163036011978864947",
                    "merchantRemark"=>"test",
                    "limitCrossDevice"=>"true",
                    "bizIdentifier"=>""));
        $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 = "/v6/poslink/transaction/voidpayment"

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({\"merchantCode\":\"103290070111417\",
                    \"terminalCode\":\"12340511\",
                    \"systemTraceNum\":\"123456\",
                    \"merchantOrderId\":\"20200227163036011978864947\",
                    \"originalOrderId\":\"20200227163036011978864947\",
                    \"merchantRemark\":\"test\",
                    \"limitCrossDevice\":\"true\",
                    \"bizIdentifier\":\"\"})
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-wh.open.chinaums.com/v6/poslink/transaction/voidpayment
  • 测试环境: POST https://test-api-open.chinaums.com/v6/poslink/transaction/voidpayment

描述:进行POS通支付撤销操作

ContentType:application/json

请求头

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

请求参数

名称 类型 必填 最大长度 描述 示例值
merchantCode string 15 商户号 103290070111417
terminalCode string 8 终端号 12340511
systemTraceNum string 6 系统跟踪号 6位数字 123456
merchantOrderId string 50 商户订单号 商户订单号与银商订单号至少存在一个,如均存在,以银商订单号为准,忽略商户订单号 20200227163036011978864947
originalOrderId string 50 银商订单号 必须与原支付交易返回的订单号一致 20200227163036011978864947
merchantRemark string 50 商户备注 长度不超过50位 test
limitCrossDevice boolean - 是否限制跨终端
true : 不可以跨终端
false: 可以跨终端
true
bizIdentifier string 3 业务标识 标识接入的具体业务,除非特殊说明,一般不需要上送

响应示例

{
  "errCode":"00",
  "errInfo":"10000成功响应码",
  "orderId":"20230718110248029165883554",
  "transactionTime":"111340",
  "transactionDate":"0718",
  "transactionDateWithYear":"20230718",
  "settlementDate":"0718",
  "settlementDateWithYear":"20230718",
  "retrievalRefNum":"29165883554W",
  "transactionAmount":"1",
  "actualTransactionAmount":"1",
  "thirdPartyName":"微信钱包",
  "cardAttr":"91",
  "installmentNumber":"12",
  "installmentSellerPercent":"100",
  "convMchntNo":"103290070111417",
  "convTermNo":"12340511"
}

响应参数

名称 类型 必填 最大长度 描述 示例值
errCode string -
平台错误码
业务错误码
00
errInfo string - 错误说明 10000成功响应码
orderId string 50 订单号 20230718110248029165883554
transactionTime string - 交易时间 格式:hhmmss 111340
transactionDate string - 交易日期 格式:MMdd 0718
transactionDateWithYear string - 交易日期 格式:yyyyMMdd 20230718
settlementDate string - 结算日期 格式:MMdd 0718
settlementDateWithYear string - 结算日期 格式:yyyyMMdd 20230718
retrievalRefNum string - 检索参考号 长度12位 29165883554W
transactionAmount number - 订单金额 与交易请求金额一致,单位:分 1
actualTransactionAmount number - 实际交易金额 最大长度12位,单位:分 1
thirdPartyName string - 第三方名称 仅仅撤销成功的存在该字段 微信钱包
cardAttr string - 卡类型
借记:01
贷记:03
账户余额:91
91
installmentNumber number - 分期期数 花呗分期期数(目前支持支付宝渠道) 12
installmentSellerPercent number - 付息方 花呗暂时只支持0/100,100:商家承担 100
convMchntNo string - 转商户商户号 103290070111417
convTermNo string - 转终端终端号 12340511

错误码