1
- [文档说明](./1) - [产品介绍](./2) - [支付流程和用户体验](./3) - [快速接入](./4) - [示例代码下载](./4#DemoDownload) - [沙箱环境部署/运行](./4#RunSand) - [线上集成/运行](./4#Prod) - [接口列表](./6) - [手机网站支付接口](./6) - [请求参数](./6) - [同步返回](./7) - [示例](./8) - [异步通知](./9) - [错误码](./10) - [退款接口](./11) - [请求参数](./11#Request) - [同步返回](./11#Response) - [示例](./11#Samples) - [错误码](./12#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) - [异步通知验证接口](./21) - [请求参数](./21#Notify_verify_Request) - [同步返回](./21#Notify_verify_Response) - [示例](./21#Notify_verify_Samples) - [错误码](./22) - [数字签名](./23) - [签名机制](./23) - [生成待签名的字符串](./23#SignatureString) - [签名](./23#SignatureGen) - [使用OpenSSL来产生RSA密钥](./24) - [OpenSSL 安装](./24#OpenSSLInstallation) - [RSA 密钥对的产生](./24#RSAKeyPairGeneration) - [FAQ](./25) - [国际商户服务网站](./25) - [支持的结算货币币种](./27) - [分账明细说明](./28) - [退分账明细说明](./29) - [支付宝对账文件](./30) - [关于支付宝账单](./30) - [获取账单](./31) - [API](./31#API) - [支付宝国际网站](./31#Global) - [SFTP](./31#SFTP) - [账单详细内容](./32) - [交易文件](./32#TransactionFile) - [结算文件](./32#SettlementFile)
新境外收单 - WAP

文档说明

English Docs

阅读对象


本文档适用于希望集成支付宝跨境WAP支付解决方案的应用程序开发人员。 实施此解决方案需要软件开发技能。 您必须编写使用API请求和答复字段的代码,将支付宝跨境WAP支付解决方案集成到您现有的订单管理系统中

惯例


本文档中使用以下特殊语句:
Note包含有用的建议或重要说明,以成功与支付宝整合

联系我们


任何技术问题,请联系支付宝国际技术支持团队overseas_support@service.alibaba.com.
任何非技术问题,如如何与支付宝签约,请联系支付宝国际业务团队global.service@alipay.com .

 

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

请求参数

参数

类型 (长度是字节)

描述

可选

示例

基本参数

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>

Abbreviation

Currency

Decimal Number

AUD

澳元

2

CAD

加拿大元

2

CHF

瑞士法郎

2

DKK

丹麦克朗

2

EUR

欧元

2

GBP

英镑

2

HKD

港币

2

JPY

日元

0

KRW

韩元

0

NOK

挪威克朗

2

NZD

新西兰元

2

SEK

瑞典克朗

2

SGD

新币

2

THB

泰铢

2

USD

美元

2

商家经常需要对交易进行对账。商家可以通过这个接口下载最长10天时间范围内的交易来对账。

请求参数

参数

类型 (长度是字节)

描述

可选

示例

基本参数

 

service

String

接口名

N

forex_compare_file

partner

String(16)

境外商户在支付宝的用户ID.以2088开头的16位数字

N

2088001159940003

sign_type

String

签名方法
DSA, RSA, MD5.

N

RSA

sign

String

签名值

N

e5815a4556db338ed237f7d3fd222184

业务参数

start_date

String

交易的开始日期、格式为YYYYMMDD

N

 

end_date

String

交易的结束日期、格式为YYYYMMDD

N

 

  • 开始日期和结束日期最长10天
  • 当天的交易不会显示在下载的文件中
  • 现在这个接口只支持txt格式的文件下载。这个文件没有列标题。文件里的每个字段以“|”分割

同步返回

返回格式

返回内容可能是以下几种格式:

下载文件格式

序号

参数名

类型

备注

  •  

外部交易号

String(64)

境外商户交易号(确保在境外商户系统中唯一)

  •  

交易金额

Number(8,2)

商品的金额(外币)

  •  

币种

String(10)

显示币种简称,具体参考附录:货币表

  •  

付款时间

String(14)

YYYYMMDDHHMMSS 格式,状态为“失败”和“待处理”的情况,这个域为空

  •  

清算时间

String(14)

YYYYMMDDHHMMSS 格式,如果没有清算,这个域为空

  •  

交易类型

String(1)

正常交易:P
申请退款:R

  •  

手续费

Number(8,2)

收取的手续费

  •  

状态

String(1)

正常交易记录状态:已付款:P    已清算:L
申请退款记录状态:待处理:W   失败:F 
“待处理”表示提交的退款申请支付宝系统还没有及时处理,“失败”表示提交的退款申请没有通过。

  •  

备注

String(50)

备注信息(可选),如果记录为“失败”或“待处理”状态的退款记录,备注里增加退款申请时间,YYYYMMDDHHMMSS格式

  •  

分账外币金额

Number(8,2)

该笔交易或退款对应的境内分账、退分账外币金额

  •  

分账人民币金额

Number(8,2)

该笔交易或退款对应的境内分账、退分账人民币金额

示例

请求示例

https://mapi.alipay.com/gateway.do?sign_type=MD5&sign=bb4c92c7cb7fc8a5280fe5f9f7ac309c&_input_charset=UTF-8&end_date=20150524&service=forex_compare_file&partner=2088002007018916&start_date=20150520

返回示例

成功返回

成功的http返回是一个带交易记录的txt文件:

业务逻辑出错:
File download failed: Over 10 days to Date period
网关错误:
<?xml version="1.0" encoding="UTF-8"?>
<alipay>
<is_success>F</is_success>
<error>ILLEGAL_SIGN</error>
</alipay>

示例下载文件

23342347424|112.11|USD|20070616090001||P|2.24|P|Unliquidated
23342343423|102.32|USD|20070615090001|2007622090001|P|2.04|L|Liquidated

商家可以通过这个接口来查看上次结算以来的交易结算信息。

请求参数

参数

类型 (长度是字节)

描述

可选

示例

基本参数

service

String

接口名

N

forex_liquidation_file

partner

String(16)

境外商户在支付宝的用户ID. 2088开头的16位数字

N

2088001159940003

sign_type

String

签名算法: DSA, RSA, MD5.

N

RSA

sign

String

签名值

N

e5815a4556db338ed237f7d3fd222184

业务参数

start_date

String

交易的开始日期,格式为YYYYMMDD

N

 

end_date

String

交易的结束日期,格式为YYYYMMDD

N

  • 开始日期和结束日期最长10天
  • 当天的交易不会显示在下载的文件中
  • 现在这个接口只支持txt格式的文件下载。这个文件没有列标题。文件里的每个字段以“|”分割

同步返回

返回格式

返回内容可能是以下几种格式:

结算文件格式

序号

域名

类型

备注

  •  

外部交易号

String(64)

境外商户交易号(确保在境外商户系统中唯一)

  •  

交易金额

Number(8,2)

商品的金额(外币)

  •  

币种

String(10)

显示币种简称,具体参考附录:货币表

  •  

付款时间

String(14)

YYYYMMDDHHMMSS 格式,状态为“失败”和“待处理”的情况,这个域为空

  •  

清算时间

String(14)

YYYYMMDDHHMMSS 格式,如果没有清算,这个域为空

  •  

交易类型

String(1)

正常交易:P
申请退款:R

  •  

手续费

Number(8,2)

收取的手续费

  •  

状态

String(1)

正常交易记录状态: 已清算:L
正常退款记录状态: 已清算:L

  •  

备注

String(50)

交易项的名称,不支持特殊符号。

  •  

分账外币金额

Number(8,2)

该笔交易或退款对应的境内分账、退分账外币金额

  •  

分账人民币金额

Number(8,2)

该笔交易或退款对应的境内分账、退分账人民币金额

示例

请求示例

https://mapi.alipay.com/gateway.do?sign_type=MD5&sendFormat=normal&sign=bb4c92c7cb7fc8a5280fe5f9f7ac309c&_input_charset=UTF-8&end_date=20150524&service=forex_liquidation_file&partner=2088002007018916&start_date=20150520

返回示例

成功返回

成功的http返回是一个带交易记录的txt文件::

This interface enables the merchant reconcile the settled transactions with the settlement of the funds in the previous settlement cycle.

Request Parameters

Parameter

Type (length in bytes)

Description

Optional

Example

Basic Parameter

service

String

Service Name

N

forex_liquidation_file

partner

String(16)

Partner ID.
Composed of 16 digits beginning with 2088.

N

2088001159940003

sign_type

String

Signature method. The following are supported. Must be uppercase.
DSA, RSA, and MD5.

N

RSA

sign

String

Signature value.

N

e5815a4556db338ed237f7d3fd222184

Business Parameter

start_date

String

The start date of the reconciliation period, formatted as YYYYMMDD

N

 

end_date

String

The end date of the reconciliation period, formatted as   YYYYMMDD

N

 

  • The starting and end dates should be provided within a 10-day interval.
  • There is a time delay such that the transactions in the current day will not be listed in the return of this API call.
  • Currently the interface only supports .TXT file to be downloaded. The file contains no headings for data fields. Each data field is separated by “|”, following the order given in the specification.

Sync Response

Response format

The responses could be in different formats for different use cases

File Format for the Settlement file in the Response

Order

Field name

Type

Description

1

Partner transaction ID

String(32)

The  Unique transaction ID passed by the merchants in the payment transaction

2

Amount

Number(8,2)

The amount of fund in foreign currency.

3

Currency

String(10)

Abbreviated currency names.

4

Payment Time

String(14)

YYYYMMDDHHMMSS
Empty if the status being “failed” or “waiting”.

5

Settlement Time

String(14)

YYYYMMDDHHMMSS
Empty if unliquidated

6

Transaction type

String(1)

Normal transaction: P
Refund transaction: R

7

Service charge

Number(8,2)

The amount of service charge.

8

Status

String(1)

Normal transaction:
L: Liquidated
Refund transaction:
L: Liquidated

9

Remark

String(50)

The name of the items. It should not contain special symbols.

10

Split foreign currency amount

Number(8,2)

This trade's split foreigh currency amount or this refund's split refund foreigh currency amount.

11

Split RMB amount

Number(8,2)

This trade's split RMB amount or this refund's split refund RMB amount.

Samples

Request Sample

https://mapi.alipay.com/gateway.do?sign_type=MD5&sendFormat=normal&sign=bb4c92c7cb7fc8a5280fe5f9f7ac309c&_input_charset=UTF-8&end_date=20150524&service=forex_liquidation_file&partner=2088002007018916&start_date=20150520

Response Samples

Success response

The response is HTTP response with an attached file, which is the settlement file with the transactions included.
The sample is for illustration of the browser download.

Error response from the biz logic:

File download failed: Over 10 days to Date period

Error response from the Gateway:

<?xml version="1.0" encoding="UTF-8"?>
<alipay>
<is_success>F</is_success>
<error>ILLEGAL_SIGN</error>
</alipay>

An example of settlement report file:

23342343423|102.32|USD|20070615090001|2007622090001|P|2.04|L|Liquidated

业务逻辑错误返回:
File download failed: Over 10 days to Date period
网关错误返回:
<?xml version="1.0" encoding="UTF-8"?>
<alipay>
<is_success>F</is_success>
<error>ILLEGAL_SIGN</error>
</alipay>

示例结算文件

下面是一个示例结算文件:

23342343423|102.32|USD|20070615090001|2007622090001|P|2.04|L|Liquidated

商家可以使用这个接口来查询支付宝参考汇率。

  • 货币间的汇率会在北京时间每日9:00到11:00间变动一次;
  • 汇率每日获取上限为100次。
  • 请求参数

    字段名

    变量名

    类型

    说明

    可空

    基本参数

    接口名称

    service

    String

    service=forex_rate_file

    N

    境外商户

    partner

    String(16)

    境外商户在支付宝的用户ID

    N

    签名

    sign

    String

    签名值

    N

    签名方式

    sign_type

    String

    签名方式,MD5, RSA, DSA

    N

    • 接口下载的是一个txt文件
    • 文件内容没有列标题并且数据字段之间用”|”分割
    • 只能下载当天的参考汇率,并不是交易发生时的真实汇率。真实汇率以交易时的页面展示为准。

    同步返回

    返回格式

    返回内容可能是以下几种格式:

    返回的文件格式

    序号

    域名

    类型

    备注

    1

    日期

    String(8)

    汇率发布的日期:YYYYMMDD

    2

    时间

    String(6)

    汇率发布的时间点:HHMMSS

    3

    币种符号

    String(3)

    货币的符号,请参考币种表

    4

    汇率

    String(14)

     

    示例

    请求示例

    https://mapi.alipay.com/gateway.do?sign_type=MD5&sendFormat=normal&sign=590a9fbbed8a5b9a86b426795445f9f0&service=forex_rate_file&partner=2088101122136241

    示例汇率文件:

    20160504|100030|CHF|6.829600|
    20160504|100030|EUR|7.491500|
    20160504|100030|THB|0.185877|
    20160504|100030|DKK|1.007800|
    20160504|100030|SGD|4.815600|
    20160504|100030|GBP|9.476100|
    20160504|100030|HKD|0.838800|
    20160504|100030|NOK|0.803000|
    20160504|100030|CAD|5.124900|
    20160504|100030|KRW|0.005814|
    20160504|100030|NZD|4.496100|
    20160504|100030|JPY|0.060934|
    20160504|100030|AUD|4.877600|
    20160504|100030|SEK|0.809800|
    20160504|090530|USD|6.534600|

     

    返回示例

    成功返回

    成功的返回是一个带汇率信息的txt文件:

    业务逻辑错误返回:
    File download failed: Over 10 days to Date period
    网关错误返回:
    <?xml version="1.0" encoding="UTF-8"?>
    <alipay>
    <is_success>F</is_success>
    <error>ILLEGAL_SIGN</error>
    </alipay>

    通过单笔交易查询接口,商户可以根据支付宝交易订单号或商户网站唯一订单号查询交易详细信息。

    请求参数

    参数

    类型(长度范围)

    参数说明

    是否可为空

    样例

    基本参数

    service

    String

    接口名称。

    不可空

    single_trade_query

    partner

    String(16)

    签约的支付宝账号对应的支付宝唯一用户号。
    以2088开头的16位纯数字组成。

    不可空

    2088001159940003

    _input_charset

    String

    商户网站使用的编码格式,如utf-8、gbk、gb2312等。

    不可空

    GBK

    sign

    String

    参数值

    不可空

    d8ed9f015214e7cd59bfadb6c945a87b

    sign_type

    String

    签名方式只支持DSA、RSA、MD5。

    不可空

    MD5

    业务参数

    trade_no

    String(64)

    支付宝根据商户请求,创建订单生成的支付宝交易号。
    最短16位,最长64位。
    建议使用支付宝交易号进行查询,用商户网站唯一订单号查询的效率比较低。

    可空

    2010121502730740

    out_trade_no

    String(64)

    支付宝合作商户网站唯一订单号(确保在商户系统中唯一)。

    可空

    210909550602881

    同步返回

    参数

    类型(长度范围)

    参数说明

    是否可为空

    样例

    基本参数

    is_success

    String

    请求是否成功。请求成功不代表业务处理成功。

    • T代表成功
    • F代表失败

    不可空

    T

    sign

    String

    签名值

    不可空

    tphoyf4aoio5e6zxoaydjevem2c1s1zo

    sign_type

    String

    签名方式只支持DSA、RSA、MD5。

    不可空

    MD5

    error

    String

    只有当查询交易失败后,才返回错误代码。

    可空

    TRADE_NOT_EXIST

    业务参数

    buyer_email

    String

    买家支付宝账号。

    不可空

    tianc002@alipay.com

    buyer_id

    String

    买家支付宝账号对应的支付宝唯一用户号。

    不可空

    2088002007274897

    trade_status

    String

    交易状态包含:

  • TRADE_FINISHED
  •  WAIT_BUYER_PAY
  • TRADE_CLOSED
  • 不可空

    TRADE_FINISHED

    is_total_fee_adjust

    String

    • 调整过-T;
    • 没有调整过-F。

    不可空

    F

    out_trade_no

    String

    支付宝合作商户网站唯一订单号(确保在商户系统中唯一)。

    可空

    20080108-5

    trade_no

    String(64)

    支付宝根据商户请求,创建订单生成的支付宝交易号。
    最短16位,最长64位。

    不可空

    2010073000019942

    subject

    String

    商品的标题/交易标题/订单标题/订单关键字等。

    不可空

    Cannon相机

    flag_trade_locked

    String

    • 1表示冻结;
    • 0表示未冻结。

    不可空

    0

    body

    String

    对一笔交易的具体描述信息。如果是多种商品,请将商品描述字符串累加传给body。

    不可空

    Canon最新款卡片机

    gmt_create

    Date

    交易创建的时间。
    格式为yyyy-MM-dd HH:mm:ss。

    不可空

    2008-01-08 20:36:12

    seller_email

    String

    卖家的支付宝账号。

    不可空

    tianc001@alipay.com

    seller_id

    String

    卖家支付宝账号对应的支付宝唯一用户号。
    以2088开头的纯16位数字。

    不可空

    2088002007272365

    total_fee

    String

    单位:RMB。交易金额大于0元。
    担保交易单笔交易金额不能超过100万,精确到小数点后两位。

    不可空

    325

    price

    String

    单位为:RMB Yuan。取值范围为[0.01,1000000.00],精确到小数点后两位。

    可空

    10.00

    quantity

    String

    购买数量。

    可空

    1

    use_coupon

    String

    • 使用过-T;
    • 未使用过-F。

    可空

    T

    discount

    String

    折扣。

    可空

    0.00

    gmt_last_modified_time

    Date

    交易额最新修改时间。
    格式为yyyy-MM-dd HH:mm:ss。

    可空

    2008-01-08 20:39:30

    gmt_payment

    Date

    交易付款的时间。
    格式为yyyy-MM-dd HH:mm:ss。

    可空

    2008-01-08 20:39:30

    to_buyer_fee

    String

    累计的已经退款金额。

    可空

    1.00

    to_seller_fee

    String

    累计的已打款给卖家的金额。

    可空

    20.00

    payment_type

    String

    收款类型。取值范围请参见“收款类型 ”。

    可空

    1

    operator_role

    String

    • B:买家
    • S:卖家

    可空

    B

     

    示例

    请求示例

    https://mapi.alipay.com/gateway.do?service=single_trade_query&sign=d8ed9f015214e7cd59bfadb6c945a87b&trade_no=2010121502730740&partner=2088721091300630&out_trade_no=2009011803596246&sign_type=MD5

    返回示例

    成功返回
    <alipay>
    <is_success>T</is_success>
    <request>
    <param name="_input_charset">UTF-8</param>
    <param name="service">single_trade_query</param>
    <param name="partner">2088721091300630</param>
    <param name="out_trade_no">2009011803596246</param>
    <param name="sendFormat">normal</param>
    </request>
    <response>
    <trade>
    <body>hello</body>
    <buyer_email>intltest059@service.alipay.com</buyer_email>
    <buyer_id>2088122921745555</buyer_id>
    <discount>0.00</discount>
    <flag_trade_locked>0</flag_trade_locked>
    <gmt_create>2017-06-15 16:25:31</gmt_create>
    <gmt_last_modified_time>2017-06-15 16:25:58</gmt_last_modified_time>
    <gmt_payment>2017-06-15 16:25:58</gmt_payment>
    <is_total_fee_adjust>F</is_total_fee_adjust>
    <operator_role>B</operator_role>
    <out_trade_no>2009011803596246</out_trade_no>
    <payment_type>100</payment_type>
    <price>0.02</price>
    <quantity>1</quantity>
    <seller_email>test@126.com</seller_email>
    <seller_id>2088721091300630</seller_id>
    <subject>world</subject>
    <to_buyer_fee>0.00</to_buyer_fee>
    <to_seller_fee>0.02</to_seller_fee>
    <total_fee>0.02</total_fee>
    <trade_no>2017061521001003550204235677</trade_no>
    <trade_status>TRADE_FINISHED</trade_status>
    <use_coupon>F</use_coupon>
    </trade>
    </response>
    <sign>6283ce0cf5aaa812d9c1d29719d53e8d</sign>
    <sign_type>MD5</sign_type>
    </alipay>
    错误输出
    <?xml version="1.0"  encoding="utf-8"?>
      <alipay>
      <is_success>F</is_success>
      <error>ILLEGAL_SIGN</error>
      </alipay>

    支付宝国际为境外收单与境外当面付商户提供的账单。商家可以通过获取这些账单对交易进行对账。 账单中包含商户每日的交易文件和结算文件,结算文件仅在当日有结算时才会生成。通过SFTP站点或支付宝国际网站下载时,当日有结算的前提下还会有结算汇总文件。

    结算时间

    交易文件生成时间

    结算文件生成时间

    注意:

    • 周五00:00 到周日23:59的对账文件在下周一生成
    • 节假日前一天起,连同节假日期间的对账文件,会在假期后第一个工作日生成

    账单下载途径有:API,支付宝国际网站,和SFTP。各渠道获取的对账文件在命名和字段数目上有所不同。具体见下文。

    API

    商家平台集成新境外收单API后,通过调用相关接口即可得到对账账单文件。

    对账文件下载接口用于获取交易文件。

    结算文件下载接口用于获取结算文件。

    支付宝国际网站(global.alipay.com)

    访问并登录支付宝国际网站– My Alipay – My Transaction。你可以在线查看交易文件和结算文件,也可以通过点击Download Files下载。

    注意:

    SFTP

    如需要通过SFTP获取对账记录,请完成以下步骤:

    1. 申请SFTP账号
    2. 商户集成上线后,可将PID和访问支付宝SFTP站点的IP地址(注意,必须是非内网IP地址)发至支付宝国际技术支持中心申请。支付宝国际技术支持中心将在5个工作日内为您配置好SFTP账单对应的登陆账号。

    3. 账户获取成功后连接站点访问
    4. 下载Winscp。填入以下信息进行访问:

      • 端口:22
      • 主机名称:根据网络情况选择sftp.alipay.com(国内) / isftp.alipay.com(美国)
      • 用户名及密码
    • 90天内未使用的SFTP账户将会被关闭;
    • 超过一周的SFTP账单会被不定期删除,商户尽量在3天内处理账单。如果商户因未及时处理账单,发现账单已经被清理,请联系Global Merchant Technical Support

    账单中包含商户交易文件和结算文件。SFTP和支付宝国际网站下载的结算文件还包含结算汇总文件。API, SFTP和支付宝国际网站下载的文件有所差别。下面对交易和结算文件的文件命名方式,详细内容和差别进行说明。

    交易文件

    交易文件包含了所选时间内的交易记录。

    取决于交易文件的下载方式,文件名可能含有不同的部分。详情请见下表:

    方式

    Partner ID

    日期

    文件类型

    文件后缀

    示例

    API

    支付宝分配的唯一ID

    YYYYMMDD + 6位随机码

    /

    .txt

    2088021017666931_20180531143440.txt

    支付宝国际网站

    支付宝分配的唯一ID

    YYYYMMDD,YYYYMM或YYYYMMDD + 6位随机码

    /

    .csv、.txt、.xls

    2088611221573217_20180621151516.xls

    SFTP

    支付宝分配的唯一ID

    YYYYMMDD

    固定值:transaction

    .csv

    2088721149955614_fptrade_20180823.csv

    交易文件可能包含的所有内容如下表所示:

    序号

    字段名称

    说明

    1

    Partner_transaction_id

    商户交易号(即:支付时请求参数中的Out_trade_no或者退款时的out_return_no)

    2

    Amount

    交易金额(外币)

    3

    Rmb_amount

    交易金额(人民币)

    4

    Currency

    币种

    5

    Fee

    手续费(外币)

    6

    Rate

    汇率

    7

    Payment_time

    支付时间

    8

    Settlement_time

    结算时间

    9

    Type

    交易类型

    10

    Status

    状态(正常交易记录状态:
    已付款:P
    已清算:L 申请退款记录状态:
    待处理:W
    失败:F)

    11

    Original_partner_transaction_ID

    原始商户交易号(即:支付时上传的out_trade_no)。
    注:非默认字段。如需添加此字段请联系Alipay Overseas Support进行配置。

    12

    Transaction_ID

    支付宝交易号。
    注:非默认字段。如需添加此字段请联系Alipay Overseas Support进行配置。

    13

    Distribute_amount

    分账外币金额

    14

    Distribute_rmb_amount

    分账人民币金额

    15

    Remarks

    备注

    16

    Settlement

    结算金额(外币)

    17

    Rmb_settlement

    结算金额(人民币)

    API、支付宝国际网站、SFTP下载的交易文件所含内容的不同之处,如下表所示:

    序号

    字段名称

    SFTP

    API

    Global在线

    Global离线

    1

    Partner_transaction_id

    2

    Amount

    3

    Rmb_amount

    4

    Currency

    5

    Fee

    6

    Rate

    7

    Payment_time

    8

    Settlement_time

    9

    Type

    10

    Status

    11

    Original_partner_transaction_ID

    12

    Transaction_ID

    13

    Distribute_amount

    14

    Distribute_rmb_amount

    15

    Remarks

    16

    Settlement

    17

    Rmb_settlement

    结算文件

    结算文件包含了所选时间内的结算记录。

    注意:

    支付宝国际网站Download Files页面和SFTP下载的结算文件为文件压缩包,压缩包中包含结算概要文件和具体结算文件。 压缩包的文件命名规则为:<PID>_<日期>.zip,例如:2088021******931_20180508.zip

    结算概要文件

    从支付宝国际网站Download Files页面和SFTP下载的结算文件都含有名为settlebatch 的结算概要文件。Settlebatch文件名包含以下部分:

    Partner ID

    文件类型

    日期

    文件后缀

    示例

    支付宝分配的唯一ID

    固定值:settlebatch

    YYYYMMDD

    .csv

    2088021******931_settlebatch_20180531.csv

    Settlebatch可能包含以下字段:

    序号

    字段名称

    说明

    1

    settle_batch_no

    支付宝内部文件序号

    2

    settle_date

    结算时间

    3

    Amount

    交易金额(外币)

    4

    Fee

    手续费(外币)

    5

    Settlement

    结算金额(外币)

    6

    Currency

    币种

    结算文件

    结算文件包含了所选时间内结算详情。

    取决于文件的下载方式,文件名可能含有不同的部分。详情请见下表:

    方式

    Partner ID

    文件类型

    日期

    系统分配ID

    文件后缀

    示例

    API

    支付宝分配的唯一ID

    /

    YYYYMMDD + 6位随机码

    /

    .txt

    2088021017666931_20180531143440.txt

    支付宝国际网站

    支付宝分配的唯一ID

    固定值:settle

    YYYYMMDD,YYYYMM或YYYYMMDD + 6位随机码

    系统自动分配的唯一ID

    .csv、.txt、.xls

    2088721631012256_settle_20171106_50002017080100032007000005107441.csv

    SFTP

    支付宝分配的唯一ID

    固定值:settle

    YYYYMMDD

    系统自动分配的唯一ID

    .csv

    2088721631012256_settle_20171106_50002017080100032007000005107441.csv

    结算文件可能包含的所有内容如下表所示:

    序号

    字段名称

    说明

    1

    Partner_transaction_id

    商户交易号(即:支付时请求参数中的Out_trade_no或者退款时的out_return_no)

    2

    Transaction_ID

    支付宝交易号。
    注:非默认字段。如需添加此字段请联系Alipay Overseas Support进行配置。

    3

    Original_partner_transaction_ID

    原始商户交易号(即:支付时上传的out_trade_no)。
    注:非默认字段。如需添加此字段请联系Alipay Overseas Support进行配置。

    4

    Amount

    交易金额(外币)

    5

    Rmb_amount

    交易金额(人民币)

    6

    Currency

    币种

    7

    Fee

    手续费(外币)

    8

    Rate

    汇率

    9

    Payment_time

    支付时间

    10

    Settlement_time

    结算时间

    11

    Type

    交易类型

    12

    Status

    交易状态

    13

    Distribute_amount

    分账外币金额

    14

    Distribute_rmb_amount

    分账人民币金额

    15

    Remarks

    备注

    16

    Settlement

    结算金额(外币)

    17

    Rmb_settlement

    结算金额(人民币)

    18

    Stem_From

    交易来源于何种类型商户:

  • M:境外收单商户;
  • T:天猫国际商户。
  • 在线查看到的结算文件,和通过API、支付宝国际网站、SFTP获得的结算文件,内容不完全相同。具体如下表所示:

    序号

    字段名称

    SFTP

    API

    Global离线

    1

    Partner_transaction_id

    2

    Transaction_ID

    3

    Original_partner_transaction_ID

    4

    Amount

    5

    Rmb_amount

    6

    Fee

    7

    Distribute_amount

    8

    Distribute_rmb_amount

    9

    Settlement

    10

    Rmb_settlement

    11

    Currency

    12

    Rate

    13

    Payment_time

    14

    Settlement_time

    15

    Type

    16

    Status

    17

    Remarks

    18

    Stem_From

    客服小机器人

    NEED HELP ?