退款

退款

POST/pay/trade/refund

对已完成订单发起退款。 此接口无需鉴权。

SDK 方法refund()

参数请求体

pay_memberidstringrequired

SDK 属性: payMemberid. 平台分配的商户号。

transaction_idstringrequired

SDK 属性: transactionId. 平台交易号。

pay_orderidstringrequired

SDK 属性: payOrderid. 商户订单号。

currencystringrequired

支付币种。

pay_amountstringrequired

SDK 属性: payAmount. 交易金额。

refund_amountstringrequired

SDK 属性: refundAmount. 退款金额。

refund_reasonstringrequired

SDK 属性: refundReason. 退款原因。

pay_md5signstringrequiredsign

SDK 属性: payMd5Sign. [MD5 签名算法说明](/docs/start#generate-signature)

响应

**200**：`PayTradeRefundResponse` 通过 `getResult()` 返回。

POST/pay/trade/refund

use JPayApiLib\Models\Requests\Builders\RefundRequestBuilder;

$request = RefundRequestBuilder::init()
    ->payMemberid('10153')
    ->transactionId('346874883747')
    ->payOrderid('O20260101001')
    ->currency('USD')
    ->refundAmount('10.00')
    ->refundReason('Customer request')
    ->payMd5Sign('YOUR_MD5_SIGN')
    ->build();

$apiResponse = $client->getPaymentsApi()->refund($request);

if ($apiResponse->isSuccess()) {
    /** @var \JPayApiLib\Models\PayTradeRefundResponse $result */
    $result = $apiResponse->getResult();
    var_dump($result);
}