AliPay支付宝标准快速付款接口文档(专用纯网关)V151

1、. 纯网关Alipay：.；Alipay纯网关接口文档 副标题：网银直连修订历史版本号作者修订章节修订缘由修订日期V1.0技术支持团队全版修正加强文档构造的合理性2021-11-17V1.1甘宁订正部分接口参数和描画信息，例如：即时支付支持错误通知地址error_notify_url更新签约接口内容接口晋级、添加查询签约接口2021-8-2V1.2甘宁重新整理流程以及文档阐明使文档阅读性更强2021-12-8V1.3甘宁添加“公用回传参数满足用户自定义参数的要求2021-3-18V1.4甘宁通知中添加网银流水满足商户网银支付需求2021-3-29V1.5甘宁恳求参数列表支持自定义超时可以运用时

2、间区间2021-9-13V1.5.1甘宁添加4.3.2的信誉卡简码信誉卡大额支付也支持纯网关2021-10-26阐明：本接口将支付宝即时到帐接口用作纯网关的功能做详细引见。在集成时处置机制和原有支付宝即时到帐一样，恳求时必需添加默许支付方式paymethod和默许网银defaultbank2个参数目录 TOC o 1-3 h z u HYPERLINK l _Toc275866863 1前言 PAGEREF _Toc275866863 h 3 HYPERLINK l _Toc275866864 1.1概述 PAGEREF _Toc275866864 h 3 HYPERLINK l _Toc27

3、5866865 1.2术语 PAGEREF _Toc275866865 h 3 HYPERLINK l _Toc275866866 2接口功能及参数引见 PAGEREF _Toc275866866 h 3 HYPERLINK l _Toc275866867 2.1规范即时到账接口适用于纯网银 PAGEREF _Toc275866867 h 3 HYPERLINK l _Toc275866868 2.1.1功能描画 PAGEREF _Toc275866868 h 3 HYPERLINK l _Toc275866869 2.1.2交互流程 PAGEREF _Toc275866869 h 4 HYP

4、ERLINK l _Toc275866870 2.1.3交互方式 PAGEREF _Toc275866870 h 4 HYPERLINK l _Toc275866871 2.1.4接口详细阐明 PAGEREF _Toc275866871 h 4 HYPERLINK l _Toc275866872 2.1.5接口本卷须知 PAGEREF _Toc275866872 h 11 HYPERLINK l _Toc275866873 2.1.6接口错误代码列表 PAGEREF _Toc275866873 h 11 HYPERLINK l _Toc275866874 3签名通用战略 PAGEREF _To

5、c275866874 h 13 HYPERLINK l _Toc275866875 3.1平安方面CheckList PAGEREF _Toc275866875 h 13 HYPERLINK l _Toc275866876 3.2签名方面 PAGEREF _Toc275866876 h 13 HYPERLINK l _Toc275866877 3.2.1签名机制 PAGEREF _Toc275866877 h 13 HYPERLINK l _Toc275866878 .2签名方式 PAGEREF _Toc275866878 h 13 HYPERLINK l _Toc275866

6、879 3.3其他方面 PAGEREF _Toc275866879 h 14 HYPERLINK l _Toc275866880 4附录 PAGEREF _Toc275866880 h 14 HYPERLINK l _Toc275866881 4.1接口通用机制 PAGEREF _Toc275866881 h 14 HYPERLINK l _Toc275866882 4.1.1系统调用 PAGEREF _Toc275866882 h 14 HYPERLINK l _Toc275866883 4.1.2页面跳转 PAGEREF _Toc275866883 h 14 HYPERLINK l _To

7、c275866884 4.1.3支付宝自动通知处置流程 PAGEREF _Toc275866884 h 16 HYPERLINK l _Toc275866885 4.1.4通知验证 PAGEREF _Toc275866885 h 17 HYPERLINK l _Toc275866886 4.2数字签名构造 PAGEREF _Toc275866886 h 18 HYPERLINK l _Toc275866887 4.2.1恳求参数构造 PAGEREF _Toc275866887 h 18 HYPERLINK l _Toc275866888 4.3公用枚举表 PAGEREF _Toc2758668

