翻译公司资讯

世联翻译公司完成电子系统类中文翻译

发布时间：2018-11-27 08:48　　点击：

世联翻译公司完成电子系统类中文翻译

1 文档说明

1.1 功能描述

通过支付宝的支付渠道，付款者可以直接汇款给另一个拥有支付宝账号的收款者。

1.2 阅读对象

支付宝纯网关接口文档是面向具有一定的网站开发能力，了解ASP、PHP、JAVA、ASP.NET等开发语言中的一种及SQL数据库语言的网站开发、维护和管理人员。

1.3 业务术语

表1-1 业务术语

术语解释

CTU 支付宝风险稽查系统。

纯网关网银支付，无需访问支付宝，直接跳转到网银进行支付，由商户指定银行列表，买家选择。

返回页面跳转同步通知。支付宝根据得到的数据处理完成后，当前页面从支付宝的页面自动跳转回商户的网站，同时携带处理完成的结果信息反馈给商户网站。

防钓鱼 “网络钓鱼”攻击利用欺骗性的电子邮件和伪造的Web站点来进行诈骗活动，受骗者往往会泄露自己的财务数据，如银行卡号、账户用户名、口令和社保编号等内容，造成损失。防钓鱼用来防止以上情况的发生。

分润分润是指将交易金额中的一部分转账给其它账户。

红包支付宝红包为现金红包，可直接使用于相应范围的交易。

卡通支付宝卡通是将用户的支付宝账户与银行卡连通，不需要开通网上银行，即可直接在网上付款，并且享受支付宝提供的“先验货，再付款”的担保服务。

请求通过HTTP协议把需要传输的数据发送给接收方的过程。

通知服务器异步通知。支付宝根据得到的数据处理完成后，支付宝的服务器主动发起通知给商户的网站，同时携带处理完成的结果信息反馈给商户网站。

伪网关网银支付，需要访问支付宝，在统一收银台选择银行，由买家选择。

2 功能演示

步骤1：进入充值平台，选择网上银行。

(1) 选择招商银行，输入充值金额：

图2-1充值平台

(2) 确认网银充值信息：

图2-2 确认充值信息

步骤2：生成充值订单，跳转银行页面，确认支付。

(1) 选择网银入口，页面如图2-3所示：

图2-3 网银入口

(2) 进入网银页面，确认支付：

图2-4 确认支付

步骤3：完成支付。

(1) 支付完成之后，网银提示支付成功：

图2-5 网银成功页面

(2) 付款完成后，跳回支付宝页面，提示成功付款：

图2-6 支付成功页面

步骤4：页面自动跳转回商户网站。

若在支付时，传递给支付宝的参数中包含return_url参数，则支付完成后，支付宝的提示支付成功页面会停留几秒后跳转回return_url参数指定的商户路径页面。

3 数据交互

图3-1 商户系统请求－支付宝响应交互模式

合作商户系统

支付宝系统

构造请求数据

发送请求数据

请求的交易

返回相应数据

对相应的数据进行处理

(1) 构造请求数据

商户根据支付宝提供的接口规则，通过程序生成得到签名结果及要传输给支付宝的数据集合。

(2) 发送请求数据

把构造完成的数据集合，通过页面链接跳转或表单提交的方式传递给支付宝。

(3) 支付宝对请求数据进行处理

支付宝得到这些集合后，会先进行安全校验等验证，一系列验证通过后便会处理这次发送过来的数据请求。

(4) 返回处理的结果数据

对于处理完成的交易，支付宝会以两种方式把数据反馈给商户网站。

 程序上自动进行重新构造URL地址链接，在用户当前页面上通过自动跳转的方式跳回商户在请求时设定好的页面路径地址（参数return_url，如果商户没有设定，则不会进行该操作）；

 支付宝服务器主动发起通知，调用商户在请求时设定好的页面路径（参数notify_url，如果商户没有设定，则不会进行该操作）。

(5) 对获取的返回结果数据进行处理

商户在同步通知处理页面（参数return_url指定页面文件）或服务器异步通知页面（参数notify_url指定页面文件）获取支付宝返回的结果数据后，可以结合自身网站的业务逻辑进行数据处理（如：订单更新、自动充值到会员账号中等）。

4 请求参数说明

4.1 含义

请求参数是商户在与支付宝进行数据交互时，提供给支付宝的请求数据，以便支付宝根据这些数据进一步处理。

4.2 列表

表4-1 请求参数说明

参数参数名称类型（字节长度）参数说明是否可为空样例

基本参数

service 接口名称 String 接口名称。不可空 create_direct_pay_by_user

partner 合作者身份ID String(16) 签约的支付宝账号对应的支付宝唯一用户号。

以2088开头的16位纯数字组成。不可空 2088002396712354

_input_charset 参数编码字符集 String 商户网站使用的编码格式，如utf-8、gbk、gb2312等。不可空 gbk

sign_type 签名方式 String DSA、RSA、MD5三个值可选，必须大写。不可空 MD5

sign 签名 String 请参见“8 签名机制”。不可空 be4an8ya8hbnbzmyi945f5c1ckbp6bbe

notify_url 服务器异步通知页面路径 String(190) 支付宝服务器主动通知商户网站里指定的页面http路径。可空 http://api.test.alipay.net/atinterface/receive_notify.htm

return_url 页面跳转同步通知页面路径 String(200) 支付宝处理完请求后，当前页面自动跳转到商户网站里指定页面的http路径。可空 http://api.test.alipay.net/atinterface/receive_return.htm

error_notify_url 请求出错时的通知页面路径 String(200) 当商户通过该接口发起请求时，如果出现提示报错，支付宝会根据“11.10 item_orders_info出错时的通知错误码”和“11.11 请求出错时的通知错误码”通过异步的方式发送通知给商户。

该功能需要联系支付宝开通。可空 http://api.test.alipay.net/atinterface/receive_return.htm

业务参数

out_trade_no 商户网站唯一订单号 String(64) 支付宝合作商户网站唯一订单号（确保在商户系统中唯一）。不可空 6741334835157966

subject 商品名称 String(256) 商品的标题/交易标题/订单标题/订单关键字等。

该参数最长为128个汉字。不可空贝尔金护腕式

payment_type 支付类型 String(4) 取值范围请参见附录“11.5 收款类型”。

默认值为：1（商品购买）。

注意：

支付类型为“47”时，公共业务扩展参数（extend_param）中必须包含凭证号（evoucheprod_evouche_id）参数名和参数值。不可空 1

defaultbank 默认网银 String 银行简码，请参见“11.6 银行简码——混合渠道”和“11.7 银行简码——纯借记卡渠道”。

说明：

如果要使用纯网关功能，本参数需赋值为“11.6 银行简码——混合渠道”或“11.7 银行简码——纯借记卡渠道”中的值。不可空 CMB

seller_email 卖家支付宝账号 String(100) 卖家支付宝账号。

卖家信息优先级：seller_id>seller_account_name>seller_email。

seller_id，seller_account_name和seller_email不能全部为空，至少有一项不为空。可空 alipay-test01@alipay.com

seller_id 卖家支付宝账户号 String(16) 卖家支付宝账号对应的支付宝唯一用户号。

以2088开头的纯16位数字。可空 2088002007018966

seller_account_name 卖家别名支付宝账号 String(100) 卖家别名支付宝账号。

卖家信息优先级：seller_id>seller_account_name>seller_email。可空 tstable02@alipay.com

price 商品单价 Number 单位为：RMB Yuan。取值范围为[0.01，100000000.00]，精确到小数点后两位。

规则：price、quantity能代替total_fee。即存在total_fee，就不能存在price和quantity；存在price、quantity，就不能存在total_fee。可空 10.00

total_fee 交易金额 Number 该笔订单的资金总额，单位为RMB-Yuan。取值范围为[0.01，100000000.00]，精确到小数点后两位。可空 100

