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

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

版不需本要号授权1.7

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

公请求共地参址数




环境

正式环境

HTTPS请求地址

xxxxx://xxxxxxx.xxxxxx.xxx/xxxxxxx.xx

公共请求参数


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/xx0.xXxXxx0x0x.xxx/

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&c.aorptiecnle.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

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

xxxx://xxx.xxxx.xxxxxx.x


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

周当整前期形用。数字户签约请求的协议有效议有间效开期始，算从起。发起签约请求的时目1 前d：支天持的时间单位：

2如. 果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

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

D商E场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


xxxxx://xxx.xxxxxxx


identity_params


IdentityParams


否


-

应xxx跳场转景：到商商户户需自要己在的签页约流做处获理取的实场名景信，息等如获得用户授权如面何地获址取：商户自己提供的页特数殊，说明：商户如果传递此参所传递的地址，不传则不会跳转

名用、户身实份名证信号息、参签数约，指包定含：姓

tpagees.scIodm=2/3in4d5e6x7?8proc


-


user_name


String


否


64

参uid数。，商支户xxx入会用对户比实用名户信在息支付宝端的实名信息。

用户姓名


张三

cert_no

String

否

64

用户身份证号

00000000000000000

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生效E效.CT. 可空, 不填默认为立即

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

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

生默认效为接D口IR）E接CT口推进协议生效.

商户希望限制的签约用户的年


