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/query-refund";
//开发者ID
String appId = "平台分配";
//开发者秘钥
String appKey = "平台分配";
//实例化客户端
ConfigBean configBean = new ConfigBean();
OpenApiContext context = new OpenApiContext();
String request = "{\"merchantCode\":\"898340149000005\",
\"terminalCode\":\"00000001\",
\"refundRequestId\":\"R2023071303095765773991347240249\",
\"merchantOrderId\":\"O2023071303094958711246517048965\",
\"originalOrderId\":\"20230713030950401305920024\",
\"oriTransDate\":\"20230713\",
\"payTransDate\":\"20240220\"}";
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/query-refund";
$data = json_encode(array("merchantCode"=>"898340149000005",
"terminalCode"=>"00000001",
"refundRequestId"=>"R2023071303095765773991347240249",
"merchantOrderId"=>"O2023071303094958711246517048965",
"originalOrderId"=>"20230713030950401305920024",
"oriTransDate"=>"20230713",
"payTransDate"=>"20240220"));
$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/query-refund"
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\":\"898340149000005\",
\"terminalCode\":\"00000001\",
\"refundRequestId\":\"R2023071303095765773991347240249\",
\"merchantOrderId\":\"O2023071303094958711246517048965\",
\"originalOrderId\":\"20230713030950401305920024\",
\"oriTransDate\":\"20230713\",
\"payTransDate\":\"20240220\"})
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/query-refund - 测试环境:
POST
https://test-api-open.chinaums.com/v6/poslink/transaction/query-refund
描述:进行POS通交易退款查询操作
ContentType:application/json
请求头
名称 | 必填 | 描述 | 示例值 |
---|---|---|---|
Authorization | 是 | 认证内容 (认证参考天满开发者中心->接入指引->平台认证方式:开发者中心) | OPEN-BODY-SIG AppId="****",Timestamp="20170606135700",Nonce="99930a147f5353dd8a8f29a5329f37e9",Signature="IPmdGHYCcfN+mto0/02zkwoUF1NT3YqPKaUykMaec1T=" |
请求参数
名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
merchantCode | string | 是 | 15 | 商户号 | 898340149000005 |
terminalCode | string | 是 | 8 | 终端号 | 00000001 |
refundRequestId | string | 是 | 50 | 退款请求标识 标识一次退款请求,同一笔订单多次退款需要保证唯一,长度不超过50位 | R2023071303095765773991347240249 |
merchantOrderId | string | 否 | 50 | 商户订单号 商户订单号与银商订单号至少存在一个,如均存在,以银商订单号为准,忽略商户订单号 | O2023071303094958711246517048965 |
originalOrderId | string | 否 | 50 | 银商订单号 必须与原支付交易返回的订单号一致 | 20230713030950401305920024 |
oriTransDate | string | 否 | 8 | 退款交易日期 格式:YYYYMMDD | 20230713 |
payTransDate | string | 否 | 8 | 支付交易日期 格式:YYYYMMDD | 20240220 |
响应示例
{
"errCode":"00",
"errInfo":"10000成功响应码",
"transactionTime":"030959",
"transactionDate":"0713",
"settlementDate":"0713",
"retrievalRefNum":"401305901845",
"totalRefundPromotionAmt":"1",
"orderPromotionStatus":"",
"eventList":
[
{
"promotionProviderCode":"",
"flowId":"",
"eventNo":"",
"eventName":"",
"promotionRange":"",
"promotionType":"",
"refundPromotionAmt":0,
"platPromotionAmt":0,
"mchntPromotionAmt":0,
"thirdPartyPromotionAmt":0,
"thirdPartyPromotionDetail":"",
"goodsList":
[
{
"goodsId":"001",
"promotionAmt":"5",
"goodsNum":"10",
"goodsPrice":"15",
"goodsRemark":"test"
}
]
}
],
"bankCardNo":"",
"thirdPartyName":"微信钱包",
"queryResCode":"00",
"queryResInfo":"",
"payCode":"132375608645791419",
"dealDate":"20230713",
"dealTime":"030957",
"originalAmount":"1",
"dealType":"refund",
"dealSystemTraceNum":"032744",
"dealRetrievalRefNum":"01305920024W",
"batchNo":"000001",
"originalTransactionDate":"0713",
"origialRetrievalRefNum":"01305920024W",
"originalSettlementDate":"20230713",
"refundInvoiceAmount":"1",
"oriInfo":
{
},
"refundPromotionList":"0|0|0",
"convMchntNo":"103290070111417",
"convTermNo":"12340511",
"chnlType":"",
"acqInstCode":"",
"issInstCode":""
}
响应参数
名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
errCode | string | 是 | - | 平台错误码 业务错误码 |
00 |
errInfo | string | 是 | - | 错误说明 | 10000成功响应码 |
transactionTime | string | 是 | - | 交易时间 格式:hhmmss | 030959 |
transactionDate | string | 是 | - | 交易日期 格式:MMdd | 0713 |
settlementDate | string | 是 | - | 结算日期 格式:MMdd | 0713 |
retrievalRefNum | string | 是 | - | 检索参考号 长度12位 | 401305901845 |
totalRefundPromotionAmt | number | 是 | - | 优惠退货金额(合计) ,单位:分 | 1 |
orderPromotionStatus | string | 是 | - | 订单优惠状态 0:订单无优惠 1:订单有优惠但未找到 2:订单有优惠且信息完整 |
|
eventList | array | 是 | 活动列表 单品营销优惠活动列表 | ||
promotionProviderCode | string | 是 | - | 渠道方 最大长度50位 ACP:银联 UMS:银联商务 ALIPAY:支付宝 WXPAY:微信 |
|
flowId | string | 是 | - | 优惠流水ID 最大长度50位 ACP:couponInfo[0].id UMS:无 ALIPAY:无 WXPAY:promotion_id |
|
eventNo | string | 否 | - | 活动编号 最大长度50位 ACP: couponInfo[0].id UMS:无 ALIPAY: 无 WXPAY:无 |
|
eventName | string | 否 | - | 活动名称 最大长度64位 ACP:couponInfo[0].desc UMS:无 ALIPAY:无 WXPAY:无 |
|
promotionRange | string | 否 | - | 优惠范围 最大长度32位 promotion_provider= ACP场景: goods_list不存在时GLOBAL, goods_list存在时SINGLE |
|
promotionType | string | 否 | - | 优惠类型 最大长度32位 promotion_provider= ACP场景: couponInfo[0].type DD01随机立减 CP01事后赠予券 CP02事前领取券 | |
refundPromotionAmt | number | 否 | - | 退货优惠金额 最大长度15位,单位:分 ACP:couponInfo[*].offstAmt累加结果 UMS:无 ALIPAY: present_refund_discount_amount present_refund_mdiscount_amount WXPAY:refund_amount |
|
platPromotionAmt | number | 否 | - | 平台金额 最大长度15位,单位:分 ACP: couponInfo[].offstAmt累加结果(对应的couponInfo[].spnsrId应为00010000) UMS:无 ALIPAY:present_refund_discount_amount WXPAY:无 |
|
mchntPromotionAmt | number | 否 | - | 商户优惠金额 最大长度15位,单位:分 ACP: couponInfo[].offstAmt累加结果(对应的couponInfo[].spnsrId内容长度为15) UMS:无 ALIPAY:present_refund_mdiscount_amount WXPAY:无 |
|
thirdPartyPromotionAmt | number | 否 | - | 第三方优惠金额 最大长度15位,单位:分 ACP:couponInfo[].offstAmt累加结果(对应的couponInfo[].spnsrId内容长度为8,且不为00010000) UMS:无 ALIPAY:无 WXPAY:无 |
|
thirdPartyPromotionDetail | string | 否 | - | 第三方出资详情 base64编码 promotion_provider= ACP场景: couponInfo | |
goodsList | array | 否 | 单品列表 单品优惠场景下必填 | ||
goodsId | string | 是 | - | 商品编号 最大长度50位 ACP: dctDetail.id UMS:无 ALIPAY:无 WXPAY:无 |
001 |
promotionAmt | number | 否 | - | 单品优惠金额 最大长度15位,单位:分 ACP: dctDetail.dctPrice(银联是单品优惠总额) UMS:无 ALIPAY:无 WXPAY:无 |
5 |
goodsNum | number | 否 | - | 商品数量 最大长度15位,为非0整数 ACP: dctDetail.dctQuantity UMS:无 ALIPAY:无 WXPAY:无 |
10 |
goodsPrice | number | 否 | - | 商品价格 最大长度15位,单位:分 ACP:无 UMS:无 ALIPAY:无 WXPAY:无 |
15 |
goodsRemark | string | 否 | - | 商品备注 最大长度128位 ACP: dctDetail.addnInfo UMS:无 ALIPAY:无 WXPAY:无 |
test |
bankCardNo | string | 是 | - | 脱敏后的银行卡号,目前仅云闪付返回 | |
thirdPartyName | string | 是 | - | 第三方名称 | 微信钱包 |
queryResCode | string | 否 | - | 查询结果 00:成功,其余均为失败 | 00 |
queryResInfo | string | 否 | - | 查询结果描述 当queryResCode不为00时存在 | |
payCode | string | 否 | - | 付款码 | 132375608645791419 |
dealDate | string | 否 | - | 所查询交易交易日期 | 20230713 |
dealTime | string | 否 | - | 所查询交易交易时间 | 030957 |
originalAmount | string | 否 | - | 原终端上送金额 | 1 |
dealType | string | 否 | - | 交易类型 refund | refund |
dealSystemTraceNum | string | 否 | - | 所查询交易流水 | 032744 |
dealRetrievalRefNum | string | 否 | - | 所查询交易系统参考号 | 01305920024W |
batchNo | string | 否 | - | 批次号 | 000001 |
originalTransactionDate | string | 否 | - | 原交易日期 | 0713 |
origialRetrievalRefNum | string | 否 | - | 原交易系统参考号 | 01305920024W |
originalSettlementDate | string | 否 | - | 原始交易清算日期 格式:yyyyMMdd | 20230713 |
refundInvoiceAmount | string | 否 | - | 实际退款金额 最大长度12位,单位:分 | 1 |
oriInfo | object | 否 | - | 原文信息 支付渠道侧信息chnlInfo: chnlCode:支付渠道名称(ACP/ALIPAY/WXPAY) promotionDetail:微信优惠详情(base64编码,channel_code= WXPAY场景必填,具体格式参考微信refund_detail字段说明) cupPromotionInfo:银联活动优惠详情(base64编码,channel_code= ACP场景必填,具体格式参考银联couponInfo) issAddiData:银联付款方附加数据(base64编码,channel_code= ACP场景必填,具体格式参考银联issAddnData) 收单机构侧信息acqInfo: acqCode:收单机构名称(UMS) refundPromotionList:退货优惠详情(base64编码,acq_code =UMS场景必填,具体格式参考银联商务字段说明) |
|
refundPromotionList | string | 否 | - | 优惠出资明细 格式:商户优惠金额\ | 0 |
convMchntNo | string | 否 | - | 转商户商户号 | 103290070111417 |
convTermNo | string | 否 | - | 转终端终端号 | 12340511 |
chnlType | string | 否 | - | 目标渠道类型 目前仅数字货币二维码返回DCEP | |
acqInstCode | string | 否 | - | 受理银行机构代码 ,目前仅数字货币二维码返回 | |
issInstCode | string | 否 | - | 发卡行代码 详见返回码说明,目前仅数字货币二维码返回 |