quantity 购买数量 Number price、quantity能代替total_fee。即存在total_fee，就不能存在price和quantity；存在price、quantity，就不能存在total_fee。可空 1

body 商品描述 String(1000) 对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body。可空美国专业护腕鼠标垫，舒缓式凝胶软垫模拟手腕的自然曲线和运动，创造和缓的GelFlex舒适地带！

show_url 商品展示网址 String(400) 收银台页面上，商品展示的超链接。可空 http://www.360buy.com/product/113714.html

paymethod 默认支付方式 String 若要使用纯网关，取值必须是bankPay（网银支付）。

如果不设置，默认为directPay（余额支付）。

说明：

必须注意区分大小写。可空 bankPay

need_ctu_check 网银支付时是否做CTU校验 String 商户在配置了支持CTU（支付宝风险稽查系统）校验权限的前提下，可以选择本次交易是否需要经过CTU校验。

Y：做CTU校验；

N：不做CTU校验。

可空 Y

royalty_type 提成类型 String(2) 目前只支持一种类型：10（卖家给第三方提成）。

当传递了参数royalty_parameters时，提成类型参数不能为空。可空 10

royalty_parameters 分润账号集 String(1000) 参见“4.3 royalty_parameters参数说明”。可空参见“4.3 royalty_parameters参数说明”

anti_phishing_key 防钓鱼时间戳 String 通过时间戳查询接口获取的加密支付宝系统时间戳。

如果已申请开通防钓鱼时间戳验证，则此字段必填。可空 587FE3D2858E6B01E30104656E7805E2

exter_invoke_ip 客户端IP String(15) 用户在创建交易时，该用户当前所使用机器的IP。

如果商户申请后台开通防钓鱼选项，此字段必填，校验用。可空 128.214.222.111

extra_common_param 公用回传参数 String(100) 如果用户请求时传递了该参数，则返回给商户时会回传该参数。可空你好，这是测试商户的广告。

extend_param 公用业务扩展参数 String 用于商户的特定业务信息的传递，只有商户与支付宝约定了传递此参数且约定了参数含义，此参数才有效。

参数格式：参数名1^参数值1|参数名2^参数值2|……

多条数据用“|”间隔。

支付类型（payment_type）为47（电子卡券）时，需要包含凭证号（evoucheprod_evouche_id）参数名和参数值。可空 pnr^MFGXDW|start_ticket_no^123|end_ticket_no^234|b2b_login_name^abc

it_b_pay 超时时间 String 设置未付款交易的超时时间，一旦超时，该笔交易就会自动被关闭。

取值范围：1m～15d。

m-分钟，h-小时，d-天，1c-当天（无论交易何时创建，都在0点关闭）。

该参数数值不接受小数点，如1.5h，可转换为90m。

该功能需要联系支付宝配置关闭时间。可空 1h

product_type 商户申请的产品类型 String(50) 用于针对不同的产品，采取不同的计费策略。

如果开通了航旅垂直搜索平台产品，请填写CHANNEL_FAST_PAY；如果没有，则为空。可空 CHANNEL_FAST_PAY

注意：

 此接口只支持https请求；

 参数body（商品描述）、subject（商品名称）、extra_common_param（公用回传参数）不能包含特殊字符（如：#、%、&、+）、敏感词汇，也不能使用外国文字（旺旺不支持的外文，如：韩文、泰语、藏文、蒙古文、阿拉伯语）；

 请按照“8 签名机制”中的签名方法对输入参数进行签名，该接口请求才能够被支付宝系统接收；

 此接口支持重复调用，前提是交易基本信息（买家、卖家、交易金额、超时时间等）在多次调用中保持一致，且交易尚未完成支付。

4.3 royalty_parameters参数说明

1 参数格式说明

royalty_parameters参数为分润账号集，支持以下格式（用户UID是一串以字母uid开头，后面跟着以2088开头的16位数字的字符串）：

(1) 平级分润

 收款方Email1^金额1^备注1|收款方Email2^金额2^备注2

 付款方Email^收款方Email1^金额1^备注1|付款方Email^收款方Email2^金额2^备注2

 收款方UID1^金额1^备注1|收款方UID2^金额2^备注2

 付款方UID^收款方UID1^金额1^备注1|付款方UID^收款方UID2^金额2^备注2

(2) 多级分润

 收款方Email1^金额1^备注1|付款方Email1^收款方Email2^金额2^备注2|付款方Email2^收款方Email3^金额3^备注3

 收款方UID1^金额1^备注1|付款方UID1^收款方UID2^金额2^备注2|付款方UID2^收款方UID3^金额3^备注3

(3) 平级多级混合分润

 收款方Email1^金额1^备注1|付款方Email1^收款方Email2^金额2^备注2|收款方Email3^金额3^备注3

 收款方UID1^金额1^备注1|付款方UID1^收款方UID2^金额2^备注2|收款方UID3^金额3^备注3

注意：

 参数royalty_parameters（分润账号集）如果有多条数据，用“|”隔开，最多不能超过10条；

 某条分润数据没有付款方，则默认卖家是付款方；

 各分润账号必须使用正确的支付宝账号，能正常收款和付款；

 对于平级分润，付款方Email必须与卖家Email一致；

 同一笔交易的分润处理，必须遵循原则：分润者要先收到钱才能再付给其他被分润者，收到的钱一定要大于等于付出的钱，即先入后出，入要大于等于出；

 在各条分润的“备注”中，不能出现“^”和“|”影响royalty_parameters格式的特殊字符；“备注”字段长度不能超过80个字节，即40个汉字；分润信息中，“备注”项可以不填，但“^”不可以省略，如：收款方支付宝账号1^金额1^。

2. 参数样例

 maomao1@yahoo.cn^1.00^分你的|maomao2@yahoo.cn^2.00^你也有

 uid2088123456789012^1.00^分你的|uid2088123456789013^2.00^你也有

4.4 样例

https://mapi.alipay.com/gateway.do?_input_charset=gbk&defaultbank=CMB&notify_url=http%3A%2F%2Fapi.test.alipay.net%2Fatinterface%2Freceive_notify.htm&out_trade_no=6741334835157966&partner=2088002396712354&payment_type=1&paymethod=bankPay&return_url=http%3A%2F%2Fapi.test.alipay.net%2Fatinterface%2Freceive_return.htm&seller_email=alipay-test01@alipay.com&service=create_direct_pay_by_user&subject=%B1%B4%B6%FB%BD%F0%BB%A4%CD%F3%CA%BD&total_fee=100&sign=cbbe89815204510545cb821416ddf95d&sign_type=MD5

说明：

本样例仅供参考，支付宝网关为https://mapi.alipay.com/gateway.do。

5 页面跳转同步通知参数说明

5.1 含义

支付宝对商户的请求数据处理完成后，会将处理的结果数据通过系统程序控制客户端页面自动跳转的方式通知给商户网站。这些处理结果数据就是页面跳转同步通知参数。

5.2 列表

表5-1 页面跳转同步通知参数说明

参数参数名称类型（字节长度）参数说明是否可为空样例

基本参数

is_success 成功标识 String(1) 表示接口调用是否成功，并不表明业务处理结果。不可空 T

sign_type 签名方式 String DSA、RSA、MD5三个值可选，必须大写。不可空 MD5

sign 签名 String(32) 请参见“8 签名机制”。不可空 b1af584504b8e845ebe40b8e0e733729

业务参数

out_trade_no 商户网站唯一订单号 String(64) 对应商户网站的订单系统中的唯一订单号，非支付宝交易号。

需保证在商户网站中的唯一性。是请求时对应的参数，原样返回。可空 6402757654153618

subject 商品名称 String(256) 商品的标题/交易标题/订单标题/订单关键字等。可空手套

payment_type 支付类型 String(4) 对应请求时的payment_type参数，原样返回。可空 1

exterface 接口名称 String 标志调用哪个接口返回的链接。可空 create_direct_pay_by_user