8、88 h 21 HYPERLINK l _Toc275866889 4.3.1通知前往结果枚举 PAGEREF _Toc275866889 h 21 HYPERLINK l _Toc275866890 4.3.2通用买卖形状枚举表 PAGEREF _Toc275866890 h 21 HYPERLINK l _Toc275866891 4.3.1银行列表 PAGEREF _Toc275866891 h 22 HYPERLINK l _Toc275866892 4.3.2信誉卡大额银行列表 PAGEREF _Toc275866892 h 23 HYPERLINK l _Toc275866893

9、4.3.3订单形状列表 PAGEREF _Toc275866893 h 23 HYPERLINK l _Toc275866894 4.4FAQ常见问题的的解答 PAGEREF _Toc275866894 h 24前言概述本接口主要用在外部集成网银直连(纯网关)功能术语称号阐明外部商户、协作同伴、商户和支付宝进展业务协作的商户通知页参数称号Notify_url，所指定的互联网HTTP地址，当代扣完成之后，支付宝发送信息到该页面去，即调用该页面，该页面中的程序自动运转，并判别恳求与处置获取到的信息协作同伴ID签约后，为商家自动分配的独一编号。分润分润指将某一部分费用分给其它的帐户页面跳转执行操作后

10、跳转到其它页面接口功能及参数引见规范即时到账接口适用于纯网银功能描画调用此接口，根据用户传过来的参数创建买卖，买家再付款。目前该接口的买卖全部为即时到帐纯网银支付接口，即只需买家一付款，钱就会从买家银行卡转到卖家的支付宝账号。同时该接口还支持分润，商家传过来分润的账号和金额，系统会自动打款到该账号上。交互流程交互方式恳求/呼应交互方式，页面跳转接口详细阐明恳求参数列表特别留意：此接口只支持https恳求，支付宝是以https进展验证按照支付宝外部恳求接口概述中要求的签名方式，对输入参数进展签名，该接口恳求才可以被支付宝系统接纳。本接口支持反复调用，但是提交数据必需一样才可以。在恳求时必需添加默

11、许支付方式和默许网银2个参数字段名变量名类型阐明可空协议参数接口称号serviceStringcreate_direct_pay_by_userN协作同伴IDpartnerString(16)协作同伴在支付宝的用户ID与支付宝签约后自动生成N通知URLnotify_urlURLString(190)针对该买卖的买卖形状同步通知接纳URL。N前往URLreturn_urlURL结果前往URL，仅适用于立刻前往处置结果的接口。支付宝处置完恳求后，立刻将处置结果前往给这个URL。N错误通知地址需求支付宝功能人员开通error_notify_urlURLString(190)假设在买卖过程中出错如签名

12、错误等，那么经过此URL将错误码前往给协作同伴系统Y签名signString见HYPERLINK l 签名机制签名机制，MD5加密算法后得出的结果N签名方式sign_typeString见HYPERLINK l 签名方式签名方式，现今默许是MD5加密，无需更改该参数的值N参数编码字符集_input_charsetString默以为GBK协作同伴系统与支付宝系统之间交互信息时运用的编码字符集。协作同伴可以经过该参数指定运用何种字符集对传送参数进展编码。同时，支付宝系统也会运用该字符集对前往参数或通知参数进展编码。注：该参数必需在queryString中传送，不论运用的是POST还是GET方式发送

13、恳求。如：alipay/cooperate/gateway.do?_input_charset=utf-8N业务参数商品展现网址show_urlString(400)点击商品链接后跳转的页面Y商品称号subjectString(256)商品的标题N商品描画bodyString(1000)商品的详细描画，假设是多种商品，请将商品描画字符串累加传给bodyY外部买卖号out_trade_noString(64)协作同伴买卖号确保在协作同伴系统中独一N商品单价priceNumber(13,2)price:单位为RMB Yuan 0.01100000000.00total_fee:单位为RMB Yua

14、n0.01100000000.00quantity:0quantity 0Y买卖金额total_feeNumber(13,2)单位为RMB Yuan0.011000000.00Y能否调整总价is_total_fee_adjustString(1)该买卖能否调整过价钱Y买卖创建时间gmt_createTimestamp该笔买卖创建的时间Y买卖付款时间gmt_paymentTimestamp该买卖买家的付款时间Y买卖封锁时间gmt_closeTimestamp买卖封锁时间Y退款时间gmt_refundTimestamp卖家退款的时间，退款通知时会发送Y公用回传参数extra_common_para

