一、应用场景

前端系统主动发起单笔短信代扣提交,DSP根据入参的收方、付方信息、短信验证码等信息,发送渠道方进行代扣,并将交易状态返回给前端系统。

二、请求报文

2.1 公共请求参数

参数 中文名称 是否必填 示例值 描述
BankCode 线路代码 ALIPAY01 渠道代码
TransType 交易类型 9110 接口名称,固定为 “9110”
CommandCode 线路指令 911001 固定为”911001”
TransSeqID 指令流水号 030441109 指令流水号,全局唯一
TransTime 指令时间 2021-07-27 15:04:41 指令时间,格式:yyyy-MM-dd HH:mm:ss

2.2 请求参数

参数 中文名称 是否必填 示例值 描述
PayAct 付方账号 79102100603450000018
PayName 付方名称 名侦探悟空
PayBankCode 付方银行代码 102 银行大类代码
PayBankName 付方银行名称 昆仑银行股份有限公司 银行大类名称
PayBnk 付方开户行 昆仑银行股份有限公司
PayArea 付方区域代码 6502
PayAreaName 付方区域名称 新疆维吾尔自治区_克拉玛依市
RecAct 收方账号 6217661145901883428
RecName 收方名称 姬俞
RecBankCode 收方银行代码 102 银行大类代码
RecBankName 收方银行名称 昆仑银行股份有限公司 银行大类名称
RecBnk 收方开户行 昆仑银行股份有限公司
RecArea 收方区域代码 6502
RecAreaName 收方区域名称 新疆维吾尔自治区_克拉玛依市
SameBnk 是否同行 1 枚举:1-同行,0-跨行
SameCity 是否同城 1 枚举:1-同城,0-异地
PayDate 交易日期 2019-08-07 格式:yyyy-MM-dd
PayTime 交易时间 15:30:13 格式:HH:mm:ss
PayAmount 交易金额 667.00 单位为元,保留小数点后两位
PayCur 付方币种 1 标准币种
RecCur 收方币种 1 标准币种
Usage 用途
ReqSeqID 支付流水号 29080702394102
PostScript 对账码 39080701145385
Memo 备注
IsPrivate 对公对私标识 枚举:1-对私,0/2-对公
CNAPSCode 联行号 313882000012
CNAPSName 联行名 昆仑银行股份有限公司
SourceNoteCode 保单号
CertType 证件类型 1 标准证件类型
CertNum 证件号 313882000012
CellPhone 手机号 15158040490
Step 步骤 01 固定为”01”,表示发送验证码
VerifyCode 验证码 341234 发送验证码步骤获取的验证码
Token 短信序号 1234 短信的唯一编号,有的渠道会返回

2.3 请求示例

  1. <ATSYH version="5.1.0.0">
  2. <TransReq>
  3. <BankCode>BFB01</BankCode>
  4. <Entity>5000001</Entity>
  5. <TransTime>2017-07-27 14:51:58</TransTime>
  6. <TransType>9110</TransType>
  7. <CommandCode>911001</CommandCode>
  8. <TransSeqID>1451589578</TransSeqID>
  9. <TransParam>
  10. <DetailRecord>
  11. <AuthAgNum></AuthAgNum>
  12. <VerifyCode>375779</VerifyCode>
  13. <Token></Token>
  14. <RecBnk>邦付宝</RecBnk>
  15. <PostScript>37072701276231</PostScript>
  16. <SubmitID>6002019</SubmitID>
  17. <RecAreaName/>
  18. <CardType>2</CardType>
  19. <RecAct>800010000050056</RecAct>
  20. <Memo/>
  21. <CertType>0</CertType>
  22. <PayBankCode/>
  23. <PayTime>18:41:58</PayTime>
  24. <CVV2/>
  25. <PayAct>6217002020021488838</PayAct>
  26. <CNAPSName>邦付宝</CNAPSName>
  27. <ReqSeqID>27072701067647</ReqSeqID>
  28. <RecArea/>
  29. <IsPrivate>1</IsPrivate>
  30. <RootPay>0</RootPay>
  31. <ReqReserved2/>
  32. <PayDate>2017-07-27</PayDate>
  33. <PayBankName/>
  34. <ReqReserved1/>
  35. <RecBankName>9021</RecBankName>
  36. <PayAmount>0.01</PayAmount>
  37. <SameCity>0</SameCity>
  38. <RecCur>1</RecCur>
  39. <RootRec>0</RootRec>
  40. <PayName>linda</PayName>
  41. <SameBnk>0</SameBnk>
  42. <InnerPay>0</InnerPay>
  43. <InnerPayType/>
  44. <PrimaryAct>0</PrimaryAct>
  45. <CertNum>360731199305174817</CertNum>
  46. <PaySpd/>
  47. <InnerBankAllot/>
  48. <PayArea/>
  49. <ValidDate/>
  50. <PayBnk/>
  51. <Usage>女神安</Usage>
  52. <CNAPSCode/>
  53. <PayAreaName/>
  54. <PayCur>1</PayCur>
  55. <RecName>安邦保险财产股份有限公司(付)</RecName>
  56. <Step>02</Step>
  57. <Mobile>18810295696</Mobile>
  58. </DetailRecord>
  59. </TransParam>
  60. </TransReq>
  61. </ATSYH>

三、响应报文

3.1 公共响应参数

参数 中文名称 是否必填 示例值 描述
BankCode 线路代码 ALIPAY01 渠道代码
TransType 交易类型 9110 固定为”9110”
TransSeqID 指令流水号 030441109 指令流水号,全局唯一

3.1 响应参数

参数 中文名称 是否必填 示例值 描述
RespCode 响应码 0 0:成功,-1:失败
RespInfo 响应信息 成功 响应信息描述
TransState 交易状态 M0001
PayInfoCode 支付信息码 M0001
ReqSeqID 支付流水号 28081001108487
OutTransID 渠道订单号 430810011084

3.2 响应示例

  1. <ATSYH>
  2. <TransResp>
  3. <BankCode>CMB01</BankCode>
  4. <TransType>9110</TransType>
  5. <TransSeqID>20180902142326439</TransSeqID>
  6. <TransParam>
  7. <DetailRecord>
  8. <RespCode>0</RespCode>
  9. <RespInfo />
  10. <TransState>BNK</TransState>
  11. <ReqSeqID>2000000000000003</ReqSeqID>
  12. <PayInfoCode>BNK</PayInfoCode>
  13. <Token>1234</Token>
  14. <TransAmt />
  15. <OutTransID />
  16. <NeedLimit />
  17. <FailType />
  18. </DetailRecord>
  19. </TransParam>
  20. </TransResp>
  21. </ATSYH>