环境正式环境 HTTPS请求地址https://openapi.alipay.com/gateway.do

alipay.user.agreement.page.sign(支付宝个人协议页面签约接口)

版不需本要号授权1.9

支AP持I用应户用在支场▇▇▇页说面明完成1支1付宝代扣协议的签约，目前只支付宝钱包H5页面场景。

公请求共地参址数




环境

正式环境

HTTPS请求地址

▇▇▇▇▇://▇▇▇▇▇▇▇.▇▇▇▇▇▇.▇▇▇/▇▇▇▇▇▇▇.▇▇

公共请求参数


API应用1场1 景说明

类型

是必否填

最长大度

描述

示例值

app_id method

String String

是是

32

128

支付宝分配给开发者的应用ID接口名称

2014072300007148

alipay.psaegre.a.sgigrenement

format

String

否

40

仅支持JSON

JSON

return_url

String

否

256

HTTP/HTTPS开头字符串

https:/G/▇▇▇.▇▇▇▇▇▇▇▇▇▇.▇▇▇/

charset

String

是

10

请求使用的编码格式，如utf-8,gbk,gb2312等

utf-8

sign_type

String

是

10

商户生成签名字符串所使用的签名算法类型，目

RSA2

sign

String

是

344

前支持RSA2和RSA，推荐使用RSA2商户请求参数的签名串，详见<a

详见示例


timestamp


String


是


19

htemf=?"trhetetpIds=:/2/9d1o&ca.orptiecnle.aIdli=p1a0y5.c9o7m4&/docTs/ydpoec=.

发送请求的 1">签，名格<式/a>

时间 "yyyy-MM-dd


2014-07-24 03:07:50

version

String

是

3

HH:mm:ss"

调用的接口版本，固定为：1.0

1.0

notify_url

String

否

256

支付宝服务器主动通知商户服务器里指定的页面

▇▇▇▇://▇▇▇.▇▇▇▇.▇▇▇▇▇▇.▇


app_auth_token


String


否


40

http/https路径。详见<a

et/ati_nntoertfifayc.eh/trmeceive

biz_content

String

是

-

hil.rhetfm="?httrtepesI:d//=d2o1c6.&oapretnic.laelIidp=a1y0.c5o1m93/d&odco2c/Tdyeptea

=1">应用授权概述</a>

请所有求参请数求的参数集合都，必最须大放在长度这不个限参，数除中公传共递参，数具外体






参照各产品快速接入文档


请求参数


参数

类型

是必否须

最长大度

描述

示例值

sign_validity_period

String

否

8

整周当前期形用。数户签约请求的协议有效议有目间效开期始，算从起。发起签约请求的时

12. 前d：支天持的时间单位：

如。果m：未月传入，默认为长期有效

2m

product_code

external_logon_id

String

String

否

否

64

100

用销宝售合户在产同所商品户对码，应网商的站户产的登签品码约录。的账支付

GENERAL_NWGITHHOLDI

13852852877

personal_product_code

String

是

64

个为空用人，于则在不签品约展示页码面，展商示户，和如果付

GENERAL_WITHHOLDI

sign_scene

String

否

64

术协支签议持约。约时场确景定，，商户可和咨支询付技宝

NG_P

INDUSTRY|CARRENTA


external_agreement_no


String


否


32

签支约持时。确定，商户可咨询技术 当ex传ter入na商l_户ag签re约e号ment_no时

商DE场FA景U不LT号能|D为，EF默代AU认扣L值协T。议中标示

用户的唯一签约号（确保在商

L


test


third_party_type


String


否


32

户格和系式数统规字，则中唯：最一支长3持）2大位写。小写字母

用商户在系同统按一产需传品入码，、如果同一约

，场签那景约么下需，要签主指定体并类传型入。该对值于。议三

方协议，表示当前用户和哪一


PARTNER


zm_auth_params


ZmAuthParams


否


-

取类1 的值PA第范RT三围N：方E 主体进行签约。

）2. ，ME集R团CHARN（T（平集台团商商户户）

签约内容下子商户可共享用户

默认为PARTNER。

息，针对于信用代


-

buckle_app_id

String

否

64

扣签约。json格式。

商户在芝麻端申请的appId

1001164

buckle_merchant_id

String

是

64

商户在芝麻端申请的

2688200000004143977

prod_params

ProdParams

否

-

merchantId

签约产品属性，json格式

85

-

auth_biz_params

String

否

256

预授权业务信息

{"platform":"taobao"}

promo_params

String

否

512

签约营销参数，此值为json格

{"key":"value"}

access_params

AccessParams

否

-