15、mString用于商户回传参数,该值不能包含=&等特殊字符。假设用户恳求时传送了该参数，那么前往给商户时会回传该参数.Y网银流水号bank_seq_noString(20)开通了纯网关和伪网关的商户，在买卖胜利后可以前往网银流水。备注：需求支付宝技术支持人员开启Y买卖形状信息：买卖形状trade_statusString见HYPERLINK l _买卖形状枚举表_1买卖形状枚举表Y退款形状refund_statusString见HYPERLINK l _买卖形状枚举表_1买卖形状枚举表Y买家卖家信息：卖家Emailseller_emailString(100)卖家EmailY卖家IDselle

16、r_idString(30)卖家IDY买家IDbuyer_idString(30)买家EmailY买家Emailbuyer_emailString(100)买家IDY能否运用红包use_couponString(1)买家能否在买卖过程中运用了红包Y错误通知参数信息需求在传入参数添加错误通知地址：错误代码error_codeString(阐明接口调用过程中的出错信息N接口本卷须知您需运用HTTPS 协义, 支付宝是以HTTPS的方式进展通知请按照支付宝外部恳求接口概述中要求的签名方式，对输入参数进展签名，该接口恳求才可以被支付宝系统接纳该接口支持反复调用，即：一笔订单可以重新支付，但是前提是这笔

17、订单的信息和原来信息一样，否那么会报订单号反复处置支付宝的前往信息可以异步处置也可以同步处置，前提是防止订单反复接纳提成数据集：1. 收款方Email_1金额备注|付款方Email收款方Email_2金额备注例如：gwl2511630.02分润1|gwl251126gwl0611630.01分润22. 收款方Email_1金额备注|收款方Email_2金额备注例如：gwl2511630.02分润1|gwl0611630.01分润23.收款方Email_1金额备注|收款方Email_1收款方Email_2金额备注例如：gwl2511630.02分润1|gwl251163gwl0611630.01

18、分润2接口错误代码列表错误代码error_code阐明ILLEGAL_SIGN签名验证出错ILLEGAL_ARGUMENT参数不正确HAS_NO_PRIVILEGE没有权限访问该效力ILLEGAL_SERVICEService参数不正确ILLEGAL_PARTNER商户ID不正确HAS_NO_PUBLICKEY没有上传公钥USER_NOT_EXIST会员不存在OUT_TRADE_NO_EXIST外部买卖号曾经存在TRADE_NOT_EXIST买卖不存在ILLEGAL_PAYMENT_TYPE无效支付类型，需求联络支付宝技术支持工程师处置BUYER_NOT_EXIST买家不存在SELLER_NO

19、T_EXIST卖家不存在BUYER_SELLER_EQUAL买家、卖家是同一帐户ILLEGAL_SIGN_TYPE签名类型不正确COMMISION_ID_NOT_EXIST佣金收取帐户不存在COMMISION_SELLER_DUPLICATE收取佣金帐户和卖家是同一帐户COMMISION_FEE_OUT_OF_RANGE佣金金额超出范围ILLEGAL_LOGISTICS_FORMAT无效物流格式TOTAL_FEE_LESSEQUAL_ZERO买卖总金额小于等于0TOTAL_FEE_OUT_OF_RANGE买卖总金额超出范围ILLEGAL_FEE_PARAM非法买卖金额格式参考单价、总价、数量三

20、个组合规那么DONATE_GREATER_THAN_MAX小额捐赠总金额超出最大值限制DIRECT_PAY_AMOUNT_OUT_OF_RANGE快速付款买卖总金额超出最大值限制DIGITAL_FEE_GREATER_THAN_MAX虚拟物品买卖总金额超出最大值限制SELF_TIMEOUT_NOT_SUPPORT不支持自定义超时COMMISION_NOT_SUPPORT不支持佣金VIRTUAL_NOT_SUPPORT不支持虚拟发货方式ILLEGAL_CHARSET字符集不合法ROYALTY_SELLER_ENABLE_STATUS_FORBID有提成情况下，卖家形状不正常ROYALTY_SEL

21、LER_NOT_CERTIFY有提成情况下，卖家未经过认证ROYALTY_FORAMT_ERROR提成信息错误，请检查后重新集成ROYALTY_TYPE_ERROR提成类型不支持，请检查后重新集成ROYALTY_PAY_EMAIL_NOT_EXIST提成付款帐户不存在ROYALTY_RECEIVE_EMAIL_NOT_EXIST提成收款帐户不存在DEFAULT_BANK_MUST_NOT_NULL默许网银不能为空LLEGAL_PAYMENT_TYPE错误的Payment_type参数ILLEGAL_OUTTIME_ARGUMENT自定义超时参数错误CANT_CREDIT_PAY不能运用信誉支付

22、TRADE_NOT_ALLOWED_PAY买卖不允许付款NAVIGATION_INCOME_OF_ROYALTY_ACCOUNT在提成情况下的多级分润，二次分润帐户次序问题或者分润时没有预留支付宝效力费签名通用战略平安方面CheckList从集成后的系统强壮性思索，收到支付宝发出的通知后，协作同伴系统须判别接纳到的买卖形状、买卖金额能否与本人系统中的参数对应，并处置这些数据信息，使网站内的买卖信息与支付宝内的买卖信息坚持一致，可防止掉单情况出现。假设不判别，存在潜在的风险，协作同伴自行承当因此而产生的一切损失。签名方面签名机制没有值的参数无需传送，也无需包含到待签名数据中。签名时将字符转变成字

23、节流时指定的字符集要与_input_charset坚持一致。假设传送了_input_charset参数，那么这个参数也应该包含在待签名数据中。根据HTTP协议要求，传送参数的值中假设存在特殊字符如：&、等，那么该值需求做URL Encoding，这样恳求接受方才干接遭到正确的参数值。这种情况下，做签名时运用的应该是原生值而不是encoding之后的值。例如：会员查询接口例如中待签名数据是email=testmsn&partner=2088006300000000&service=test，而不是email=test%40msn&partner=2088006300000000&service=

24、test。4.2.2签名方式按照sign_type参数指定的签名算法对待签名数据进展签名【参见：HYPERLINK l _数字签名构造数字签名构造】其他方面您必需运用HTTPS 协义, 支付宝是以HTTPS的方式进展通知请按照支付宝外部恳求接口概述中要求的签名方式，对输入参数进展签名，该接口恳求才可以被支付宝系统接纳假设设置了notify_url，支付宝会发一条通知到notify_url对应的站点通知URL不要如此设置：xxx/alipay/notify_url.asp?id=xxx，即不要带自加的自定义参数，这会导致通知前往时判别失败。附录接口通用机制系统调用顾名思义，这类接口是为协作同伴系

25、统获得支付宝系统信息提供效力的，是一种系统间的调用接口。 系统调用表示图页面跳转顾名思义，这类接口都是一些有页面操作的接口。通常是用户在协作同伴页面执行部分操作，然后跳转到支付宝系统记录订单信息及时再转入网银系统页面完成整个操作。有的甚至能够最后还要再跳回到协作同伴的下一个页面，继续完成整个操作。根据处置结果的前往方式，又分为：立刻前往处置结果，即用户在网银系统页面完成操作后，支付宝将处置结果立刻前往给协作同伴的下一步操作页面，让用户继续完成真个操作流程。所以，调用这类接口时，必需传送参数return_url即协作同伴的下一个操作页面。立刻前往页面跳转表示图异步前往处置结果，即用户从协作同伴页

26、面跳转到网银支付页面后支付宝先做记录，在网银系统完成最后操作，用户不用再回到协作作同伴页面。这类接口通常是经过HYPERLINK l _从支付宝获取到的参数列表通知接口异步获得处置结果。假设需求异步前往结果，那么必需传送notify_url参数，以指定通知前往的地址。假设不需求异步前往结果，那么可以不用传送notify_url参数。详细流程可以参考：HYPERLINK l _支付宝自动通知处置流程支付宝自动通知处置流程 页面跳转经过通知接口前往结果表示图支付宝自动通知处置流程1.支付宝平台系统向外部商户系统发出通知，即访问外部商户提供的通知接纳URL参数notify_url。2.外部商户系统接

27、到通知恳求，经过notify_id讯问支付宝平台系统这个通知的真实性,通知验证。3.支付宝平台系统判别通知能否是本人发送，假设是前往true，否那么前往false。4.商户系统得到支付宝平台系统确实认后，对通知进展处置。处置终了后，前往结果给支付宝平台系统，处置结果的值见附件：HYPERLINK l _通知前往结果枚举通知前往结果枚举。5.支付宝平台系统处置商户系统前往的处置结果。通知验证从系统安康性角度思索，在接纳到支付宝平台系统通知以后，验证支付宝的系统通知的正确性合法性是非常有必要的。剧烈建议外部商户系统参与此运用。 了保证该接口被合法利用，商户系统只能查找1分钟之内目前为1分钟，以后假

28、设有调整，恕不另行通知的通知。 传送的参数格式：通知验证字段名变量名类型阐明可空样例接口称号serviceStringcustomer_unsignNtrade_status_sync外部商户partnerString(16)外部商户在支付宝的用户IDN通知IDnotify_idString支付宝发送的通知IDN基于HTTPS协议的通知验证接口程序在运用时按照以下要求发起一个HTTPS恳求，获取该恳求的结果即可，一切能够出现的结果见以下的输出参数表，这种验证通知的方式需求网站支持HTTPS访问，假设网站不支持https的访问，可以运用另外一种验证方式：基于HTTP协议的通知验证接口。接入URL

29、：httpsalipay/cooperate/gateway.do一个完好的验证恳务虚例：httpsalipay/cooperate/gateway.do?service=customer_unsign &partner=1234567890¬ify_id=abcdefghijklmnopqrst 基于HTTP协议的通知验证接口程序在运用时按照以下要求发起一个HTTP恳求，获取该恳求的结果即可，一切能够出现的结果见以下的输出参数表。接入URL：notify.alipay/trade/notify_query.do一个完好的验证恳务虚例：notify.alipay/trade/notify

30、_query.do?partner=1234567890¬ify_id=abcdefghijklmnopqrst通知验证接口输出参数：输出内容阐明能够的缘由invalid传入的参数无效查找参数格式true验证经过false验证失败查找能否由于sign和mysign不相等引起的1分钟内失效的问题数字签名构造恳求参数构造为了确保数据传输过程中的数据真实性和完好性，我们需求对数据进展签名校验。HTTP恳求中传送的一切参数(除sign和sign_type以外)按照参数称号字符升序的顺序串联起来如：p1=v1&p2=v2&p3=v3，构成待签名数据。按照sign_type指定的方式对待签名数据进展

31、签名。例如：调用某接口需求以下参数：service=cae_charge_agentpartner=2088006300000000=testmsn那么待签名数据就是：=testmsn&partner=2088006300000000&service= cae_charge_agent。签名算法对比 算法功能MD5DSARSA防篡改防抵赖加密电子签名法能否成认MD5算法构造定义：MD5是一种摘要生成算法，本来是不能用于签名的。但是，经过在待签名数据之后加上一串私密内容指令发送、接纳双发事先规定好的，这里我们称其为签名密钥，就可以用于签名了。运用这种算法签名只能起到防数据篡改的功能，不能起到签名

32、防抵赖的功能，由于双方都知道签名密钥例如：待签名数据 + securityCode值支付宝为协作同伴颁发的平安校验码的MD5摘要作为签名。例如：平安校验码是mysecurityCode，那么前面会员查询接口例如的待签名数据就是：=testmsn&partner=2088006300000000&service=user_querymysecurityCode。DSA算法构造定义：DSA是一种非对称的签名算法，即签名密钥私钥与验签名密钥公钥是不一样的，私钥用于签名，公钥用于验签名。运用这种算法签名在起到防数据篡改功能的同时，还可以起到防抵赖的作用，由于私用只需签名者知道。例如：协作同伴发送恳求时

33、，运用本人的密钥对待签名数据进展DSA签名，支付宝运用协作同伴的公钥进展校验；支付宝前往数据时，运用支付宝的密钥对待签名数据进展DSA签名，协作同伴运用支付宝的公钥进展校验。DSA公私钥可以运用OpenSSL生成，如下：1 生成DSA参数openssl dsaparam -out dsa_param.pem 10242 生成私钥opensslgendsa -out dsa_private_key.pem dsa_param.pem3 生成公钥openssl dsa -in dsa_private_key.pem -pubout -out dsa_public_key.pemRSA算法构造定义：

34、RSA也是一种非对称算法，同时，它还是一种加密算法，运用方法跟DSA签名算法类似1 RSA密钥生成命令生成RSA私钥openssl genrsa -out rsa_private_key.pem 1024生成RSA公钥openssl rsa -in rsa_private_key.pem -pubout -out rsa_public_key.pem将RSA私钥转换成PKCS8格式openssl pkcs8 -topk8 -inform PEM -in rsa_private_key.pem -outform PEM -nocrypt 2 签名/验签名命令RSA签名openssl sha1 -

35、sign rsa_private_key.pem -out rsasign.bin plaintext.txtRSA验签名openssl sha1 -verify rsa_public_key.pem -signature rsasign.bin plaintext.txt公用枚举表通知前往结果枚举 前往结果结果阐明success处置胜利，终了发送fail处置失败，重新发送支付宝平台系统会在24小时内分6-10次发送客户信息，直到接遭到外部商户发送的success留意：不能包含任何其他的HTML脚本言语，否那么支付宝接受数据会收到影响通用买卖形状枚举表A正常买卖形状枚举：买卖形状列表值变量值：

36、trade_status阐明WAIT_BUYER_PAY买卖创建TRADE_FINISHED支付胜利，规范即时到账胜利形状TRADE_SUCCESS支付胜利，机票行业单笔退款胜利没有全部退完TRADE_CLOSED买卖封锁B退款买卖形状枚举：形状代码变量值：refund_status形状称号REFUND_SUCCESS 退款胜利REFUND_CLOSED退款封锁备注：假设在支付宝平台操作退款，买卖形状trade_status会出现2中情况：1. 不是全额退款，买卖胜利形状变成TRADE_SUCCESS，添加一个退款形状refund_status= REFUND_SUCCESS2. 全额退款，买

37、卖胜利形状变成TRADE_CLOSED，添加一个退款形状refund_status= REFUND_SUCCESS。银行列表银行简码银行称号ICBCBTB中国工商银行(B2B)ABCBTB中国农业银行(B2B)SPDBB2B上海浦东开展银行(B2B)CCBB2B中国建立银行(B2B)BOCB2C中国银行ICBCB2C中国工商银行CMB招商银行CCB中国建立银行ABC中国农业银行SPDB上海浦东开展银行CIB兴业银行GDB广东开展银行SDB深圳开展银行CMBC中国民生银行COMM交通银行CITIC中信银行HZCBB2C杭州银行CEBBANK中国光大银行SHBANK上海银行NBBANK宁波银行SP

38、ABANK平安银行bjbank101北京乡村商业银行备注：假设没有需求网银简码，可以讯问支付宝技术支持工程师，更多网银更新中。纯借记卡银行列表银行简码银行称号CMB-DEBIT招商银行CCB-DEBIT中国建立银行ICBC-DEBIT中国工商银行COMM-DEBIT交通银行GDB-DEBIT广东开展银行BOC-DEBIT中国银行CEB-DEBIT中国光大银行SPDB-DEBIT上海浦东开展银行PSBC-DEBIT中国邮政储蓄银行备注：其他银行陆续添加中。 信誉卡大额银行列表银行简码银行称号icbc301中国工商银行ccb301中国建立银行cmb301招商银行boc301中国银行comm301交

39、通银行gdb301广东开展银行cib301兴业银行ceb301中国光大银行spabank301平安银行citic302中信银行spdb301浦发银行shbank301上海银行备注：其他银行陆续添加中。订单形状列表订单形状表：订单形状值初始I胜利S失败F冲正P被冲正NFAQ常见问题的的解答问：我运转程序后怎样不断报错误代码：ILLEGAL_SIGN？答：假设不断报ILLEGAL_SIGN签名错误，请首先检查程序中传给支付宝的参数有没有存在空值；然后再检查subject和body有没有特殊的字符。详细可以衔接这个网址查询：help.alipay/support/index.htm问：怎样不断报HAS_NO_PRIVILEGE？答：报这个错误，阐明您目前没有运用该效力的权限。遇到这个错误:a.) 要确定您的合同是在生效期内并且有这个效力譬如：即时支付的效力。b.)将出现错误的URL地址栏的地址粘贴出来，看看partner和service是不是这个对应的效力参数问：我怎样接受不到支付宝前往的信息？答：假设没有接纳到支付