trade_no 支付宝交易号 String(64) 该交易在支付宝系统中的交易流水号。

最短16位，最长64位。可空 2008102303210710

trade_status 交易状态 String 交易目前所处的状态。

成功状态的值只有两个：

TRADE_FINISHED（普通即时到账的交易成功状态）

TRADE_SUCCESS（开通了高级即时到账或机票分销产品后的支付成功状态）

可空 TRADE_FINISHED

notify_id 通知校验ID String 支付宝通知校验ID，商户可以用这个流水号询问支付宝该条通知的合法性。可空 RqPnCoPT3K9%2Fvwbh3I%2BODmZS9o4qChHwPWbaS7UMBJpUnBJlzg42y9A8gQlzU6m3fOhG

notify_time 通知时间 Date 通知时间（支付宝时间）。

格式为yyyy-MM-dd HH:mm:ss。可空 2008-10-23 13:17:39

notify_type 通知类型 String 返回通知类型。可空 trade_status_sync

seller_email 卖家支付宝账号 String(100) 卖家支付宝账号，可以是Email或手机号码。可空 chao.chenc1@alipay.com

buyer_email 买家支付宝账号 String(100) 买家支付宝账号，可以是Email或手机号码。可空 tstable01@alipay.com

seller_id 卖家支付宝账户号 String(30) 卖家支付宝账号对应的支付宝唯一用户号。

以2088开头的纯16位数字。可空 2088002007018916

buyer_id 买家支付宝账户号 String(30) 买家支付宝账号对应的支付宝唯一用户号。

以2088开头的纯16位数字。可空 2088101000082594

total_fee 交易金额 Number 该笔订单的资金总额，单位为RMB-Yuan。取值范围为[0.01，100000000.00]，精确到小数点后两位。可空 10.00

body 商品描述 String(400) 对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body。可空 Hello

bank_seq_no 网银流水 String(64) 网银流水号。

只有开通了纯网关和伪网关的商户，才返回该参数。可空

招行：9220031730

建行：20100329000000859967

extra_common_param 公用回传参数 String 用于商户回传参数，该值不能包含“=”、“&”等特殊字符。

如果用户请求时传递了该参数，则返回给商户时会回传该参数。可空你好，这是测试商户的广告。

5.3 样例

http://www.xxx.com/alipay/return_url.php?is_success=T&sign=b1af584504b8e845ebe40b8e0e733729&sign_type=MD5&body=Hello&buyer_email=xinjie_xj%40163.com&buyer_id=2088101000082594&exterface=create_direct_pay_by_user&out_trade_no=6402757654153618&payment_type=1&seller_email=chao.chenc1%40alipay.com&seller_id=2088002007018916&subject=%E5%A4%96%E9%83%A8FP&total_fee=10.00&trade_no=2008102303210710&trade_status=TRADE_FINISHED&notify_id=RqPnCoPT3K9%252Fvwbh3I%252BODmZS9o4qChHwPWbaS7UMBJpUnBJlzg42y9A8gQlzU6m3fOhG&notify_time=2008-10-23+13%3A17%3A39&notify_type=trade_status_sync&extra_common_param=%E4%BD%A0%E5%A5%BD%EF%BC%8C%E8%BF%99%E6%98%AF%E6%B5%8B%E8%AF%95%E5%95%86%E6%88%B7%E7%9A%84%E5%B9%BF%E5%91%8A%E3%80%82&bank_seq_no=%E6%8B%9B%E8%A1%8C%E7%9A%84%E8%AE%A2%E5%8D%95%E5%8F%B7%E5%BD%A2%E5%A6%829220031730%3B%0D%0A%E5%BB%BA%E8%A1%8C%E7%9A%84%E5%BD%A2%E5%A6%8220100329000000859967

说明：

本样例仅供参考，实际网关为商户域名。

6 服务器异步通知参数说明

6.1 含义

支付宝对商户的请求数据处理完成后，会将处理的结果数据通过服务器主动通知的方式通知给商户网站。这些处理结果数据就是服务器异步通知参数。

6.2 列表

表6-1 服务器异步通知参数说明

参数参数名称类型（字节长度）参数说明是否可为空样例

基本参数

notify_time 通知时间 Date 通知的发送时间。

格式为yyyy-MM-dd HH:mm:ss。不可空 2009-08-12 11:08:32

notify_type 通知类型 String 通知的类型。不可空 trade_status_sync

notify_id 通知校验ID String 通知校验ID。不可空 70fec0c2730b27528665af4517c27b95

sign_type 签名方式 String DSA、RSA、MD5三个值可选，必须大写。不可空 DSA

sign 签名 String 请参见“8 签名机制”。不可空 _p_w_l_h_j0b_gd_aejia7n_ko4_m%2Fu_w_jd3_nx_s_k_mxus9_hoxg_y_r_lunli_pmma29_t_q%3D%

业务参数

out_trade_no 商户网站唯一订单号 String(64) 对应商户网站的订单系统中的唯一订单号，非支付宝交易号。

需保证在商户网站中的唯一性。是请求时对应的参数，原样返回。可空 3618810634349901

subject 商品名称 String(256) 商品的标题/交易标题/订单标题/订单关键字等。

它在支付宝的交易明细中排在第一列，对于财务对账尤为重要。是请求时对应的参数，原样通知回来。可空 phone手机

payment_type 支付类型 String(4) 取值范围请参见附录“11.5 收款类型”。可空 1

trade_no 支付宝交易号 String(64) 该交易在支付宝系统中的交易流水号。

最短16位，最长64位。可空 2008102203208746

trade_status 交易状态 String 取值范围请参见“11.4 交易状态”。可空 TRADE_FINISHED

gmt_create 交易创建时间 Date 该笔交易创建的时间。

格式为yyyy-MM-dd HH:mm:ss。可空 2008-10-22 20:49:31

gmt_payment 交易付款时间 Date 该笔交易的买家付款时间。

格式为yyyy-MM-dd HH:mm:ss。可空 2008-10-22 20:49:50

gmt_close 交易关闭时间 Date 交易关闭时间。

格式为yyyy-MM-dd HH:mm:ss。可空 2008-10-22 20:49:46

refund_status 退款状态 String 取值范围请参见“11.3 退款状态”。可空 REFUND_SUCCESS

gmt_refund 退款时间 Date 卖家退款的时间，退款通知时会发送。

格式为yyyy-MM-dd HH:mm:ss。可空 2008-10-29 19:38:25

seller_email 卖家支付宝账号 String(100) 卖家支付宝账号，可以是email和手机号码。可空 chao.chenc1@alipay.com

buyer_email 买家支付宝账号 String(100) 买家支付宝账号，可以是email或手机号码。可空 13758698870

seller_id 卖家支付宝账户号 String(30) 卖家支付宝账号对应的支付宝唯一用户号。

以2088开头的纯16位数字。可空 2088002007018916

buyer_id 买家支付宝账户号 String(30) 买家支付宝账号对应的支付宝唯一用户号。

以2088开头的纯16位数字。可空 2088002007013600

price 商品单价 Number 如果请求时使用的是total_fee，那么price等于total_fee；如果请求时使用的是price，那么对应请求时的price参数，原样通知回来。可空 10.00

total_fee 交易金额 Number 该笔订单的总金额。

请求时对应的参数，原样通知回来。可空 10.00

quantity 购买数量 Number 如果请求时使用的是total_fee，那么quantity等于1；如果请求时使用的是quantity，那么对应请求时的quantity参数，原样通知回来。可空 1

body 商品描述 String(400) 该笔订单的备注、描述、明细等。

对应请求时的body参数，原样通知回来。可空 Hello

discount 折扣 Number 支付宝系统会把discount的值加到交易金额上，如果需要折扣，本参数为负数。可空 -5

is_total_fee_adjust 是否调整总价 String(1) 该交易是否调整过价格。可空 N

