第三方系统根据此接口定义实现支付成功回调接口,并暴露成服务。
此接口用于预付订单用户支付成功后通知第三方系统,仅通知一次(超时原因会重试3次),如果第三方系统因为各种原因未收到回调数据(比如:第三方服务重启),可以在预留支付时间(30分钟)后使用top查询订单。
请求参数
名称 |
类型 |
是否必须 |
最大长度/取值范围 |
描述 |
示例值 |
Username |
String |
100 |
第三方系统接口调用需要校验时的用户名。 |
taobao |
|
Password |
String |
100 |
第三方系统接口调用需要校验时的密码 |
taobao |
|
CreateToken |
String |
必须 |
255 |
单次请求token |
taobao1387784033263-1387784033266 |
OrderId |
String |
|
100 |
OTA订单id,即第三方系统中的订单id |
21544874 |
TaoBaoOrderId |
long |
必须 |
|
taobao订单id |
524148745 |
AlipayTradeNo |
String |
必须 |
|
支付宝交易号,28位字符 |
2013123111001001020000378012 |
Payment |
long |
必须 |
|
支付金额(单位:分) |
10000 |
XML示例:
?xml version="1.0" encoding="UTF-8" standalone="yes"?> <PaySuccessRQ> <AuthenticationToken> <Username>taobao</Username> <Password>taobao</Password> <CreateToken>taobao1230123213-1387792484913</CreateToken> </AuthenticationToken> <OrderId>12321323</OrderId> <TaoBaoOrderId>1230123213</TaoBaoOrderId> <AlipayTradeNo>2013123111001001020000378012</AlipayTradeNo > <Payment>10000</Payment> </PaySuccessRQ> |
名称 |
类型 |
是否必须 |
限制范围 |
描述 |
示例值 |
Message |
String |
否 |
300 |
空 |
|
ResultCode |
String |
是 |
取值:0,-400 |
错误码 0表示成功 |
0 |
XML示例:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Result> <Message></Message> <ResultCode>0</ResultCode> </Result> |
返回结果(失败)
名称 |
类型 |
是否必须 |
限制范围 |
描述 |
示例值 |
Message |
String |
必须 |
300 |
错误原因 |
内部错误 |
ResultCode |
String |
必须 |
取值:0,-400 |
错误码 |
-400 |
XML示例:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Result> <Message>内部错误</Message> <ResultCode>-400</ResultCode> </Result> |
以下是第三方接到支付成功请求后,处理成功或失败时应该返回的结果。此表已定义结果类型不会修改,但可能会根据业务情况进行增补。
ResultCode |
Message |
备注 |
0 |
处理成功 |
|
-400 |
处理失败 |
|