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/refund";
        //开发者ID
        String appId = "平台分配";
        //开发者秘钥
        String appKey = "平台分配";
        //实例化客户端
        ConfigBean configBean = new ConfigBean();
        OpenApiContext context = new OpenApiContext();
        String request = "{\"requestTimestamp\":\"2022-04-15 10:42:59\",
                    \"merOrderId\":\"327M202204141724489725391331\",
                    \"instMid\":\"YUEDANDEFAULT\",
                    \"mid\":\"898340149000005\",
                    \"tid\":\"00000001\",
                    \"refundAmount\":\"1\",
                    \"msgId\":\"TDCDFD91420230700079549371\",
                    \"srcReserve\":\"保留字段\",
                    \"refundOrderId\":\"14HC202307191629589288166704\",
                    \"platformAmount\":\"680\",
                    \"subOrders\":\"[{\"mid\":\"898310148160568\",\"merOrderId\":\"14HC202307191435078140652400\",\"refundOrderId\":\"14HC202307191629589288166704\",\"totalAmount\":\"1\"}]\",
                    \"refundDesc\":\"退款\"}";
        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/refund";
        $data = json_encode(array("requestTimestamp"=>"2022-04-15 10=>42=>59",
                    "merOrderId"=>"327M202204141724489725391331",
                    "instMid"=>"YUEDANDEFAULT",
                    "mid"=>"898340149000005",
                    "tid"=>"00000001",
                    "refundAmount"=>"1",
                    "msgId"=>"TDCDFD91420230700079549371",
                    "srcReserve"=>"保留字段",
                    "refundOrderId"=>"14HC202307191629589288166704",
                    "platformAmount"=>"680",
                    "subOrders"=>"json_encode(array([{"mid"=>"898310148160568","merOrderId"=>"14HC202307191435078140652400","refundOrderId"=>"14HC202307191629589288166704","totalAmount"=>"1"}]))",
                    "refundDesc"=>"退款"));
        $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/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\":\"2022-04-15 10:42:59\",
                    \"merOrderId\":\"327M202204141724489725391331\",
                    \"instMid\":\"YUEDANDEFAULT\",
                    \"mid\":\"898340149000005\",
                    \"tid\":\"00000001\",
                    \"refundAmount\":\"1\",
                    \"msgId\":\"TDCDFD91420230700079549371\",
                    \"srcReserve\":\"保留字段\",
                    \"refundOrderId\":\"14HC202307191629589288166704\",
                    \"platformAmount\":\"680\",
                    \"subOrders\":\"[{\"mid\":\"898310148160568\",\"merOrderId\":\"14HC202307191435078140652400\",\"refundOrderId\":\"14HC202307191629589288166704\",\"totalAmount\":\"1\"}]\",
                    \"refundDesc\":\"退款\"})
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/refund
• 测试环境: POST https://test-api-open.chinaums.com/v1/netpay/refund

描述：当成功交易之后一段时间内，由于买家或商户的原因需要退款时，商户可以通过本接口将支付款退还给买家，退款请求验证成功之后，银商将通知支付渠道方按照退款规则把支付款按原路退回到买家帐号上。退款订单号refundOrderId也需遵循商户订单号生成规范，即以银商分配的4位来源编号作为账单号的前4位，且在商户系统中此账单号保证唯一。总长度需大于6位，小于28位。银商的推荐规则为（无特殊情况下，建议遵守此规则）：{来源编号(4位)}{时间(yyyyMMddmmHHssSSS)(17位)}{7位随机数}

ContentType：HTTP(S) + JSON

请求头

请求参数

响应示例

{
  "errCode":"SUCCESS",
  "errMsg":"现金退款成功",
  "responseTimeStamp":"2022-04-15 10:42:59",
  "mid":"898340149000005",
  "tid":"00000001",
  "refundMerchantContribute":"35",
  "refundOtherContribute":"35",
  "msgId":"0DUNOje1Bwtue6XinEs7DWhKS2NmUCVg",
  "srcReserve":"保留字段",
  "merOrderId":"14HC202307191435078140652400",
  "merName":"测试商户",
  "seqId":"35316083395N",
  "status":"TRADE_SUCCESS",
  "targetMid":"463293816",
  "targetOrderId":"SUCCESS|SUCCESS",
  "targetStatus":"",
  "targetSys":"WXPay",
  "totalAmount":"63",
  "refundAmount":"63",
  "refundFunds":"现金:63",
  "refundFundsDesc":"现金退款0.63元",
  "refundInvoiceAmount":"63",
  "refundOrderId":"14HC202307191629589288166704",
  "refundTargetOrderId":"50101606602023071990193380315",
  "refundStatus":"",
  "yxlmAmount":"35"
}

响应参数

错误码