use_coupon 是否使用红包买家 String(1) 是否在交易过程中使用了红包。可空 N

error_code 错误代码 String 接口调用过程中的出错信息，请参见“11.1 纯网关业务错误码”和“11.2 系统错误码”。可空 ILLEGAL_SIGN

bank_seq_no 网银流水 String(64) 开通了纯网关和伪网关的商户，在交易成功后才可以返回网银流水。可空

招行：9220031730

建行：20100329000000859967

extra_common_param 公用回传参数 String 用于商户回传参数，该值不能包含“=”、“&”等特殊字符。

如果用户请求时传递了该参数，则返回给商户时会回传该参数。可空你好，这是测试商户的广告。

out_channel_type 支付渠道组合信息 String 该笔交易所使用的支付渠道。

格式为：渠道1|渠道2|…，如果有多个渠道，用“|”隔开。

取值范围请参见附录“11.8 渠道类型说明与币种列表”。可空 OPTIMIZED_MOTO|BALANCE

out_channel_amount 支付金额组合信息 String 该笔交易通过使用各支付渠道所支付的金额。

格式为：金额1|金额2|…，如果有多个支付渠道，各渠道所支付金额用“|”隔开。可空 90.00|10.00

out_channel_inst 实际支付渠道 String 该交易支付时实际使用的银行渠道。

格式为：支付渠道1|支付渠道2|…，如果有多个支付渠道，用“|”隔开。

取值范围请参见附录“11.9 实际支付渠道列表”。

该参数需要联系支付宝开通。可空 ICBC

6.3 样例

http://www.xxx.com/alipay/notify_url.php?trade_no=2008102203208746&out_trade_no=3618810634349901&discount=-5&payment_type=1&subject=iphone%E6%89%8B%E6%9C%BA&body=Hello&price=10.00&quantity=1&total_fee=10.00&trade_status=TRADE_FINISHED&refund_status=REFUND_SUCCESS&seller_email=chao.chenc1%40alipay.com&seller_id=2088002007018916&buyer_id=2088002007013600&buyer_email=13758698870&gmt_create=2008-10-22+20%3A49%3A31&is_total_fee_adjust=N&gmt_payment=2008-10-22+20%3A49%3A50&gmt_close=2008-10-22+20%3A49%3A46&gmt_refund=2008-10-29+19%3A38%3A25&use_coupon=N&notify_time=2009-08-12+11%3A08%3A32&notify_type=trade_status_sync&notify_id=70fec0c2730b27528665af4517c27b95&sign_type=DSA&sign=_p_w_l_h_j0b_gd_aejia7n_ko4_m%252Fu_w_jd3_nx_s_k_mxus9_hoxg_y_r_lunli_pmma29_t_q%253D%253D&extra_common_param=%E4%BD%A0%E5%A5%BD%EF%BC%8C%E8%BF%99%E6%98%AF%E6%B5%8B%E8%AF%95%E5%95%86%E6%88%B7%E7%9A%84%E5%B9%BF%E5%91%8A%E3%80%82&bank_seq_no=%E6%8B%9B%E8%A1%8C%E7%9A%84%E8%AE%A2%E5%8D%95%E5%8F%B7%E5%BD%A2%E5%A6%829220031730%3B%0D%0A%E5%BB%BA%E8%A1%8C%E7%9A%84%E5%BD%A2%E5%A6%8220100329000000859967

说明：本样例仅供参考，实际网关为商户域名。

7 通知返回数据处理

7.1 页面跳转同步通知页面特性

(1) 买家在支付成功后会看到一个支付宝提示交易成功的页面，该页面会停留几秒，然后会自动跳转回商户指定的同步通知页面（参数return_url）。

(2) 该页面中获得参数的方式，需要使用GET方式获取，如request.QueryString("out_trade_no")、$_GET['out_trade_no']。

(3) 该方式仅仅在买家付款完成以后进行自动跳转，因此只会进行一次。

(4) 该方式不是支付宝主动去调用商户页面，而是支付宝的程序利用页面自动跳转的函数，使用户的当前页面自动跳转。

(5) 该方式可在本机而不是只能在服务器上进行调试。

(6) 返回URL只有一分钟的有效期，超过一分钟该链接地址会失效，验证则会失败。

(7) 设置页面跳转同步通知页面（return_url）的路径时，不要在页面文件的后面再加上自定义参数。例如：错误的写法：http://www.alipay.com/alipay/return_url.php?xx=11 正确的写法：http://www.alipay.com/alipay/return_url.php

(8) 由于支付宝会对页面跳转同步通知页面（return_url）的域名进行合法有效性校验，因此设置页面跳转同步通知页面（return_url）的路径时，不要设置成本机域名，也不能带有特殊字符（如“!”），如：

错误的写法：

http://localhost/alipay/return_url.php

http://localhost:80/alipay/return_url.php

http://www.xxx.com/alipay/return!url.do

正确的写法：

能够正常访问的域名地址：http://www.xxx.comalipay/return_url.php

能够正常访问的IP地址：http://121.1.1.255/alipay/return_url.php

7.2 服务器异步通知页面特性

(1) 必须保证服务器异步通知页面（notify_url）上无任何字符，如空格、HTML标签、开发系统自带抛出的异常提示信息等。

(2) 支付宝是用POST方式发送通知信息，因此该页面中获取参数的方式，如：request.Form("out_trade_no")、$_POST['out_trade_no']。

(3) 支付宝主动发起通知，该方式才会被启用。

(4) 只有在支付宝的交易管理中存在该笔交易，且发生了交易状态的改变，支付宝才会通过该方式发起服务器通知（即时到账中交易状态为“等待买家付款”的状态默认是不会发送通知的）。

(5) 服务器间的交互，不像页面跳转同步通知，可以在页面上显示出来，这种交互方式是不可见的。

(6) 第一次交易状态改变（即时到账中此时交易状态是交易完成）时，不仅页面跳

转同步通知页面会启用，而且服务器异步通知页面也会收到支付宝发来的处理结果通知。

(7) 程序执行完后必须打印输出“success”（不包含引号）。如果商户反馈给支付宝的字符不是success这7个字符，支付宝服务器会不断重发通知，直到超过24小时22分钟。一般情况下，25小时以内完成8次通知（通知的间隔频率一般是：2m,10m,10m,1h,2h,6h,15h）。

(8) 程序执行完成后，该页面不能执行页面跳转。如果执行页面跳转，支付宝会收不到success字符，会被支付宝服务器判定为该页面程序运行出现异常，而重发处理结果通知。

(9) cookies、session等在此页面会失效，即无法获取这些数据。

(10) 该方式的调试与运行必须在服务器上，即互联网上能访问。

(11) 该方式的作用主要防止订单丢失，即页面跳转同步通知没有处理订单更新，它则去处理。

(12) 当商户收到服务器异步通知并打印出success时，服务器异步通知参数notify_id才会失效。也就是说在支付宝发送同一条异步通知时（包含商户并未成功打印出success导致支付宝重发数次通知），服务器异步通知参数notify_id是不变的。

7.3 通知触发条件

表7-1 通知触发条件

触发条件名触发条件描述触发条件默认值

TRADE_FINISHED 交易成功 true（触发通知）

TRADE_SUCCESS 支付成功 true（触发通知）

WAIT_BUYER_PAY 交易创建 false（不触发通知）

TRADE_CLOSED 交易关闭 false（不触发通知）

说明：

商户可以向支付宝申请配置，是否触发各交易状态下的异步通知。

7.4 商户业务处理注意事项

当支付宝处理完成后，支付宝会把处理结果以当前页面跳转同步通知和支付宝服务器主动通知商户网站两种形式，反馈给商户网站。商户可以从页面跳转同步通知页面或者从服务器异步通知页面中获得这些信息，并且在验证通过的判断中增加商户的业务逻辑处理程序。当商户有传递参数notify_url（服务器异步通知页面路径）或return_url（页面跳转同步通知页面路径）时，商户必须判断商户网站中是否已经对该次的通知结果数据做过同样处理。如果不判断，存在潜在的风险，商户自行承担因此而产生的所有损失。

