Skip to main content

Refund


Transaction refund.

TRADE_PROCESSING (Transaction processing)

APPLY_SUCCESS (Application successful, a status only available 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, see supported service
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 consumption merchant order number
paytypeString(6)Payment type, see supported paytype
buyertypeString(7)Device type
ios, android, others
payment_typeString(20)Wallet type, consistent with the original consumption transaction, see supported payment_type
refund_noString(28)Merchant refund number
timeStringTime, format: yyyyMMddHHmmss
signString(64)Signature

View the supported service and its corresponding paytype and payment_type

Below is the correspondence between service, paytype and payment_type

servicepaytypepayment_typeDescription
service.alipay.qrcode.RefundAlipayALIPAYCN
ALIPAYHK
ALIPAYBOTH
Alipay qrcode Refund interface
service.wechat.qrcode.RefundWeChatWECHATCN
WECHATHK
WeChat qrcode Refund interface
service.atome.v1.qrcode.RefundATOMEATOMEATOME qrcode Refund interface
service.unionpay.qrcode.csb.RefundUnionPayUNIONPAYUnionPay qrcode Refund interface
api.service.gbpay.qrcode.cash.RefundGBPAYGBPAYGBPAY qrcode Refund interface
service.payme.qrcode.RefundPAYMEPAYMEPAYME qrcode Refund interface

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_status greater than 00 when returned
timeStringTime, format: yyyyMMddHHmmss
return_status >= 00 when returned
signString(64)Signature
return_status >= 00 when returned

NameTypeDescriptionRequirement
out_trade_noString(28)Original consumer merchant order number
trade_statusString(32)Transaction status, see Appendix 2
user_confirm_keyStringUser Key, provided by eftPay
trade_typeString(10)Order type, REFUND
buyer_idString(30)User identification
tidString(20)Terminal number, returned when the consumption request is sent
transaction_idString(64)Payment provider number
eftpay_trade_noString(28)eftPay order number, return configured
payment_typeString(20)Wallet type
trade_timeStringRefund time, format: yyyy-MM-dd HH:mm:ss
transaction_amountString(8)Refund amount
original_amountString(8)Original transaction amount
currencyString(10)Currency
refund_noString(28)Merchant refund number
refund_trade_noString(28)eftPay refund number, return configured
payment_amountString(12)Merchant actual receipt amount, UnionPay type returned
cost_amountString(12)User payment amount, UnionPay type returned
uplan_discountString(12)Uplan discount amount, UnionPay type returned
amount_discountString(12)Immediate discount amount, UnionPay type returned

{
    "service": "service.alipay.qrcode.Refund",
    "user_confim_key": "1234567890000",
    "transaction_amount": "0.01",
    "out_trade_no": "20190823191819",
    "paytype": "Alipay",
    "buyertype": "ios",
    "refund_no": "20190824094947",
    "payment_type": "ALIPAYCN",
    "time": "20230609110646",
    "sign": "a8239928297673469163534067af8c50dbd1d8edaf283453572fd36a78498a40"
}

{
    "return_char": "",
    "return_status": "00",
    "sign": "80082137c57af4d3f3113c2b9cd805649bbcb2a88ae6931f16a8a9ff1d4a8bd0",
    "time": "20190824094950",
    "out_trade_no": "20190823191819",
    "trade_status": "TRADE_CLOSED",
    "user_confirm_key": "S0003469",
    "trade_type": "SALE",
    "buyer_id": "",
    "tid": "",
    "transaction_id": "20190823191819",
    "eftpay_trade_no": "20190823191819",
    "payment_type": "ALIPAYCN",
    "trade_time": "20190824094950",
    "transaction_amount": "10.01",
    "original_amount": "10.01",
    "currency": "HKD",
    "refund_no": "20190823191819"
}