式请；按当具前体接的k入e的y需方与式营进销行约填定充

-


channel


String


是


20

，数且取输值入范值围。必须为文档中的参 扫装码htt或p的者请短求信地页址面访签问约中需间要页拼

面接s，ch钱e包mha5的页请面求签地约址可直接拼

1. 前AL支IP持AY以AP下P值（：钱包h5页面


ALIPAYAPP


sub_merchant


SubMerchantPa


否


-

23. 约QR）CODEO扫R码SM签S约(扫)码签约

此或者参数短信用于签约传)递子商户信息


-


sub_merchant_id

rams


String


否


20

，前无商户特代殊需扣求、时海不外用代关扣注、。目旅定（行信在销用售住方产品案支中持“传是入否该允参许数自

）。义子商户信息”需要选是

子商户的商户id


2088123412341234

sub_merchant_name

String

否

50

子商户的商户名称

滴滴出行













sub_merchant_service_name

snub_merchant_service_descriptio device_params

String

String

DeviceParams

否

否

否

50

150

-

子商户的服务名称

子商户的服务描述

设备信息参数，在使用设备维

滴滴出行免密支付

免密付车费50，0 单次最高

-

device_id

String

否

256

度些信签息约代扣协议时，可以传这

设备Id

device12345

device_name

String

否

128

设备名称

电视

device_type

String

否

128

V设R备一类体型机，：目VR前_M有A四C种HI值NE：、

TV


merchant_process_url


String


否


1000

：电视ID_：CTAVR、D、身工份牌证

：WORK_CARD户处理url


▇▇▇▇▇://▇▇▇.▇▇▇▇▇▇▇


identity_params


IdentityParams


否


-

程应用中跳场转景：到商户需自要己在的签页约流做如获处理取的实场名信景，息等如获得用户授权面特何地获址取：商户自己提供的页

数传殊，说明：商户如果传递此参所

名用递户的实地名址信息，参不传数则，不包会含跳转

、身份证号、签约指定：姓

tpagees.scIodm=2/3in4d5e6x7?8proc


-

user_name

String

否

64

参uid数。，商支户▇▇▇入会用对户比实用名户信在息支

付宝端的实名信息。用户姓名

张三

cert_no

String

否

64

用户身份证号

▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇

identity_hash

String

否

128

用户实名信息hash值

A83DA966299E2E8F06EE6C8A6DC3FC02C93


sign_user_id


String


否


32


签约指定用户的uid，如用户

F5D5CA98263AAFDFC36CCA9122020 2088202888530893

agreement_effect_type

String

否

30

协一登致录议则的生报uid错类和型指, 定的用户uid议不

是立即生效还是用等于待指商定户协通知

DIRECT


user_age_range


String


否


40

再生DIR生效.效. 可空, 不填默认为立即

N再O次TEICCTE用:: 立商即户生通效知.生效, 需要

aflifpeac调y.（us支er付.a宝gr个ee人ment.s签ig约n.

生效接t 口）接口推进协议生效.

默认为DIRECT 签约用户的年

制的


