银联商务天满服务平台
Java PHP Python



public class OpenApiSdkTest {
    public static void main(String[] args) throws Exception{
        String url = "https://api-mop.chinaums.com/v1/inip/corporate-wallet/wechat-pay-point/order/refund";
        //开发者ID
        String appId = "平台分配";
        //开发者秘钥
        String appKey = "平台分配";
        //实例化客户端
        ConfigBean configBean = new ConfigBean();
        OpenApiContext context = new OpenApiContext();
        String request = "{\"requestTimestamp\":\"\",
                    \"srcReserve\":\"\",
                    \"merOrderId\":\"\",
                    \"mid\":\"\",
                    \"targetOrderId\":\"\",
                    \"tid\":\"\",
                    \"refundAmount\":\"\",
                    \"refundDesc\":\"\",
                    \"refundOrderId\":\"\",
                    \"refundVactInfo\":\"{}\"}";
        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/inip/corporate-wallet/wechat-pay-point/order/refund";
        $data = json_encode(array("requestTimestamp"=>"",
                    "srcReserve"=>"",
                    "merOrderId"=>"",
                    "mid"=>"",
                    "targetOrderId"=>"",
                    "tid"=>"",
                    "refundAmount"=>"",
                    "refundDesc"=>"",
                    "refundOrderId"=>"",
                    "refundVactInfo"=>"{}"));
        $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/inip/corporate-wallet/wechat-pay-point/order/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({\"requestTimestamp\":\"\",
                    \"srcReserve\":\"\",
                    \"merOrderId\":\"\",
                    \"mid\":\"\",
                    \"targetOrderId\":\"\",
                    \"tid\":\"\",
                    \"refundAmount\":\"\",
                    \"refundDesc\":\"\",
                    \"refundOrderId\":\"\",
                    \"refundVactInfo\":\"{}\"})
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/inip/corporate-wallet/wechat-pay-point/order/refund
  • 测试环境: POST https://test-api-open.chinaums.com/v1/inip/corporate-wallet/wechat-pay-point/order/refund

描述:

ContentType:application/json

请求头

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

请求参数

名称 类型 必填 最大长度 描述 示例值
requestTimestamp string - 报文请求时间,格式yyyy-MM-dd HH:mm:ss
srcReserve string 255 请求系统预留字段
merOrderId string 6-32 商户订单号
mid string 8-32 商户号
targetOrderId string 6-64 支付订单号
tid string 2-32 终端号
refundAmount number 1000000000 要退货的金额 若下单接口中上送了分钟标记字段divisionFlag,则该字段refundAmount 等于platformAmount 加上subOrders 中totalAmount 全额退款时refundAmount等于支付总金额totalAmount
refundDesc string 255 退货说明
refundOrderId string 6-32 退货交易的订单号,如不指定,则系统自动生成。 如商户指定,须以4位来源编号(由银商分配)开头。
refundVactInfo object 255 账户信息

响应示例

{
  "respCode":"",
  "respDesc":"",
  "srcReserve":"",
  "responseTimestamp":"",
  "mid":"",
  "tid":"",
  "merOrderId":"",
  "merName":"",
  "seqId":"",
  "status":"",
  "targetMid":"",
  "targetOrderId":"",
  "targetStatus":"",
  "targetSys":"",
  "totalAmount":0,
  "refundAmount":0,
  "refundFunds":"",
  "refundFundsDesc":"",
  "refundInvoiceAmount":0,
  "refundOrderId":"",
  "refundTargetOrderId":"",
  "yxlmAmount":0,
  "refundMerchantContribute":0,
  "refundOtherContribute":0
}

响应参数

名称 类型 必填 最大长度 描述 示例值
respCode string - 错误码
respDesc string - 错误信息
srcReserve string 255 请求系统预留字段
responseTimestamp string - 报文响应时间,格式yyyy-MM-dd HH:mm:ss
mid string - 商户号
tid string - 终端号
merOrderId string - 商户订单号
merName string - 商户名称
seqId string - 平台流水号
status string - 交易状态
targetMid string - 支付渠道商户号
targetOrderId string - 第三方订单号,退货交易时不返回
targetStatus string - 目标平台的状态
targetSys string - 目标平台代码
totalAmount number - 支付总金额
refundAmount number - 总退款金额
refundFunds string - 退款渠道列表
refundFundsDesc string - 退款渠道描述
refundInvoiceAmount number - 实付部分退款金额
refundOrderId string - 退货订单号
refundTargetOrderId string - 目标系统退货订单号
yxlmAmount number - 营销联盟优惠金额 仅享受联盟优惠的订单,查询返回
refundMerchantContribute number - 商户出资优惠金额 目前支持微信返回,其他渠道产品规划中
refundOtherContribute number - 其他出资优惠金额 目前支持微信返回,其他渠道产品规划中

错误码