{"min":"18","xxx":"30


period_rule_params


PeriodRulePara


否


-

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

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

1约8该=<协年议龄。<=30的用户可以签

p周e期rio管d控_r规ule则_参pa数rams，在签

"}


-


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组合使用确 D期A为Y，30p天er；iopd为=r3io0，d_则ty扣pe款为xxMO期N为TH3个，自peerio月d。=3，则扣款自少然天，月周是指期，都然不计论算这到个月月份有中多的

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

4期月类3型日使为用三M个O自N然TH月的。时注候意周

，ex计ec划ut扣e_款xxx时e间不允许传28日

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

存在对应日期的情况。

DAY

period


execute_time

Number


String

是


是

8


16

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

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

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

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

3


2019-01-23


single_amount


Price


是


32

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

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

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

sin次gl扣e_款am最o大u金nt额是周期扣款产


10.99


total_amount


Price


否


32

品户制必的每填最次，大发起金额扣每款，次都单不位起允为扣xx大。于限商此总金额。限制 位为元。如果

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


600

total_payments

Number

否

8

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

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

12





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


公共响应参数



是必否须

最长大度

描述

示例值

code

msg

String

String

是

是

~

~

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

m/common/105806 文 档

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

40004

Business Failed

sub_code

String

否

~

m/common/105806

null

isv.invalid-signature

sub_msg

String

否

~

null

交易已被支付

sign

String

是

64

签名，详见文档

DZXh8eeTuAHoYE3w1





:mht/t2p9s1:/1/x0x0x0x0.0xxxx.xxxxxx.xx

Jlk+ePTO/ViP7hPf4DzxJOdYyBofjUWNEna61 bIZ5sI60H/Vz50WyDEWNS53COp/YvRiu8zfUR FeydCqkoiQ6Dh+BfxUIzTgdnLgHPddcP+dEf bp71oP4ISk73BDdxhc+hAzrAsnZFHabuRuq4

V6Zdwczo=

参 数 类 型

响应参数


参数

类型

是必否须

最长大度

描述

示例值

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

，HH格: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

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

扣协议的失效时间，格

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

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

xxxx***xxx@xxxxxx.xxx





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


请JA求VA示版本例

pAAlriipvayteC_likeenyt"a,r"lijpseoanyC",l"ieGnBtKg="e,n"eawlipDaeyf_apuultbAlliicp_akyeCyl"ie,"nRtS("Ah2t"t)p;s://xxxxxxx.xxxxxx.xxx/xxxxxxx.xx","app_id","your

reliqpuigesUt_.sseertABgiizeCy_omnteernnttP("a{"":\+SignRequest request = new AlipayUserAgreementPageSignRequest();

"\"pxrotndruvcatl_idcl otdoep\"e:i\di"oGdE:\N"1E"R2AmL2_\"W,"I2T+H7H7\O"L,"D+ING\"," +

"\"piegrnes_onncaaell__porgo:dnu_ctD_\"co\dTe3\"8:5\"AG85ERN8ENRTAALL_\W","IT+HHOLDING_P\"," +

"\"ehxitredrnsaal_naeg\r"ey\e"mINe"nUt_SnoR\Y"|:C\"tRestE\","+ +

"\"zm_a_upthar_tpya_triadpm\es:\\""::\{""P+XXXXXX\","

"\"b},u" c+kle_mpepr_chan"t\_i1d0\0":1\1"26648\"8,2"0+000000414397785\"" +

"\"prod_params\":{" +

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

" "c},h"a+nnel\":\"ALIPAYAPP\"" +

"\"sub_merchant_"id:{\""+:\"2088123412341234\"," + "\"sub_merchant_snearmviec\e"_:\n"a滴m滴e\出":\行"滴\"滴," 出+ 行免密支付\"," +

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

"\"device_pida\r"a:\m"dse\"v:i{c"e+12345\"," + "\"d},e"v+ice_ntyapme\e"\:"\:"\T"电V\"视"\+"," +

"\"mdenrcthitayn_tp_aprraomces\s"s:_{"ur+l\":\"https://xxx.xxxxxxxxxxxx.xxx/index?processId=2345678\"," +

"\"uesretr__nnoa\m":e\"\6":1\1"张02三61\9"9,"2+1108888\"," +

"\"sdigenn_tiutsye_rh_aidsh\"\":\:"\"280D88926092E8E8F865E3C0A8D933C\"2"9+A3A629280E686CF0C3F5D5A86AFF3CA12020C923ADC6C92\"," +

" },g"r+eement_eff t_type\":\"DIRECT\"," +

"\"user_agreu_lrea_npgaer\a"m:\"s{\\:\{"m+ in\\\":\\\"18\\\",\\\"xxx\\\":\\\"30\\\"}\"," +

"\"period_\"t:y3p,"e\+":\"DAY\"," +

"\"eixnegcut_ea_mtiomuen\t"\:"\:"120199,0"1+-23\"," +

"\"tootal_pamayomuennt\t"s:\6"0:102,"" ++ " }"}");+

iAf(lirpeaspyUonsesreA.igsrSeuecmceesnst(P))a{geSignResponse response = alipayClient.pageExecute(request);

}Seylsstem{ .out.println("调用成功"); S} ystem.out.println("调用失败");

PHP版本

$aop-=>gnaetwewAaoypUCrlile=n'th(t)t;ps://xxxxxxx.xxxxxx.xxx/xxxxxxx.xx';

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

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

$aop->spiogsntTCyhpaers=e'tR=S'GAB2K';';

$reoqpu->efsotr=mnaetw='jAsloipna';yUserAgreementPageSignRequest ();

"$\r"esqigune_stv-a>lsidetitByi_zpCeorniotedn\t"(:"\"{"2m. \"," .

"\"exrotedruncatl_logdoen\"_:i\d"\G"E:\N"1E3R8A5L2_8W5I2T8H7H7\O"L,"X.XXX\"," . "\"siegrns_osncaeln_ep\r"o:d\"uINctD_UcoSdTeR\Y"|:C\"AGRERNEENRTAALL_\X","XX.XXXXXXXX_X\"," . "\"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"x.xx_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"x.xxx_params\":{" .


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

" }," .ice_type\":\"TV\"" .

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

"\"cdeertr__ninoa\_"h:e\a"\6":1\1"0:\2"三681D\0"0,"0.0X0X0X000X0X0X\"D,3"C. 29A3A629280E686CF0C3F5D5A86AFF3CA12020C923ADC6C92\"," .

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

"\"xxxxx.xx_eamgeen_tr_aenfgf e\"t_:\t"y{p\\e\\":\i"nD\I\R\"E:C\\T\\""1,8"\.\\",\\\"xxx\\\":\\\"30\\\"}\"," .

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

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

"\"single_ammoouunnt\t"\:"6:100.,0" 0. ," .

"\"t}"xx.xx_payments\":12" .

"$r}e"s)u; lt = $aop->pageExecute ( $request);

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

e} cehlsoe "p成y功($";esultCode)&&$resultCode == 10000){

e} cho "{失败";

.NET版本

"IAmoeprCclhieanntt_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_pida\r"a:\m"dse\"v:i{c"e+12345\"," + "\"device_tnyapme\e"\:"\:"\T"电V\"视"\+"," +

"\"m},"e+rchant_process_url\":\"https://xxx.xxxxxxxxxxxx.xxx/index?processId=2345678\"," + "\"udseenr_tintya_mpea\r"a:m\"s张\"三:{"\"+," + "\"ideernt_tnitoy\_"h:\a"s6h1\1"0:\2"681D9996291E1E0F868E8C8A\"D,3"C+29A3A629280E686CF0C3F5D5A86AFF3CA12020C923ADC6C92\"," +

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