(1) 交易成功之后，商户（高级即时到账或机票平台商）可调用批量退款接口，系统会发送退款通知给商户，具体内容请参见批量退款接口文档。

(2) 当商户使用站内退款时，系统会发送包含refund_status和gmt_refund字段的通知给商户。

说明：

更多业务处理注意事项请参见《即时到账交易接口(create_direct_pay_by_user)接入与使用规则》文档。

8 签名机制

8.1 生成待签名的字符串

8.1.1 需要参与签名的参数

在请求参数列表中，除去sign、sign_type两个参数外，其他需要使用到的参数皆是要签名的参数。（个别接口中参数sign_type也需要参与签名。）

在通知返回参数列表中，除去sign、sign_type两个参数外，凡是通知返回回来的参数皆是要签名的参数。

8.1.2 生成待签名字符串

对于如下的参数数组：

string[] parameters={

"service=create_direct_pay_by_user",

"partner=2088101568338364",

"_input_charset=gbk",

"return_url= http://www.test.com/alipay/return_url.asp",

"out_trade_no=6741334835157966",

"subject=贝尔金护腕式",

"payment_type=1 ",

"seller_email=alipay-test01@alipay.com",

"total_fee=100"

};

对数组里的每一个值从a到z的顺序排序，若遇到相同首字母，则看第二个字母，以此类推。

排序完成之后，再把所有数组值以“&”字符连接起来，如：

_input_charset=gbk&out_trade_no=6741334835157966&partner=2088101568338364&payment_type=1&return_url=http://www.test.com/alipay/return_url.asp&seller_email=alipay-test01@alipay.com&service=create_direct_pay_by_user&subject=贝尔金护腕式&total_fee=100

这串字符串便是待签名字符串。

注意：

 没有值的参数无需传递，也无需包含到待签名数据中；

 签名时将字符转化成字节流时指定的字符集与_input_charset保持一致；

 如果传递了_input_charset参数，这个参数也应该包含在待签名数据中；

 根据HTTP协议要求，传递参数的值中如果存在特殊字符（如：&、@等），那么该值需要做URL Encoding，这样请求接收方才能接收到正确的参数值。这种情况下，待签名数据应该是原生值而不是encoding之后的值。例如：调用某接口需要对请求参数email进行数字签名，那么待签名数据应该是email=test@msn.com，而不是email=test%40msn.com。

8.2 签名

8.2.1 MD5签名

在MD5签名时，需要私钥参与签名。MD5的私钥是以英文字母和数字组成的32位字符串。商户可登录到商户服务中心（https://b.alipay.com ），安装数字证书，在“技术服务”栏目中点击“交易安全校验码”，即可查看。

 请求时签名

当拿到请求时的待签名字符串后，需要把私钥直接拼接到待签名字符串后面，形成新的字符串，利用MD5的签名函数对这个新的字符串进行签名运算，从而得到32位签名结果字符串（该字符串赋值于参数sign）。

 通知返回时验证签名

当获得到通知返回时的待签名字符串后，同理，需要把私钥直接拼接到待签名字符串后面，形成新的字符串，利用MD5的签名函数对这个新的字符串进行签名运算，从而得到32位签名结果字符串。此时这个新的字符串需要与支付宝通知返回参数中的参数sign的值进行验证是否相等，来判断签名是否验证通过。

8.2.2 DSA、RSA签名

在DSA或RSA的签名时，需要私钥和公钥一起参与签名。私钥与公钥皆是客户通过OPENSSL来生成得出的。客户把生成出的公钥与支付宝技术人员配置好的支付宝公钥做交换。因此，在签名时，客户要用到的是客户的私钥及支付宝的公钥。

 请求时签名

当拿到请求时的待签名字符串后，把待签名字符串与客户的私钥一同放入DSA或RSA的签名函数中进行签名运算，从而得到签名结果字符串。

 通知返回时验证签名

当获得到通知返回时的待签名字符串后，把待签名字符串、支付宝提供的公钥、支付宝通知返回参数中的参数sign的值三者一同放入DSA或RSA的签名函数中进行非对称的签名运算，来判断签名是否验证通过。

9 如何验证是否支付宝请求

 目的

验证此次通知信息是否是支付宝服务器发来的信息，以帮助校验反馈回来的数据的真假性。

 工作原理

获取支付宝返回数据之一的通知校验ID（notify_id），按照支付宝要求的格式拼接成要请求的链接，如：

https://mapi.alipay.com/gateway.do?service=notify_verify&partner=2088002396712354&notify_id=RqPnCoPT3K9%252Fvwbh3I%252BFioE227%252BPfNMl8jwyZqMIiXQWxhOCmQ5MQO%252FWd93rvCB%252BaiGg

通过访问这个请求链接，利用编程方法来模拟http请求与支付宝服务器进行交互，获得支付宝服务器上处理的结果。

如果获得的信息是true，则校验成功；如果获得的信息是其他，则校验失败。

10 建议与意见

如果您在阅读技术文档时有任何建议和意见，请点击下面的链接跟帖回复，我们将根据您的反馈完善文档内容。

http://club.alipay.com/read.php?tid=8684674&fid=703

11 附录

11.1 纯网关业务错误码

表11-1 纯网关业务错误码

错误代码（error_code）含义

SELLER_NOT_IN_SPECIFIED_SELLERS 抱歉，该收款账户不是指定的收款账户，请确认参数是否正确或咨询您的客户经理。

TRADE_SELLER_NOT_MATCH 抱歉，该笔交易的卖家已不存在，请联系正确的卖家重新创建交易进行付款。

TRADE_BUYER_NOT_MATCH 抱歉，您本次支付使用的账户与原先的不一致，请使用原来的账户，或重新创建交易付款。

ILLEGAL_FEE_PARAM 抱歉，金额传递错误，请确认参数是否正确或咨询您的客户经理。

SUBJECT_MUST_NOT_BE_NULL 商品名不能为空。

TRADE_PRICE_NOT_MATCH 抱歉，该商品的交易单价与原先的不一致，请重新创建交易付款。

TRADE_QUANTITY_NOT_MATCH 抱歉，该商品的购买数量与原先的不一致，请重新创建交易付款。

TRADE_TOTALFEE_NOT_MATCH 抱歉，该商品的交易金额与原先的不一致，请重新创建交易付款。

TRADE_NOT_ALLOWED_PAY 抱歉，您不能进行本次支付，请查看该交易是否已超时或已被关闭等。

DIRECT_PAY_WITHOUT_CERT_CLOSE 未开通非证书余额支付，无法完成支付。

FAIL_CREATE_CASHIER_PAY_ORDER 抱歉，系统异常，无法创建本次收银台支付订单，请稍后再试。

ILLEGAL_EXTRA_COMMON_PARAM 抱歉，接口通用回传参数格式不正确，请联系您的商户。

ILLEGAL_PAYMENT_TYPE 抱歉，接口传递的Payment_type参数错误，请联系您的商户。

NOT_SUPPORT_GATEWAY 抱歉，商户网关配置出错，请联系您的商户。

BUYER_SELLER_EQUAL 抱歉，买家和卖家不能是同一个账户。

SELLER_NOT_EXIST 抱歉，卖家账户经验证不存在，请联系您的商户。

ILLEGAL_ARGUMENT 抱歉，商户传递的接口参数错误，请联系您的商户。

TRADE_NOT_FOUND 根据交易号无法找到交易。

TRADE_GOOD_INFO_NOT_FOUND 根据交易号无法找到交易详情。

BUYER_EMAIL_ID_MUST_NULL 抱歉，该笔交易的买家账户必须为空，请联系您的商户。

