Refund
Transaction refund.
Currently only supports WeChat and Alipay.
TRADE_PROCESSING (Transaction processing)
↓
APPLY_SUCCESS (Application successful, only available when applying for a refund)
↓
TRADE_REFUND (Partial refund) / TRADE_CLOSED (Full refund, refund transaction closed) / TRADE_FAIL (Transaction failed)
Info
Refund:
{domain}/Servlet/AppTradeRefund.do
Apply for a refund:
{domain}/Servlet/AppTradeApplyRefund.do
(This interface is only effective for WeChat transactions, and calling this interface for Alipay transactions is equivalent to calling the refund interface)
https:/VMP/Servlet/AppTradeRefund.do
Apply for a refund:
https:/VMP/Servlet/AppTradeApplyRefund.do
Refund:
Name | Type | Description | Requirement |
---|---|---|---|
user_confirm_key | String(12) | User Key, provided by eftPay | |
return_amount | String(8) | Refund amount. Requires digits, maximum decimal places is 2 | |
eft_trade_no | String(28) | eftPay order numbereft_trade_no and out_trade_no choose one | |
out_trade_no | String(28) | Original consumer merchant order numberout_trade_no and eft_trade_no choose one | |
out_refund_no | String(28) | Merchant refund number | |
buyerType | String(7) | Device typeios , android , others | |
reason | String(256) | Refund reason | |
notify_url | String(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 | |
time | String | Time, format: yyyyMMddHHmmss | |
sign | String(64) | Signature |
Tips
- Priority
eft_trade_no
>out_trade_no
Name | Type | Description | Requirement |
---|---|---|---|
return_status | String(3) | Return status code, represents . Note: This parameter cannot be used to judge whether the transaction status is successful For other status codes, see Appendix 3 | |
return_char | String(100) | Return description, may change, cannot be used as a condition for judgment | |
time | String | Time, format: yyyyMMddHHmmss return_status >= 00 is returned | |
sign | String(64) | Signaturereturn_status >= 00 is returned |
Name | Type | Description | Requirement |
---|---|---|---|
out_trade_no | String(28) | Original merchant order number | |
out_refund_no | String(28) | Merchant refund number | |
eft_trade_no | String(28) | eftPay order number | |
trade_status | String(32) | Transaction status, see Appendix 2 | |
refund_time | String | Refund transaction time, format: yyyyMMddHHmmss | |
user_confirm_key | String | User Key, provided by eftPay | |
payType | String(6) | Payment type | |
buyerType | String(7) | Device type | |
wallet | String(20) | Wallet type | |
fee_type | String(5) | Currency | |
return_amount | String(8) | Refund amount | |
total_fee | String(8) | Original transaction amount | |
tid | String(20) | Terminal number, returned when the consumption request is sent | |
rate | String(10) | Transaction exchange rate, returned when configured |
{
"return_amount": "0.61",
"reason": "退款原因",
"buyerType": "android",
"eft_trade_no": "20005269520084311t5rutcv1734",
"user_confim_key": "S0003469",
"out_trade_no": "rrn_1686280005979",
"out_refund_no": "rrn_1686280005979R",
"time": "20230609110645",
"sign": "0f81b3875590a29b84fbbb2527bff48cd340f2bfb94589ab5c8dd4635629dbdc"
}
{
"user_confirm_key": "S0003469",
"return_amount": "0.22",
"wallet": "ALIPAYCN",
"return_char": "",
"out_refund_no": "rrn_1686280005983R",
"sign": "46735e26e0012fb5e1ca16cc9e365d19cb3a486250ebd29c3be4c7166fcd47c1",
"fee_type": "HKD",
"eft_trade_no": "20005269520084311t5rutcv1734",
"out_trade_no": "rrn_1686280005983",
"payType": "Alipay",
"refund_time": "20230609110645",
"trade_status": "TRADE_CLOSED",
"total_fee": "0.22",
"return_status": "00",
"buyerType": "android",
"time": "20230609110645"
}