{"min":"18","▇▇▇":"30


period_rule_params


PeriodRulePara


否


-

的龄范用围户，年m龄i下n表限示，可m签ax该表协示议年

龄"1上8"限,"m。a如x"{:""m3i0n""}:表示

周约18该=<协年议龄。<=30的数用户可以签

pe期rio管d控_r规ule则_参params，在签

"}

-


ms



C传约Y周，CL期E_扣P款AY产_A品U（TH如_时P）无时需必传入里。传入在周签的期约参扣其数款提他产示产品用品，户会，按并照对这

等发做起相扣应款的限制时。间、金额、次数


period_type

String

是

20

扣周期款类产M型品Op必e填rio，d枚_ty举p值e是为周期 D，AMYO即扣款N周TH期。按天计

然与月另。一NTH代表扣款周期按自

p定e扣rio款d周_ty期p，ee例rio如d组合使用确 期DA为Y，30p天er；iopd为=r3io0，d_则ty扣pe款为▇ ▇MO期N为TH3个，自peerio月d。=3，则扣款 少自然天，月周是指期都，然不计论算这到个月月份有中多的

同43日一为日一期个。自例然如月1月，31日月到3日2月到

期月类3型日使为用三M个O自N然TH月的。时注候意周 e，x计ec划ut扣e_款▇▇▇时e间不允许传28日

）之后，的以日此期避（免可有以些传月份28可日能不

存在对应日期的情况。

DAY

period


execute_time

Number


String

是


是

8


16

必p周e填期rio数。dp与e另rio一d参是数周期扣款产品

款DA周Y，期，_ty例p如e组pe合ri使od用_t确yp定e为

期首为90p天er。iod=90，则扣款周

ex次ec执ut行e_时▇▇▇间e是周期扣款产

3


2019-01-23


single_amount


Price


是


32

的y品y时必yy填间-M。，M精即-d商确d 到户日发，起格首式次扣为款

，结合会其确定他必商填户的扣款周期参数划

的。扣发款起计扣款划。的时金间需符合这里

sin次gl扣e_款am最o大unt额是周期扣款产


10.99


total_amount


Price


否


32

户品制必的每填最次，大发起金扣额款，都单不起允扣▇▇大。于限商

此总金额。限制 位为元。如果

传入此参数，商户多次扣款的


600

total_payments

Number

否

8

累计金额不允许超过此金额。数

，则商户成功扣款的次数不能

12

allow_huazhi_degrade

String

否

10

超计是过入否此）允次。许数限制（扣款失败不

扣（即销售方案O指降定级的成代原扣代产

false





品使级）用，该f，al在值s 花。取芝G值O：场tr景ue下-允才许会降

为false。e-不允许降级。默认


公共响应参数



是必否须

最长大度

描述

示例值

code

msg

String

String

是

是

~

~

:ht关tp返s:回//d码o，▇▇.▇▇▇▇▇▇▇.▇▇▇▇▇▇▇.▇▇

m/common/105806 文档

:ht关tp返s:回//d码o描cs.述op，▇▇▇.▇▇▇▇▇▇▇.▇▇

40004

Business Failed

sub_code

String

否

~

m/common/105806

null

isv.invalid-signature

sub_msg

String

否

~

null

交易已被支付







参数 类型

sign

String

是

64

:ht名tp，s:详//▇▇▇▇▇▇.▇▇▇▇▇.▇▇▇▇▇▇.▇▇ m/291/106074

JD+ZPXOhi8PehefTDuxAOHYoBYfUE3Nwn1 IlZkes6TH/Vz70Py4DzWJd5Cyopj/WviEuafU6 be5dIq0o/V65DW+EfUNTSd3LOHYdRc8+zER Fpy1CPkISiQ7hBBdxhIhzzgrnsgZPHdbPRdqf

b7o4kV36DZxdcw+AczAon=Fauu4

响应参数


参数

类型

是必否须

最长大度

描述

示例值

external_agreement_no

personal_product_code

String

String

否

是

32

64

）约。号扣（协确议保中标在示商用户户系的统唯中一唯签一协议产品码，商户和支付宝签

test

GENERAL_WITHHOLDI

valid_time

String

是

32

不用同时户的确代扣定签协，约产不品码业。务场景对应

议的实际生效时间

NG_P

2017-05-20 11:49:19

sign_scene

String

是

64

H，H格:m式m为:sysy。yy（-M只M有-d签d 约成功

才会返回）

当前签约的协议场景。

INDUSTRY|CARRENTA

agreement_no

String

是

64

支付宝系统中用以唯一标识用

2017050200L061075599


zm_open_id


String


否


64

户约成户功的时芝才麻的信会返用回号）。（只有签

penId，供商

3

2688160578524613135

invalid_time

String

是

32

户（只查户有询代用签约▇▇▇功时信才用返使回用）。

扣协议的失效时间，格

38942792

2017-05-20 11:49:19

sign_time

String

是

32

式HH为:myymyy:s-sM。M（-d只d 有签约成功

支才会付返宝代回）扣协议的实际签约时

2017-05-20 11:49:19


alipay_user_id


String


是


32

间HH，:m格m式:s为s。yy(y只y-有M签M-约dd成功才 会用返户回签)约的支付宝账号对应的


2088101143488930


status


String


是


10

以支付20宝88唯开一头用的户16号位。纯数字组

成回)。(只当有签约成功时才会返

1. 议TE的MP：前暂状存态，。协议未生效


NORMAL


forex_eligible


String


否


10

过2. ；NSTOORPM：AL暂：停正。常；

（是只否有签约成功才会返回）

：T/F海（外只购有汇在身签份约。成值功时才


T

external_logon_id

String

否

100

会返回） 网站的登录账号

，如果商户接口中未传，则不

13852852877

alipay_logon_id

String

是

100

会返回脱敏的支付宝账号，如需

▇▇▇▇***▇▇▇@▇▇▇▇▇▇.▇▇▇





号要返，需回要不脱用户敏的在签支约付页宝面用上户授账权


请JA求VA示版本例

ApAlriipvayteC_likeenyt"a,r"lijpseoanyC",l"ieGnBtKg="e,n"eawlipDaeyf_apuultbAlliicp_akyeCyl"ie,"nRtS("Ah2t"t)p;s://▇▇▇▇▇▇▇.▇▇▇▇▇▇.▇▇▇/▇▇▇▇▇▇▇.▇▇","app_id","your

reliqpuesUt.sseertABgizeComnteennttP("a{" +SignRequest request = new AlipayUserAgreementPageSignRequest();

"\"sign_validity_period\":\"2m\"," +

"\"exrotedruncatl_logdoen\"_:i\d"\G"E:\N"1E3R8A5L2_8W5I2T8H7H7\O"L,"D+ING\"," + "\"siegrns_osncaeln_ep\r"o:d\"uINctD_UcoSdTeR\Y"|:C\"AGRERNEENRTAALL_\W","IT+HHOLDING_P\"," + "\"thxitredr_npaal_ratyg_rteyepme\e"n:\t"_PnAoR\"T:\N"EteRs\t"\," "+ + "\"bmuc_kalue_tha_pppa_riadm\"s:\\""1:{0"0+1164\"," +

" "b},u" c+kle_merchant_id\":\"268820000000414397785\"" +

"\"aurothd_bpiazr_apmarsa\"m:{s"\+":\"{\\\"platform\\\":\\\"taobao\\\"}\"" + "\"p},r"o+mo_params\":\"{\\\"key\\\":\\\"value\\\"}\"," + "\"chccaensnse_lp\"a:r\a"AmLsI\P"A:{Y"A+PP\"" +

"\"s},u"b+_merchant\":{" + "\"sub_merchant_inda\m":\e"\2"0:\8"8滴1滴23出41行23\4",1"2+34\"," +

"\"sub_merchant_service_ndaemsceri\p"t:\io"滴n\滴":\出"免行密免付密车支费付，\"单,"次+ 最高500\"" + "\"d},e"v+ice_params\":{" +

"\"device_inda\m":\e"\d":e\v"i电ce视12\3",4"5+\"," +

" "d},e"v+ice_type\":\"TV\"" +