"\"ugserer_eamgeen_tr_aenfgf e\"t_:\t"y{p\\e\\""m:\i"nD\I\R\"E:C\\T\\""1,8"\+\\",\\\"xxx\\\":\\\"30\\\"}\"," + "\"period_rtyuplee_\p":a\r"aDmAYs\",:"{"++

"\"exeericoudt\e"_:3ti,m" +e\":\"2019-01-23\"," +


"\"tointtgal__aammoouunnt\t"\:"6:100,9"9+," +

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

Alip";ayUserAgreementPageSignResponse response=client.pageExecute(request);

Console.WriteLine(response.Body);

HTTP版本

0h8tt:p08s:0/8o&pmeneathpoi.dal=ipalaipy.acyo.mus/egra.ategwreaeym.deon?tt.ipmaegset.asimgnp&=2a0p1p3_-i0d1=-1051665&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_pida"r:a"dmesv"i:c{e12345", "device_ntyapme"e:"":T"电V"视",

"m},erchant_process_url":"xxxxx://xxx.xxxxxxxxxxxx.xxx/xxxxx?xxxxxxxXxx0000000",

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

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

"s}ig, n_user_id":"2088202888530893"

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

"total_amount":600,

ing _amount":1 99,

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

}

"total_payments":12

}

//为确保安全通信，需自行验证响应示例中的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:0X0X"X, X_XXXXXXXXXXX_X",

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

"zm_open_id":"268816057852461313538942792",


"snilgvna_litdim_teim":e"_2":0"1270-21075--0250-2101:1419::4199:"1,9",

"sotaiptauy_s_"e:u"isNeOrlReiMd"A:L"",088101143488930",

"exrternall_gliobgo"n:_"Tid",:"13852852877",

, }alipay_logon_id":"xxxx***xxx@xxxxxx.xxx"

}"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_RZEISNK_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

用户芝麻分校验失败

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

AZHTEI _FAILED

MA_AUTHORIZE_F

芝麻授权开通失败

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

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

系统繁忙

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

US NOT_ALLOW_F

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

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

OB REX_ELIG_IBLE

USINESS NOT_SUPP

不支持的业务

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

OURTED_ERROR

SER_MOBILE_NOT_

用户手机号不匹配

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

ME ATCH_ERROR

RROR_RIST_CTU_RE

操作存在风险，被CTU拒绝

一致

确认用户的具体操作风险

FUUSE

SER_NOT_EXIST_ER

用户信息不存在

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

RUOSRR_ACCOUNT_NOT

E

用户账户信息不存在

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

_EXIST


存在

SLECURITY_CHECK_FAI

操作存在风险

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

VESADLIDATECODE_EXPIR

IGN_USER_ID_NOT_

校验码超时

签约账号不匹配

校验码超时，请重新获取

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

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

用间HH，:m格m式:s为s。yy付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为:sysy。yy用-M以M唯-dd

付 宝 系 统 中 一 标 识 用

2017050200061075599

zm_open_id

String

是

64

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

pen

2688160573524613135

8

alipay_logon_id

String

是

100

户查询用户芝麻信用使用

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

38942792

xxxx***xxx@xxxxxx.xxx


notify_type


String


是


100

要号返，需要用户在签约页面上授账

权

用户签约成功通知类型


dut_user_sign

zm_score

String

是

20

用户支付宝芝麻分

700

login_token

String

是

1000

用户登录token，目前用于集

7ff7664d45c4afe8dcca

device_id

String

是

256

团的信任登录设备Id

b8f224af9379_07 RSED235F875932







参 数 类 型


触发通知示例

xxxxx://xxx.xxxxxxxx.xxx/xxxxxxx_xxxxxx.xxx?xxxxxx_xxx00000xxxx000x0xxx00x0x

2Na1b:f446d:e1a5d&L6sJiibgen&_tnyop9teif=yR_StiAm2e&=s2ig0n1=7W-0c2O-1+6t3PDkn8KezgA7l1wdmTlvKPwdNn7Qru9IP0z1UHOZXsZeaFB9VJ1wi6pg8g/FZOjBuiSAxdc5ulGS8kbXsZotTVxYZxBOpJs8A7iudbp2riy9SGCujHJ3CNjmr/aNgUl

c191cVjoe9KY:=J&Qinav2ai8li/dA_stlim3jeo=T2W03197F-0X56-i2007l1X1h:n49b:1899&3s0i&gsnt_astcuesn=eN=OINRDMUASL&TRfoYr|eCxA_ReRliENbTleA=LT&&siegxnt_etrinmael_=l2o0g1o7n-_0i5d-=2103852852877&a

=pGp:_E4iNdE=1290&1L7_l0p6a0y1_0x0x0x0x0_9id3=92&0a8u8t1h0_1a1p4p3_4i8de==220011770-60051-0000000000&external_agreement_no=test&personal_product_code

e1s1t:4**9*:1aR9liA&@aagWripeIeTmHHeenOtL_DnIoN=G2f_0P1&70v5a0li2d0_0ti0m610755993&zm_open_id=268816057852461313538942792&alipay_logon_id=t

07&device_ild=aRyS.nEDt2&3n5oFt8i7y5_9t3y2pe=dut_user_sign&zm_score=700&login_token=7ff7664d45c4afe8dccab8f224af9379_

Document Metadata

Filed: June 17th, 2019