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 |