"\"idenrcthitayn_tp_aprraomces\s"s:_{"ur+l\":\"https://▇▇▇.▇▇▇▇▇▇▇▇▇▇▇▇.▇▇▇/index?processId=2345678\"," + "\"cesretr__nnoa\m":e\"\6":1\1"张02三61\9"9,"2+1108888\"," + "\"sdigenn_tiutsye_rh_aidsh\"\":\:"\"280D88926092E8E8F865E3C0A8D933C\"2"9+A3A629280E686CF0C3F5D5A86AFF3CA12020C923ADC6C92\"," +

"\"a},g"r+eement_effect_type\":\"DIRECT\"," +

"\"pseeriro_da_greu_lrea_npgaer\a"m:\"s{\\"\:\{" + in\\\":\\\"18\\\",\\\"▇▇▇\\\":\\\"30\\\"}\"," +

"\"period\"t:y3p,"e\+":\"DAY\"," + "\"sixnegcluet_ea_mtiomuen\t"\:"\:"1200.199,0"1+-23\"," + "\"total_pmayomuennt\t"s:\6"0:102,"" ++ "\"a},l"lo+w_huazhi_degrade\":\"false\"" +

"▇▇▇}p")a;yUserAgreementPageSignResponse response = alipayClient.pageExecute(request); iSfy(rsetsepmo.nosuet..ipsrSiunctlcne(s"s调()用){ 成功");

}

}Seylsstem{ .out.println("调用失败");

PHP版本

$aop-=>agnaetweIwAaoypUCrlile=n'th(t)t;p_sid:/'/;▇▇▇▇▇▇▇.▇▇▇▇▇▇.▇▇▇/▇▇▇▇▇▇▇.▇▇';

$aop->rspapPrdiv=a'tyeoKuerya=p'p请填写开发者私钥去头去尾去回车，一行字符串';

$aop->saipipinVaeyrrssiaoPn=u='b'l1ic.0K'e; y='请填写支付宝公钥，一行字符串';

$aop->>fpoogsmtTCayhpaerjseotR=S';GAB2K';';

$$requesttr=>sneetw='AzClipna' yteUnste(r"A{"g.reementPageSignRequest ();

"\"sirgond_uv-atlidtitByi_ep\"eorni"oGdE\N":E\"R2AmL_\"W,"IT. HHOLDING\"," .

"\"exetresroncaall__lpogdodnu_:i\dt_\"c:o\"d1e3\"8:5\2"G85E2N8E7R7A\"L,_"W. ITHHOLDING_P\"," .

"\"sixgtne_r sncael_nae\r"o:\e"mINc DnUt_SnToR\Y"|:C\"AtReRstE\NT"A. L\"," .

"\"thmir_da_nptahr_tpyg_rteyapmes\e""::\{""P.ARTNER\"," .

"\"bucklue_appa_rid\":\\"1001164\"," .

" },r"o. kle_merchant_id\":\"268820000000414397785\"" .

"\"authd_bpiazr_apmarsa\"m:{s"\.":\"{\\\"platform\\\":\\\"taobao\\\"}\"" .

"\"p},r"▇.▇▇_params\":\"{\\\"key\\\":\\\"value\\\"}\"," . "\"chccaensnse_lp\"a:r\a"AmLsI\P"A:{Y"A.PP\"" .

"\"s},u"b._merchant\"d:{\"".:\"2088123412341234\"," .

"\"sub_merchant_name\":\n"a滴m滴e\出":\行"滴\"滴," .出行免密支付\"," .

"\"s},u"b._merchant_service_description\":\"免密付车费，单次最高500\"" . "\"device_pda\r"a:\m"dse\"v:i{c"e.12345\"," .

"\"device_tnyapme\e"\:"\:"\T"电V\"视"\."," .

" }," .rchant_process_url\":\"https://▇▇▇.▇▇▇▇▇▇▇▇▇▇▇▇.▇▇▇/index?processId=2345678\"," . "\"idseenr_tintya_mpea\r"a:m\"s张\"三:{"\".," .

"\"cdeernt_tnitoy\_"h:\a"s6h1\1"0:\2"681D9996291E1E0F868E8C8A\"D,3"C. 29A3A629280E686CF0C3F5D5A86AFF3CA12020C923ADC6C92\"," .

"\"s},i"gn. _user_id\":\"2088202888530893\"" .

"\"agserer_eamgeen_tr_aenfgf e\"t_:\t"y{p\\e\\":\i"nD\I\R\"E:C\\T\\""1,8"\.\\",\\\"▇▇▇\\\":\\\"30\\\"}\"," . "\"period_tryuplee_\p":a\r"aDmAYs\",:"{"..

mount\":600," .

"\"single_amount\":10.99," .

"\"pxeericoudt\e"_:3ti,m" .e\":\"▇▇▇ ▇▇-▇▇\"," .

}," .

"\"total_payments\":12" .

" }");

"\"allow_huazhi_degrade\":\"false\"" .

$result = $aop->pageExecute ( $request);

$res

lotnCsoedNeo=d$er=essutrlt_-r>e$prleascpeo("n.s"e, N"_o"d, e$-r>ecqoudees;t->getApiMethodName()) . "_response";

iefc(!heom"p成ty功($"r;esultCode)&&$resultCode == 10000){

}

}ecehlsoe "{失败";