PRODUCT_NOT_ALLOWED 您未开通此产品，暂时无法使用本服务。

ROYALTY_RECEIVER_NOT_IN_SPECIFIED_ACCOUNTS 抱歉，分润账号不是指定的分润账户，请确保该分润账户已签署分润协议。

ROYALTY_LENGTH_ERROR 抱歉，分润信息过长，不能超过1000个字符，请检查后重新集成。

DEFAULT_BANK_INVALID 您传递的默认网银参数不在规定的范围内。

DIS_NOT_SIGN_PROTOCOL 抱歉，您的分销商没有与支付宝签约，请联系您的商户。

SELF_TIMEOUT_NOT_SUPPORT 抱歉，商户没有开通自定义超时权限，请联系您的商户。

ILLEGAL_OUTTIME_ARGUMENT 抱歉，自定义超时时间设置错误，请联系您的商户。

EBANK_CERDIT_GW_RULE_NOT_OPEN 信用卡未签约（签约到期）或者接口参数未指定开通信用卡支付。

DIRECTIONAL_PAY_FORBIDDEN 付款受限，请确保收款方有权进行收款。

SELLER_ENABLE_STATUS_FORBID 卖家状态不正常。

ROYALTY_SELLER_ENABLE_STATUS_FORBID 抱歉，卖家暂时无法进行收款操作，请联系您的商户。

ROYALTY_SELLER_NOT_CERTIFY 抱歉，卖家尚未通过认证，不能进行收款，请联系您的商户。

ROYALTY_FORAMT_ERROR 抱歉，接口传递的分润参数格式错误，请检查后重新集成。

ROYALTY_TYPE_ERROR 抱歉，接口传递的分润类型错误，请检查后重新集成。

ROYALTY_RECEIVE_EMAIL_NOT_EXIST 抱歉，分润账户经验证不存在，请联系您的商户。

ROYALTY_RECEIVE_EMAIL_NOT_CERTIFY 抱歉，分润账户经验证未通过人行验证，请联系您的商户。

ROYALTY_PAY_EMAIL_NOT_EXIST 抱歉，分润付款账户经验证不存在，请联系您的商户。

TAOBAO_ANTI_PHISHING_CHECK_FAIL 抱歉，无法付款! 该笔交易可能存在风险，如果您确定本次交易没有问题，请1个小时后再付款。

SUBJECT_HAS_FORBIDDENWORD 抱歉，无法付款! 请联系商户修改商品名称，再重新购买。

PAY_CHECK_FAIL 抱歉，付款失败! 该笔交易可能存在风险，建议您付款前<a href=\"http://bbs.taobao.com/catalog/thread/154504-5782260.htm\" target=\"_blank\">先查看防骗案例</a>。

BODY_HAS_FORBIDDENWORD 抱歉，无法付款! 请联系商户修改商品描述，再重新购买。

NEED_CTU_CHECK_PARAMETER_ERROR 抱歉，您传递的商户可信任参数权限参数错误。

NEED_CTU_CHECK_NOT_ALLOWED 抱歉，商户没有可信任参数校验的权限。

BUYER_NOT_EXIST 抱歉，买家账户经验证不存在。

HAS_NO_PRIVILEGE 你的当前访问记录丢失，请返回商户网站重新发起付款。

ILLEGAL_SIGN 签名不正确

ILLEGAL_DYN_MD5_KEY 动态密钥信息错误

ILLEGAL_ENCRYPT 加密不正确

ILLEGAL_ARGUMENT 参数不正确

ILLEGAL_SERVICE 参数不正确

ILLEGAL_PARTNER 合作伙伴ID不正确

ILLEGAL_EXTERFACE 接口配置不正确

ILLEGAL_PARTNER_EXTERFACE 合作伙伴接口信息不正确

ILLEGAL_SECURITY_PROFILE 未找到匹配的密钥配置

ILLEGAL_AGENT 代理ID不正确

ILLEGAL_SIGN_TYPE 签名类型不正确

ILLEGAL_CHARSET 字符集不合法

ILLEGAL_CLIENT_IP 客户端IP地址无权访问服务

ILLEGAL_DIGEST_TYPE 摘要类型不正确

ILLEGAL_DIGEST 文件摘要不正确

ILLEGAL_FILE_FORMAT 文件格式不正确

ILLEGAL_ENCODING 不支持该编码类型

ILLEGAL_REQUEST_REFERER 防钓鱼检查不支持该请求来源

ILLEGAL_ANTI_PHISHING_KEY 防钓鱼检查非法时间戳参数

ANTI_PHISHING_KEY_TIMEOUT 防钓鱼检查时间戳超时

ILLEGAL_EXTER_INVOKE_IP 防钓鱼检查非法调用IP

ILLEGAL_NUMBER_FORMAT 数字格式不合法

ILLEGAL_INTEGER_FORMAT Int类型格式不合法

ILLEGAL_MONEY_FORMAT 金额格式不合法

ILLEGAL_DATA_FORMAT 日期格式错误

REGEXP_MATCH_FAIL 正则表达式匹配失败

ILLEGAL_LENGTH 参数值长度不合法

PARAMTER_IS_NULL 参数值为空

EVOUCHER_ID_NOT_EXIST 抱歉，商户传递的消费券交易公共业务扩展参数中凭证号不存在，请联系您的商家。

NAVIGATION_INCOME_OF_ROYALTY_ACCOUNT 分润账户入不敷出

11.2 系统错误码

注意：

当出现系统错误提示时，请联系支付宝技术支持协助处理。

表11-2 系统错误码

错误代码（error_code）含义

SYSTEM_ERROR 支付宝系统错误

SESSION_TIMEOUT session超时

ILLEGAL_TARGET_SERVICE 错误的target_service

ILLEGAL_ACCESS_SWITCH_SYSTEM partner不允许访问该类型的系统

ILLEGAL_SWITCH_SYSTEM 切换系统异常

EXTERFACE_IS_CLOSED 接口已关闭

11.3 退款状态

表11-3 退款状态

枚举名称枚举说明

REFUND_SUCCESS 退款成功：

 全额退款情况：trade_status= TRADE_CLOSED，而refund_status=REFUND_SUCCESS

 非全额退款情况：trade_status= TRADE_SUCCESS，而refund_status=REFUND_SUCCESS

REFUND_CLOSED 退款关闭

11.4 交易状态

表11-4 交易状态

枚举名称枚举说明

WAIT_BUYER_PAY 交易创建，等待买家付款。

TRADE_CLOSED  在指定时间段内未支付时关闭的交易；

 在交易完成全额退款成功时关闭的交易。

TRADE_SUCCESS 交易成功，此时可退款。

TRADE_PENDING 等待卖家收款（买家付款后，如果卖家账号被冻结）。

TRADE_FINISHED  当交易超过退款期限后，该笔交易成功且结束，此时不可退款；

 交易成功且不可退款。

11.5 收款类型

表11-5 收款类型

枚举名称枚举说明

1 商品购买

4 捐赠

47 电子卡券

11.6 银行简码——混合渠道

表11-6 银行简码——混合渠道

银行简码银行名称

ICBCBTB 中国工商银行（B2B）

ABCBTB 中国农业银行（B2B）

CCBBTB 中国建设银行（B2B）

SPDBB2B 上海浦东发展银行（B2B）

BOCBTB 中国银行（B2B）

CMBBTB 招商银行（B2B）

BOCB2C 中国银行

ICBCB2C 中国工商银行

CMB 招商银行

CCB 中国建设银行

ABC 中国农业银行

SPDB 上海浦东发展银行

CIB 兴业银行

GDB 广发银行

CMBC 中国民生银行

CITIC 中信银行

HZCBB2C 杭州银行

CEBBANK 中国光大银行

SHBANK 上海银行

NBBANK 宁波银行

SPABANK 平安银行

BJRCB 北京农村商业银行

FDB 富滇银行

POSTGC 中国邮政储蓄银行

