商户可以使用这个单笔退款接口来操作退款.
参数 |
类型 (长度是字节) |
描述 |
可选 |
示例 |
||
基本参数 |
||||||
service |
String |
接口名称 |
N |
forex_refund |
||
partner |
String(16) |
境外商户在支付宝的用户ID. 2088开头的16位数字 |
N |
2088001159940003 |
||
_input_charset |
String |
请求数据的编码集,支持UTF-8。 |
N |
UTF-8 |
||
sign_type |
String |
签名算法 DSA, RSA, and MD5. |
N |
RSA |
||
sign |
String |
签名值 |
N |
e5815a4556db338ed237f7d3fd222184 |
||
Business Parameter |
||||||
out_return_no |
String(64) |
外部退款请求的ID |
N |
|
||
out_trade_no |
String(64) |
境外商户交易号(确保在境外商户系统中唯一) |
N |
|||
return_amount |
Number(8,2) |
外币退款金额 |
Y |
100.30 |
||
currency |
String(10) |
外币币种 |
N | USD |
||
gmt_return |
String(14) |
YYYYMMDDHHMMSS 北京时间(+8) |
N |
|
||
return_rmb_amount |
Number(15) |
人民币退款金额 |
Y |
|
||
reason |
String(100) |
退款原因 |
Y |
test |
||
product_code |
String(32) |
网站支付: NEW_OVERSEAS_SELLER 手机浏览器或支付宝钱包支付: NEW_WAP_OVERSEAS_SELLER |
N |
NEW_OVERSEAS_SELLER |
|
|
split_fund_info |
String(1 600) |
分账信息,json 格式,具体请参见“退款分账明细说明” |
Y |
|
|
|
is_sync |
String(1) |
退款请求同步或异步处理。取值:Y或N。默认值:N,异步处理。如果该值为Y,notify_url将无意义 |
Y |
Y |
|
同步返回是xml格式的。
参数 | 类型 (长度是字节) |
描述 |
可选 |
示例 |
is_success |
String |
返回状态, ‘T’ or ‘F’ |
N |
T |
error |
String |
错误消息 |
Y |
REPEATED_REFUNDMENT_REQUEST |
https://intlmapi.alipay.com/gateway.do?reason=refund+test&return_amount=0.1&sign_type=MD5&gmt_return=20130812094000&out_trade_no=iamdjc456¤cy=HKD&sign=8e9004797d3c7112b907bd184d775662&_input_charset=UTF-8&out_return_no=test005&service=forex_refund&partner=2088701998606387
<?xml version="1.0" encoding="GBK"?>
<alipay>
<is_success>T</is_success>
</alipay>
<?xml version="1.0" encoding="utf-8"?>
<alipay>
<is_success>F</is_success>
<error>ILLEGAL_SIGN</error>
</alipay>