.NET版本

I"AmoeprCclhieanntt_cplierinvta=ten_ekweyD",e"fajsuolntA"o, "p1C.0li"e,n"tR("ShAt2tp",s:"/a/loipaeyn_appui.balicp_akye.cyo"m, "/GgBaKte"w, faayls.deo);", "app_id", rAeliqpuaeysUt.sBeirzACgorneteemnet=n"t{P"a+geSignRequest request= new AlipayUserAgreementPageSignRequest() ; "\"pirgond_uvcatl_idciotyd_ep\"e:r\i"oGdE\N":E\"R2AmL_\"W,"IT+HHOLDING\"," + "\"pxetresronnaall__lporgoodnu_cidt_\"c:o\"d1e3\"8:5\2"G85E2N8E7R7A\"L,_"W+ITHHOLDING_P\"," + "\"eixgtne_rnscael_naeg\r"e:\e"mINeDnUt_SnToR\Y"|:C\"AtReRstE\N",T"A+L\"," +

"\"zhmir_da_uptahr_tpya_tryapmes\\""::\{""P+ARTNER\"," +

"\"buckle_ampepr_cihda\n":t\_"i1d0\0":1\1"26648\"8,2"0+000000414397785\"" + "\"p},r"o+d_params\":{" +

" "a},u"t+h_biz_params\":\"{\\\"platform\\\":\\\"taobao\\\"}\"" +

"\"acrocemsos_params\"::{\""{+\\\"key\\\":\\\"value\\\"}\"," + " "c},h"a+nnel\":\"ALIPAYAPP\"" + "\"sub_merchant_"id:{\""+:\"2088123412341234\"," +

"\"sub_merchant_nsearmviec\e"_:\n"a滴m滴e\出":\行"滴\"滴," 出+ 行免密支付\"," +

" "s},u"b+_merchant_service_description\":\"免密付车费，单次最高500\"" +

" }," +