abc1003 visa

abc1004 master

备注：

1. B2B代表企业银行。

2. 其他银行陆续增加中。

注意：

由于深圳发展银行与平安银行合并，原深圳发展银行卡视为平安银行卡，银行简码统一为SPABANK，传入SDB（深圳发展银行）将无法支付。

11.7 银行简码——纯借记卡渠道

表11-7 银行简码——纯借记卡渠道

银行简码银行名称

CMB-DEBIT 招商银行

CCB-DEBIT 中国建设银行

ICBC-DEBIT 中国工商银行

COMM-DEBIT 交通银行

GDB-DEBIT 广发银行

BOC-DEBIT 中国银行

CEB-DEBIT 中国光大银行

SPDB-DEBIT 上海浦东发展银行

PSBC-DEBIT 中国邮政储蓄银行

BJBANK 北京银行

SHRCB 上海农商银行

WZCBB2C-DEBIT 温州银行

COMM 交通银行

备注：其他银行陆续增加中。

说明：

交通银行简码COMM、COMM-DEBIT都代表纯借记卡渠道，二者没有区别，建议使用COMM-DEBIT。

11.8 渠道类型说明与币种列表

表11-8 渠道类型说明与币种列表

渠道类型描述卡种

BALANCE 余额无

CREDIT_PAY 信用支付支付方式类型无

CASH 现金支付方式类型无

CONSUMER_CARD 消费卡支付方式类型无

COUPON 红包支付方式类型无

VOUCHER 购物券支付方式类型无

POINT 积分支付方式类型无

WANG_HUI_E 网汇E支付方式类型无

PREPAID_CARD 预存卡支付方式类型无

INTERNATIONAL_CREDIT_CARD 国际卡类型无

PREPAY 预付卡支付方式类型无

RT_DISCOUNT 实时优惠支付方式类型无

CARTOON 借记卡卡通支付方式类型借记卡

SC_DEBIT_CARTOON 结算中心借记卡卡通支付方式类型借记卡

B2C_EBANK 借记卡B2C网银支付方式类型借记卡

B2B_EBANK B2B网银支付方式类型借记卡

WANGDIAN_DEBIT_CARD 网点借记卡刷卡支付方式类型借记卡

DEBIT_EXPRESS 借记卡快捷支付方式类型借记卡

CREDIT_CARTOON 普通信用卡卡通支付方式类型信用卡

BIGAMOUNT_CREDIT_CARTOON 大额信用卡卡通支付方式类型信用卡

VISA VISA网银支付方式类型信用卡

CREDIT_CARD_EBANK 信用卡网关支付方式类型信用卡

MOTO_CREDIT_CARD moto信用卡支付方式类型信用卡

OPTIMIZED_MOTO 信用卡快捷支付类型信用卡

CREDIT_EXPRESS_INSTALLMENT 信用卡快捷分期支付类型信用卡

WANGDIAN_CREDIT_CARD 网点信用卡刷卡支付方式类型信用卡

INTERNATIONAL_CREDIT_CARD_VISA VISA支付方式类型信用卡

INTERNATIONAL_CREDIT_CARD_MASTER MASTER支付方式类型信用卡

INTERNATIONAL_CREDIT_CARD_JCB JCB支付方式类型信用卡

MIXED_B2C_EBANK 混合卡B2C网银支付方式类型混合卡

11.9 实际支付渠道列表

表11-9 实际支付渠道列表

INST_ID INST_NAME

ICBC 中国工商银行

ABC 中国农业银行

CCB 中国建设银行

SPDB 上海浦东发展银行

BOC 中国银行

CMB 招商银行

CIB 兴业银行

GDB 广发银行

CMBC 中国民生银行

CITIC 中信银行

HZCB 杭州银行

CEB 中国光大银行

SHBANK 上海银行

NBBANK 宁波银行

SPABANK 平安银行

BJRCB 北京农村商业银行

FDB 富滇银行

PSBC 中国邮政储蓄银行

COMM 交通银行

BJBANK 北京银行

SHRCB 上海农商银行

WZCB 温州市商业银行

11.10 item_orders_info出错时的通知错误码

表11-10 item_orders_info出错时的通知错误码

错误代码（error_code）含义

ERR_ITEM_ORDERS_INFO_IS_NULL 商户回传业务信息为空。

ERR_ITEM_ORDERS_INFO_IS_TOO_LONG 商户回传业务信息太长。

ERR_ITEM_ORDERS_INFO_SPLIT 商户回传业务信息校验失败,解析整个业务信息异常。

ERR_ITEM_ORDERS_INFO_SPLIT_IS_NULL 商户回传业务信息解析后为空。

ERR_ITEM_ORDERS_INFO_SPLIT_PARAM_NUM_IS_NOT_LIMIT 商户回传业务信息解析后参数个数与接口定义个数不符。

ERR_ITEM_ORDERS_INFO_SPLIT_PARAM_NAME 商户回传业务信息解析后参数名称错误。

ERR_ITEM_ORDERS_INFO_SPLIT_PARAM_NAME_OR_SET_DATA 商户回传业务信息解析错误或赋值错误。

ERR_ITEM_ORDERS_INFO_CHECK_SYSTEM_ERROR 商户回传业务信息校验异常。

ERROR_GOODS_OUT_IIDS_IS_NULL 商品站外ID不能为空。

ERROR_GOODS_OUT_IIDS_IS_NOT_LIMIT 商品列表总数不能超过30。

ERROR_GOODS_OUT_IIDS_PART_IS_NULL 商品站外ID部分为空。

ERROR_GOODS_OUT_IIDS_PART_IS_TOO_LONG 商品站外ID太长。

ERROR_GOODS_NUMS_IS_NULL 商品数量不能为空。

ERROR_GOODS_NUMS_IS_NOT_LIMIT 商品数量列表总数不能超过30。

ERROR_GOODS_NUMS_PART_IS_NULL 商品数量部分为空。

ERROR_GOODS_NUMS_PART_IS_POSITIVE_INTEGER 商品数量非正整数。

ERROR_GOODS_NUMS_PART_IS_TOO_LONG 商品数量太大或格式非法。

ERROR_GOODS_PRICES_IS_NULL 商品价格不能为空。

ERROR_GOODS_PRICES_IS_NOT_LIMIT 商品价格列表总数不能超过30。

ERROR_GOODS_PRICES_PART_IS_NULL 商品价格部分为空。

ERROR_GOODS_PRICES_IS_NOT_NUMBERS 商品价格不正确。

ERROR_GOODS_PRICES_IS_TOO_LONG 商品价格太大或格式非法。

ERROR_GOODS_SKUS_IS_NULL 商品详细信息不能为空。

ERROR_GOODS_SKUS_IS_NOT_LIMIT 商品详细信息列表总数不能超过30。

ERROR_GOODS_SKUS_PART_IS_NULL 商品详细信息部分为空。

ERROR_GOODS_SKUS_PART_IS_TOO_LONG 商品详细信息太长。

ERROR_GOODS_TITLES_IS_NULL 商品标题不能为空。

ERROR_GOODS_TITLES_IS_NOT_LIMIT 商品标题列表总数不能超过30。

ERROR_GOODS_TITLES_PART_IS_NULL 商品标题部分为空。

ERROR_GOODS_TITLES_PART_IS_TOO_LONG 商品标题太长。

ERROR_GOODS_DETAIL_URLS_IS_NULL 商品页面展示地址不能为空。

ERROR_GOODS_DETAIL_URLS_IS_NOT_LIMIT 商品页面展示地址列表总数不能超过30。

ERROR_GOODS_DETAIL_URLS_PART_IS_NULL 商品页面展示地址部分为空。

ERROR_GOODS_DETAIL_URLS_PATTERN_IS_WRONG 商品页面展示地址格式不正确。

ERROR_GOODS_DETAIL_URLS_PATTERN_IS_TOO_LONG 商品页面展示地址太长。

