Skip to main content

Refund


Transaction refund.

Currently only supports WeChat and Alipay.

TRADE_PROCESSING (Transaction processing)

APPLY_SUCCESS (Application successful, only when applying for a refund)

TRADE_REFUND (Partial refund) / TRADE_CLOSED (Full refund, refund transaction closed) / TRADE_FAIL (Transaction failed)

Info

{domain}/Servlet/JSAPIService.do

https://vmp.eftpay.com.cn/VMP/Servlet/JSAPIService.do

NameTypeDescriptionRequirement
serviceStringInterface name
service.alipay.jsapi.Refund
service.wechat.jsapi.Refund
Refund application interface: service.wechat.jsapi.ApplyRefund
user_confirm_keyString(12)User Key, provided by eftPay
transaction_amountString(8)Refund amount. Requires digits, maximum decimal length is 2
out_trade_noString(28)Original consumer merchant order number
paytypeString(6)Payment type
payment_typeString(20)Wallet type, consistent with the original consumption transaction
refund_noString(28)Merchant refund number
tidString(20)Merchant terminal number
total_feeString(8)Total transaction amount. Requires digits, maximum decimal length is 2
refund_descString(256)Refund reason
notify_urlString(240)Notification address, production environment only supports 80 and 443 ports, other ports need to apply. P.S. Effective when calling the refund application interface
timeStringTime, format: yyyyMMddHHmmss
signString(64)Signature

NameTypeDescriptionRequirement
return_statusString(3)Return status code, represents . Note: This parameter cannot be used as a judgment of whether the transaction status is successful
Other status codes see Appendix 3
return_charString(100)Return description, may change, cannot be used as a condition judgment
Return when return_status is greater than 00
timeStringTime, format: yyyyMMddHHmmss
return_status >= 00 return
signString(64)Signature
return_status >= 00 return

NameTypeDescriptionRequirement
out_trade_noString(28)Original consumer merchant order number
trade_statusString(32)Trade status, see Appendix 2
user_confirm_keyStringUser Key, provided by eftPay
paytypeString(6)Payment type
refund_noString(28)Merchant refund number
transaction_amountString(8)Refund amount
total_feeString(8)Original transaction amount
payment_typeString(20)Wallet type
tidString(20)Terminal number, returned when the consumption request is sent
rateString(10)Transaction exchange rate, return when configured
eftpay_trade_noString(28)eftPay order number, return when configured
refund_trade_noString(28)eftPay refund number, return when configured

{
    "service": "service.wechat.jsapi.Refund",
    "user_confirm_key": "S0003469",
    "transaction_amount": "0.01",
    "out_trade_no": "rrn_1686280006045",
    "paytype": "WeChat",
    "time": "20230609110646",
    "payment_type": "WECHATCN",
    "refund_no": "201901010011",
    "tid": "tid_3378",
    "total_fee": "10.01",
    "refund_desc": "test测试退款",
    "sign": "1029a666f791da4c2c65ecf37e4d16571ba868f88e2494101a9c6c76b7ac20eb"
}

{
    "return_status": "00",
    "return_char": "",
    "sign": "d2b6b03c564f87936d3a367f7c199ad607a405e7c0effa2db3eccff6178bd13e",
    "time": "20230609110646",
    "out_trade_no": "20190823191819",
    "trade_status": "TRADE_CLOSED",
    "user_confirm_key": "S0003469",
    "paytype": "WeChat",
    "refund_no": "10000000001",
    "transaction_amount": "0.03",
    "total_fee": "10.01",
    "payment_type": "WECHATCN",
    "tid": "t1230001",
    "rate": "0.88"
}