"\"device_ipda\r"a:\m"dse\"v:i{c"e+12345\"," + "\"device_ntyapme\e"\:"\:"\T"电V\"视"\+"," +


"\"idseenrcthitayn_mtp_aprraomces张\s"s:_{"ur+l\":\"https://▇▇▇.▇▇▇▇▇▇▇▇▇▇▇▇.▇▇▇/index?processId=2345678\"," +

"\"cdeertr__ninoa\_"h:e\a"\6":1\1"0:\2"三681D\9"9,"2+1E1E0F868E8C8A\"D,3"C+29A3A629280E686CF0C3F5D5A86AFF3CA12020C923ADC6C92\"," +

"\"s},i"gnn_tutsyer_idsh\"\":\"2088926092888530893\"" +

"\"agser+er_eamgeen_tr_aenfgf e\"t_:\t"y{p\\e\\":\i"nD\I\R\"E:C\\T\\""1,8"\+\\",\\\"▇▇▇\\\":\\\"30\\\"}\"," +

"\"period_tryuplee_\p":a\r"aDmAYs\",:"{"++

"\"pxeericoudt\e"_:3ti,m" +e\":\"▇▇▇ ▇▇-▇▇\"," +

"\"single_ammoouunnt\t"\:"6:100.,9" 9+," +

"\"t},o"t+al_payments\":12" +

"\"}"a;llow_huazhi_degrade\":\"false\"" +

ACloipnasoyUles.WerrAitgerLeienme(ernetsPpaognesSei.gBnoRdeys);ponse response=client.pageExecute(request);

HTTP版本

h08tt:p08s:0/8o&pmeneathpoi.dal=ipalaipy.acyo.mus/egra.ategwreaeym.deon?tt.ipmaegset.asimgnp&=2a0p1p3_-i0d1=-1071488&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKH J{EREEEEEEEEEEE&version=1.0&charset=GBK&biz_content=

"pirgond_uvcatl_idciotyd_ep":e"rGioEdN"E:"R2AmL_",WITHHOLDING", "pxetresronnaall__lporgoodnu_cidt_"c:"o1d3e8"5:2"G85E2N8E7R7A"L, _WITHHOLDING_P", "eixgtne_rnscael_naeg"r:e"IeNmDeUnStT_RnoY|"C:"AtReRstE"N, TAL", "zhmir_da_uptahr_tpya_tryapmes""::"{PARTNER", "buckle_ampepr_cihda"n:"t1_0id0"1:1"26648",820000000414397785" "p}r,od_params":{

"a}u, th_biz_params":"{\"platform\":\"taobao\"}"

"acrocemsos_params"::{"{\"key\":\"value\"}", "c}h,annel":"ALIPAYAPP" "sub_merchant_:i{d":"2088123412341234", "sub_merchant_nsearmviec"e:_"n滴a滴m出e"行:"滴",滴出行免密支付",

"s}u,b_merchant_service_description":"免密付车费，单次最高500"

"device_ipda"r:a"dmesv"i:c{e12345", "device_ntyapme"e:"":T"电V"视",

"m},erchant_process_url":"▇▇▇▇▇://▇▇▇.▇▇▇▇▇▇▇▇▇▇▇▇.▇▇▇/▇▇▇▇▇?▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇",

"udseenr_tintya_mpea"r:a"m张s三":{",

"ideernt_tnitoy"_:h"a6s1h1"0:2"681D9996291E1E0F868E8C8A"D, 3C29A3A629280E686CF0C3F5D5A86AFF3CA12020C923ADC6C92",

"s}i,gn_user_id":"2088202888530893"

"ugserer_eamgeen_tr_aenfgfe"t:"_{t\y"pmei"n:"\"D:I\R"1E8C\T"",\,"▇▇▇\":\"30\"}", "period_rtyuplee_"p:"aDraAmY"s,":{

"exeericoudt"e:_3t,ime":"2019-01-23",

"tointgal__aammoouunnt"t:"6:100,99, "to},tal_payments":12 "}allow_huazhi_degrade":"false"

//为确保安全通信，需自行验证响应示例中的sign值是否为蚂蚁金服所提供。

响JS应ON示示例例

"{ a"licpoadye_"u:"s1e0r_0a0g0r"e, ement_page_sign_response":{

"e"xmtesrgn"a:l"_Saugcrceeesms"e,nt_no":"test",

"viaelrisdo_sntiaml_ep"r::o""2d0u1c7t_-0c5o-d2e0"1:"1G:R4E9N:▇▇▇▇"▇, ▇_▇▇▇▇▇▇▇▇▇▇▇_▇",

"aggrne_emc enet_"noIN":D"2U0S1T7R0Y5|0C2A00R0E6N1T07A5L5",993",

"inmv_aolidp_etni_mide":"26081871-0650-527081512:44691:1391"3,538942792",

"ailgipna_yt_imusee"r:"_2id0"1:7"-20058-821001111:4394:1898"9,30",

"fotaretux_s"e:l"igNiOblReM":A"TL",

"}axlitpearyn_allo_gloogno_nid_"id:""t:e"s1t3*8*5*a2l8i@52a8l7ip7a"y, .net"

,}"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"

异JS常ON示示例例


""caolidpeay:_u2s0e0r0_0a"g,"remesmg"e:n"tS_epravigcee_Csiugrnre_nretlsypUonaev"a:i{lable","sub_code":"isp.unknow-error","sub_msg":"系统繁忙"}

,"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"}

业务错误码





ENRTR_OFRRO错误码

ERROR_RZIESNK_ACCOU

_RI _BLANCE

用户账户被冻结 错误描述

用户账号余额支付功能关闭

解决方案

提示用户解冻支付宝账号

提示用户支付宝账号打开余额支付功能

_UPAEYR_CLOSE NT_NOT

S _ACCOU

用户账户未绑定手机

提示用户支付宝账号绑定手机号

_MBINCDHEDN_MOABGILEEME

ER A RE

商户协议不存在

商户与支付宝签约代扣合同

NP T_IS_NCOT_EXISTNOT

RODU T_CODE_

无效的个人产品码

商户确认个人产品码填写是否正确

_USUEPPORTED_ERROR

S R_AGREEMENT_P

协议已存在，协议有效周期冲突

接口填入的协议有效期与已签约的协议有效期冲

EURIEORD_CONFILICT

S REALNAME_ST

用户未实名不允许签约

突，需填入已存协议的有效期

提示用户补充支付宝账号信息完成实名制

AUTS_ENRROR

COU T_LEVEL_CH

用户账户等级不满足签约要求

提示用户在支付宝主站提高个人支付宝账户等级

EZCKIM_FAILCORE_VALID

H A_S

用户芝麻分校验失败

信用代扣场景，用户芝麻分不满足商户设定的签

AZTEI _FAILED

H MA_AUTHORIZE_F

芝麻授权开通失败

▇信芝用麻代分扣场景，授权开通芝麻失败，需与芝麻共

AZILEMDA_RISK_VALIDAT

HI

芝麻风险名单校验失败

同信排用查代原扣因

场景，用户支付宝账号未通过芝麻风险

EU_FAILED

SER_INFO_NOT_MA

外部签约号已签约场景，用户信息不匹配

名单校验

商户更改外部签约号

TMCEHRCHANT_STATUS_I

商户协议状态不正常

商户确认与支付宝的签约合同是否已失效，并重

SM_NOT_NOR_MA ALEEME

ERCHANT GR

商户协议已过期

新商签户确约商认户与合支同付宝的合同的有效期是否已过期

NMTA_OSUITG_NOF_DATE

X_ _COUNT_C

用户最大签约次数检查失败

用，并户重在该新签商约户下商户已合签同约的协议数达到商户允许的

HECK_FAIL

INVALID_PARAMETER

参数有误

最大签约协议数量，无法继续签约

参数错误，请确认传参是否正确

SYSTEM_ERROR

系统繁忙

系统繁忙，需排查具体原因




OUSREX_ENLOIGT_IBALLELOW_F

用户不具备海外购汇身份信息

需用户补全海外购汇身份信息

OUBURTSIENDE_SESR_RNOORT_SUPP

SER_MOBILE_NOT_

不支持的业务

用户手机号不匹配

商户确认传入业务参数是否符合业务要求

商户传入的手机号与用户支付宝绑定的手机号不

ME ATCH_ERROR

RROR_RIST_CTU_RE

操作存在风险，被CTU拒绝

一致

确认用户的具体操作风险

FUUSE

SER_NOT_EXIST_ER

用户信息不存在

无法查到用户信息，确认用户信息是否存在

RUOSRR_ACCOUNT_NOT

E

用户账户信息不存在

无法查到用户账户信息，确认用户账户信息是否

_SEXIST

ECURITY_CHECK_FAI

操作存在风险

存签在约操作存在风险，需与支付宝确认具体被拦截

LVALIDATECODE_EXPIR

校验码超时

原因

校验码超时，请重新获取

ESD N_USER_ID_NOT_

IG

签约账号不匹配

用户根据错误页面上提示的支付宝账号重新登录

MUSAETCHAGE_RANGE_N

R_

不在商户业务允许的年龄范围

签提约示用户的年龄不在商户业务允许的年龄范围

OT_MATCH


，无法继续签约


触发通知类型

通知类型

描述

默认开启

触发通知字段



是必否须

最长大度

描述

示例值

invalid_time

sign_scene

String

String

是

是

32

64

式用户为代yy扣yy协-M议M的-d失d 效时间，格

HH:mm:ss。

当前签约的协议场景。

2017-05-20 11:49:19

INDUSTRYL|CARRENTA

sign_time

String

是

32

支付宝代扣协议的实际签约时

2017-05-20 11:49:19


alipay_user_id


String


是


32

H用间H，户:m格签m式约:s为s。y支y付yy宝-M账M-dd

号对应的


2088101143488930

status

String

是

10

支以付20宝88唯开头用的户16号位。纯数字组

成协。当前状态

1. 议TEMP：暂存，协议未生效

NORMAL


forex_eligible


String


是


10

23过. ；NSTOORPM：AL暂：停正常；

是否海外购汇身份。值：T/F


T

external_logon_id

String

是

100

，用户如在果商户网接口站的中登未录传账，号则不

13852852877


app_id


String


是


64

会返回

支付宝分配给开发者的应用Id


2017060101317939

auth_app_id

String

是

64

支付宝分配给商户的应用Id

2017060101317935

external_agreement_no

String

是

32

代扣协议中标示用户的唯一签

test


personal_product_code


String


是


64

协）。号议产（品确码保，在商户系和统支中付唯宝一签


GENERAL_WITHHOLDI


valid_time


String


是


32

不用同时户的确代扣定签协，约产不品码业。务场景对应

议的实际生效时间

NG_P

2017-05-20 11:49:19

agreement_no

String

是

64

支，HH付:m宝m系:s统sy。中yy用-M以M唯-dd

一标识用

2017050200061075599

zm_open_id

String

是

64

用户签户约的记芝录麻的信编用号o 。 Id，供商

pen

2688160573524613135

8





户查询用户芝麻信用使用

38942792

参数 类型

alipay_logon_id

String

是

100

要号返，返需回脱要不敏用脱户敏支在的签支宝约付账页宝面用上户授需账

权

▇▇▇▇***▇▇▇@▇▇▇▇▇▇.▇▇▇

notify_type zm_score

String String

是是

100

20

用户签约成功通知类型用户支付宝芝麻分

dut_user_sign 700

login_token

String

是

1000

用户登录token，目前用于集

7ff7664d45c4afe8dcca

device_id

String

是

256

团的信任登录设备Id

b8f224af9379_07 RSED235F875932

credit_auth_mode

String

否

64

授信模式

DEDUCT_HUAZHI





，的是DE花DU芝C代T_扣H。UAZHI代表签约



触发通知示例

a2hbttfp4sd:e//awd&w6siiwbge.m&_neropcthifayn_Sticmoem=/2r0e1c7e-i0v2e-_1n6otify.htm?notify_type=trade_status_sync&notify_id=91722adff935e8cfa58b3a

cN91cV:j4oe6KY:J1Q5iLnJv2a8n/dAtsyl9i 3ej=oRT2WA329&FsXig6ni0=7Wl1XchOn+bt3P1Dk9n8KeszgA7l1w_dmTlvKPnwdNn7QNru9IP0z1SUHOZRXsYZeaFB9VJ1wiE6pg8g/FZOjLBuiSAsixdc5ul_GS8kbXsZeot=TVxYZxBO7pJ- s8A7iudbp2riy9SGCujHJ3CNjmr/aNgUl

p11p:_4i9d:=1&90&1a7li0plia0y__tumseer=_9id0=1270-0858-12001a114:34498: 8=9&300i&gsnt6astcues1=eN=OI RDMUAL&Tfor|eCxA_ReRligNibTleA=T&&egxntetrinmal_l2o0g1on_0i5d-=2103852852877&a

1=1G:E4N9E=R2A&La_gWr6IT1H0H1O31L7DIN39G2&_aPu&7tvha_lidp_pt_i0mide=22011770-0051-02m0317935&external_agreement_no=test&personal_product_code

est***:1a9li@alipeaeym.neentt&_not=ify0_1ty0p5e0=2d0u0t_6u1s0e7r_5s5i9g9n3&&zzm__socpoeren=_7id0=02&6lo8g8i1n6_0t5o7k8e5n2=476ff173616345d34859c442a7f9e28&daccliapba8yf_2l2o4gaofn9_3i7d9=_t

07&device_id=RSED235F875932&credit_auth_mode=DEDUCT_HUAZHI

Document Metadata

Filed: November 21st, 2019