ERROR_GOODS_PIC_URLS_IS_NULL 商品图片地址不能为空。

ERROR_GOODS_PIC_URLS_IS_NOT_LIMIT 商品图片地址列表总数超过30。

ERROR_GOODS_PIC_URLS_PART_IS_NULL 商品图片地址部分为空。

ERROR_GOODS_PIC_URLS_PATTERN_IS_WRONG 商品图片地址格式错误。

ERROR_GOODS_PIC_URLS_PATTERN_IS_TOO_LONG 商品图片地址太长。

ERROR_GOODS_LIST_IS_NOT_LIMIT 商品明细数量不匹配。

ERROR_ORDER_LOGISTICS_TYPE_IS_NOT_LIMIT 运输方式不正确。

ERROR_ORDER_POST_FEE_IS_NULL 物流费用不能为空。

ERROR_ORDER_POST_FEE_IS_NOT_NUMBERS 物流费用不正确。

ERROR_ORDER_POST_FEE_IS_TOO_LONG 物流费用太大或格式非法。

ERROR_ORDER_PROMOTION_DESC_IS_NOT_LIMIT 优惠信息太长。

ERROR_ORDER_RECEIVER_NAME_IS_NULL 收货人姓名不能为空。

ERROR_ORDER_RECEIVER_NAME_IS_TOO_LONG 收货人姓名太长。

ERROR_ORDER_RECEIVER_ADDRESS_PROV_IS_NULL 收货地址省份不能为空。

ERROR_ORDER_RECEIVER_ADDRESS_PROV_IS_NOT_LIMIT 收货地址省份长度不正确。

ERROR_ORDER_RECEIVER_ADDRESS_CITY_IS_NULL 收货地址省会或地级市不能为空。

ERROR_ORDER_RECEIVER_ADDRESS_CITY_IS_NOT_LIMIT 收货地址省会或地级市长度不正确。

ERROR_ORDER_RECEIVER_ADDRESS_AREA_IS_NULL 收货地址区县不能为空。

ERROR_ORDER_RECEIVER_ADDRESS_AREA_IS_NOT_LIMIT 收货地址区县长度不正确。

ERROR_ORDER_RECEIVER_ADDRESS_IS_NULL 收货地址不能为空。

ERROR_ORDER_RECEIVER_ADDRESS_IS_NOT_LIMIT 收货地址长度不正确。

ERROR_ORDER_RECEIVER_ADDRESS_IS_ALL_NUMERIC 收货地址不能全为数字。

ERROR_ORDER_RECEIVER_ADDRESS_IS_ALL_CHARACTAR 收货地址不能全为字母。

ERROR_ORDER_RECEIVER_ADDRESS_IS_TOO_LONG 收货地址（省市区街道）太长。

ERROR_ORDER_RECEIVER_MOBILE_AND_RECEIVER_PHONE_ALL_IS_NULL 收货人手机号和联系电话不能同时为空。

ERROR_ORDER_RECEIVER_MOBILE_IS_NOT_LIMIT 收货人手机号格式错误。

ERROR_ORDER_RECEIVER_PHONE_IS_NOT_LIMIT 收货人联系电话格式错误。

SYSTEM_ERROR 商户回传业务信息校验系统异常。

11.11 请求出错时的通知错误码

表11-11 请求出错时的通知错误码

错误代码（error_code）含义

SELLER_NOT_IN_SPECIFIED_SELLERS 传入的收款账户不是指定的收款账户

TRADE_SELLER_NOT_MATCH 卖家账户与交易中不一致

ILLEGAL_FEE_PARAM 金额传递混乱

SUBJECT_MUST_NOT_BE_NULL 商品名不能为空

TRADE_PRICE_NOT_MATCH 单价与交易中不一致

TRADE_QUANTITY_NOT_MATCH 购买数量与交易中不一致

TRADE_TOTALFEE_NOT_MATCH 交易金额与交易中不一致

ILLEGAL_EXTRA_COMMON_PARAM 非法的接口通用回传参数

ILLEGAL_PAYMENT_TYPE 错误的Payment_type参数

NOT_SUPPORT_GATEWAY 错误的supportGateway参数

SELLER_NOT_EXIST 卖家不存在

ILLEGAL_ARGUMENT 参数不正确

BUYER_EMAIL_ID_MUST_NULL 买家email必须为空

PRODUCT_NOT_ALLOWED 产品不允许访问

ROYALTY_RECEIVER_NOT_IN_SPECIFIED_ACCOUNTS 提成账号不在预先设置的账号中

ROYALTY_LENGTH_ERROR 提成信息说明长度不能超过1000个字符，请检查后重新集成

ILLEGAL_EXTER_INVOKE_IP 防钓鱼检查非法调用IP

DEFAULT_BANK_INVALID 网银参数不合法

DIS_NOT_SIGN_PROTOCOL 分销商没有签约

SELF_TIMEOUT_NOT_SUPPORT 不支持超时

ILLEGAL_OUTTIME_ARGUMENT 超时时间设置错误

EBANK_CERDIT_GW_RULE_NOT_OPEN 信用卡未签约（签约到期）或者接口参数未指定开通信用卡支付

DIRECTIONAL_PAY_FORBIDDEN 付款受限，请确保收款方有权进行收款

SELLER_ENABLE_STATUS_FORBID 卖家状态不正常

ROYALTY_SELLER_ENABLE_STATUS_FORBID 分润方状态不正常

ROYALTY_SELLER_NOT_CERTIFY 有提成情况下，卖家未通过认证

ROYALTY_FORAMT_ERROR 提成信息错误，请检查后重新集成

ROYALTY_TYPE_ERROR 提成类型不支持，请检查后重新集成

ROYALTY_RECEIVE_EMAIL_NOT_EXIST 提成收款帐户不存在

ROYALTY_PAY_EMAIL_NOT_EXIST 提成付款帐户不存在

SUBJECT_HAS_FORBIDDENWORD 商品名称包含违禁词

BODY_HAS_FORBIDDENWORD 商品描述包含违禁词

MOTO_EXPRESS_TOTAL_AMOUNT_EXCEED 交易金额超过快捷支付前置限额

MOTO_EXPRESS_PARTNER_NOT_SIGN_PROTOCOL 商户未开通快捷支付

EBANK_VISA_GW_RULE_NOT_OPEN 商户未签约外卡收单产品（或者签约到期）或者本次交易金额小于1元

ROYALTY_RECEIVE_EMAIL_NOT_CERTIFY 提成收款帐户不存在

NEED_CTU_CHECK_PARAMETER_ERROR 商户可信任参数权限参数校验失败

NEED_CTU_CHECK_NOT_ALLOWED 商户没有可信任参数校验的权限

UNKNOWN_PRODUCT_NAME 系统异常，无法获取产品线信息，请稍后再试

TOKEN_LEN_TOO_LONG TOKEN长度超过限制，最多40位

Unitrans世联翻译公司在您身边,离您近的翻译公司,心贴心的专业服务,专业的全球语言翻译与信息解决方案供应商,专业翻译机构品牌。无论在本地,国内还是海外,我们的专业、星级体贴服务，为您的事业加速！世联翻译公司在北京、上海、深圳等国际交往城市设有翻译基地，业务覆盖全国城市。每天有近百万字节的信息和贸易通过世联走向全球！积累了大量政商用户数据，翻译人才库数据，多语种语料库大数据。世联品牌和服务品质已得到政务防务和国际组织、跨国公司和大中型企业等近万用户的认可。专业翻译公司,北京翻译公司,上海翻译公司,英文翻译,日文翻译,韩语翻译,翻译公司排行榜,翻译公司收费价格表,翻译公司收费标准,翻译公司北京,翻译公司上海。

上一篇：世联翻译公司完成网站网页英文翻译
下一篇：世联翻译公司完成电子系统-交易口中文翻译

收藏打印