11
- [产品介绍](./1) - [支付流程和用户体验](./3) - [快速开始](./34) - [支付流程](./35) - [退款流程](./36) - [查询流程](./37) - [对账流程](./53) - [二级商户维护流程](./38) - [接入指南](./39) - [密钥准备](./40) - [示例代码下载](./45) - [接口调用](./46) - [签名请求并创建请求URL](./47) - [通知处理](./48) - [异步通知验签](./49) - [同步通知验签](./50) - [沙箱测试](./41) - [沙箱环境使用准备](./42) - [沙箱部署](./43) - [沙箱运行](./44) - [应用上线](./51) - [接口列表](./6) - [网站支付接口](./6) - [请求参数](./6) - [同步返回](./7) - [示例](./8) - [异步通知](./9) - [错误码](./10) - [修改记录](./57) - [退款接口](./11) - [请求参数](./11#Request) - [同步返回](./11#Response) - [示例](./11#Samples) - [异步通知](./52) - [错误码](./12#Errors) - [修改记录](./57#Errors) - [单笔查询接口](./13) - [请求参数](./13#QueryRequest) - [同步返回](./13#QueryResponse) - [示例](./13#QuerySamples) - [错误码](./14#Errors) - [对账文件下载接口](./15) - [请求参数](./15#Forex_compare_file_Request) - [同步返回](./15#Forex_compare_file_Response) - [示例](./15#Forex_compare_file_Samples) - [错误码](./16) - [结算文件下载接口](./17) - [请求参数](./17#Forex_liquidation_file_Request) - [同步返回](./17#Forex_liquidation_file_Response) - [示例](./17#Forex_liquidation_file_Samples) - [错误码](./18) - [汇率查询接口](./19) - [请求参数](./19#Forex_rate_file_Request) - [同步返回](./19#Forex_rate_file_Response) - [示例](./19#Forex_rate_file_Samples) - [错误码](./20) - [境外二级线上商户报备接口](./33) - [请求参数](./33#request) - [同步返回](./33#sync) - [示例](./33#samples) - [错误码](./33#error) - [文档变动历史](./33#history) - [境外二级线上商户报备状态查询接口](./55) - [请求参数](./55#request) - [同步返回](./55#sync) - [示例](./55#samples) - [错误码](./55#error) - [文档变动历史](./55#history) - [数字签名](./54) - [密钥准备](./40) - [签名](./47) - [异步通知验签](./49) - [同步通知验签](./50) - [支付宝对账文件](./30) - [关于支付宝账单](./30) - [获取账单](./31) - [API](./31#API) - [支付宝国际网站](./31#Global) - [SFTP](./31#SFTP) - [账单详细内容](./32) - [交易文件](./32#TransactionFile) - [结算文件](./32#SettlementFile) - [常用链接](./25) - [国际商户服务网站](./25) - [分账明细说明](./28) - [退分账明细说明](./29)
新-境外收单 - PC

退款接口

商户可以使用这个单笔退款接口来操作退款.

请求参数

参数

类型 (长度是字节)

描述

可选

示例

基本参数

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

 

  1. 退款总金额不能超过原始的支付金额。
  2. 退款必须在一定的时间范围内申请(合同里面确定,默认是3个月)

同步返回

同步返回是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&currency=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>
客服小机器人

NEED HELP ?