参数sosos
sosos 时间:2021-03-02 阅读:()
ZhejiangKuaiShouInformationTechnologyLtd.
VersionHistoryVersionUpdatingDateEditorUpdatedcontent1.
0.
02016.
3.
15Guangmu,ZhangFirstdraft1.
0.
12016.
7.
15Guangmu,ZhangWeChatOfficialAccountspayment1.
0.
22016.
7.
18Yongchao,WangAdddetailsaboutstatisticsandbatchqueries,andmodifythedetailsofthedocument1.
1.
02016.
8.
5Yongchao,WangAddinformationaboutqueryinterface,refundinterfaceandthird-partyordernumberreturningCatalogue1.
Summary42.
UsingoftheAPI53.
QRcodepaymentprocedure(scannedbymerchants)74.
QRcodepaymentprocedure(scannedbyconsumers)95.
WeChatOfficialAccountspaymentprocedure126.
Asynchronousnotification147.
Refundinterface168.
Queryinterface179.
Revocationinterface1910.
Batchqueryinterface2011.
Paymentchannelinterface2112.
Authorityauthenticationinterface2213.
Appendix24Appendix1:Definitionofcommodityinformation24Appendix2:Paymentplatformsdatadictionary(Markedinredareunsupportedyet)24Appendix3:Paymentproductsdatadictionary25Appendix4:Orderstatusdictionary26Appendix5:Returncodedatadictionary27SummaryThisserviceisimplementedbasedonhttp/httpsUTF-8Characterset:UTF-8ShortlinkMessageformat:SupportJSONMessageencryption(notessential,butencryptionofHTTPprotocolcommunicationisrecommended)Messageencryptionissupported.
Itdependsonwhethertheparameter'encrypt'isempty.
Messageisnotencryptedwhenitisempty,otherwiseitwillbeencrypted.
Currently3DESencryptionissupported.
TheoriginalmessageisencryptedandencodedwithBASE64duringtheencryption.
Protocolentrancehttps:Productionenvironmentonhttps:https://www.
sssyin.
cn/openGateway/openService/http:Productionenvironmentonhttp:http://www.
sssyin.
cn/openGateway/openService/Testingenvironment:http://uat.
sssyin.
cn:9000/openGateway/openService/Protocolinvokinginclude:QRcodepaymentprocedure(scannedbyconsumers)QRcodepaymentprocedure(scannedbymerchants)Asynchronousnotification(Reverseinterface)ReturninterfaceTransactioninquiryRevocationinterfaceUsingoftheAPICreaterequestobjectrequestInSDK,itcontainsalltherequeststhatneedtobeused.
Justcreatetherequestsandsetthenecessaryparameterswhenitisused.
Hereisthecode:GetclientGetclientprovidesaunifiedfactoryclassthatdoesnotneedtobecreated:Whenyougettheclient,youneedtoimporttheclientthatinvokestheSDK.
IfitisaJAVAcall,youcanusethecodeabove.
Ifit'sanAndroidinvoking,youneedtoimport'false'Inaddition,thefactoryclassalsoprovidesthetransactionclientandWriteoffclientTransactionclientWhenyougettheclient,youneedtoimporttheclientthatinvokestheSDK.
IfitisaJAVAcall,youcanusethecodeabove.
Ifit'sanAndroidinvoking,youneedtoimport'false'WriteoffclientResponseExecutetherequestandgetthereturnresultToexecutetherequest,justinvoketheclient'sexecutemethod,hereisthecode:Theexecutionprocessmustcaptureandhandleexceptions.
Iftherequiredparametersarenotcomplete,therewillbeaerror.
ResultprocessingAftertheresponseisacquired,startbusinessprocessabouttheresult.
DeterminewhethertheresultissuccessfulornotQRcodepaymentprocedure(scannedbymerchants)DemonstrationInterfaceprofiles:request:com.
sosopay.
request.
SosopayTradePayRequestclient:SosopayAPIClientFactory.
getSosopayClient(参数…);response:com.
sosopay.
response.
SosopayTradePayResponseTimeoutaboutthisinterfaceis80seconds.
Ifthepaymentisnotcompletedwithin80seconds,thetransactionorderwillbecancelledautomatically.
Thepaymentchannelwillbeautomaticallyjudgedwithoutentryandwillbereturnedtothespecificpaymentchannelafterthepaymentissuccessful.
RequestparameterTable2.
3RequestingparameterParameterParameterNameTypeParameterDescriptionCanbeemptySampleBUSI_IDMerchantIDStringMerchantIDisassignedcentrallybySOUSHOUNo0010000001OPER_IDOperatorIDStringOperatorIDNooper01DEV_IDDevicenumberStringDevicenumberNodev01MERCHANTPARAUserparameterStringTheuserparameterisencodedusingbase64,andtheinterfacewillreturnitwithoutanymodification.
Yes01000001REGISTER_IDStorecodeStringStorecodeYes02016AMTThetransactionamountStringUnitisCNYNo158.
00DYNAMIC_IDDynamiccodeforclientsIntegerCustomer'sAlipayorWeChatwalletdynamiccode(obtainedbymerchantscanningcustomer'sQR/barcodecode)No284214903060794755CHARGE_CODETradingupserialnumberStringMerchantstradedupserialnumber(needtobeunique)No20150324001069125999PAY_SUBJECTPaymentdescriptionStringPaymentdescriptionNo20150324001069125999goodsInfosProductinformationdescriptionListFornodeinformation,pleaserefertoAppendix1,"commodityinformationdefinition""YesPleaserefertorequestsample2.
4ReturnmessageTable2.
5ReturningparameterforscannedinterfaceParametersParameterNameTypeParameterDescriptionSampleRESULTResponsecodeObjectResponsecodeoftheinterface.
Thesub-nodeofthenodeincluding:CODE:Returnedcode.
Pleaserefertoappendix5fordetailedinfo.
INFO:Returninformation.
Pleasereferto"2.
6Returningsample"fordetailedinfo.
CHANNEL_TYPEPaymentchannelIntegerPleaserefertoappendix2fordetailedinfo.
1CHARGE_CODETradingupserialnumberStringMerchanttradingupserialnumber20150324001069125999CHARGE_DOWN_CODETradingdownserialnumberStringTradingdownserialnumberfromSOUSHOU1435736619488CHARGE_THIRD_CODESerialnumberofpaychannelStringserialnumberofpaychannel(alipay,wechatpay.
.
.
)2088110245121545154MERCHANTPARAUserParameterStringTheuserparameterisencodedusingbase64,andtheinterfacewillreturnitwithoutanymodification.
01000001FUND_BILL_LISTPaymentchannelinformationListThepaymentchannelinformationforthistransactionanditcancontaintheinformationofthesubnodesformultiplechannels,i.
e.
TRADEFUNDBILL,theparametersincludedbythenodeare:AMOUNT:Thetradingamountwhichispaidviathespecifiedpaymentchannel,theunitisYuan.
FUND_CHANNEL:Paymentchannel,pleaserefertoappendix3fordetailedinfo.
Pleasereferto"2.
6Sampleforreturningmessage"OPER_IDOperatorIDStringOperatorIDoper01DEV_IDDevicenumberStringDevicenumberdev01BEGIN_TIMEThetransactiondateDateThetransactiondate2015-10-1404:43:14AMTThetransactionamountStringUnitiscent15800QRcodepaymentprocedure(scannedbyconsumers)DemonstrationInterfaceintroductionrequest:com.
sosopay.
request.
SosopayTradePrecreateRequestclient:SosopayAPIClientFactory.
getSosopayClient(Parameter…);response:com.
sosopay.
response.
SosopayTradePrecreateResponseRequestparameterlistTable3.
3RequestparameterParameterParameternameTypeParameterdescriptionCanbeemptySampleBUSI_IDMerchantIDStringMerchantIDisallocatedcentrallybySOUSHOUNo0010000001OPER_IDOperatorIDStringOperatorIDNoOperator01DEV_IDDevicenumberStringDevicenumberNoCashRegister01MERCHANTPARAUserparameterStringTheuserparameterisencodedusingbase64,andtheinterfacewillreturnitwithoutanymodification.
Yes01000001REGISTER_IDStorecodeStringStorecodeYes02016AMTThetransactionamountStringUnitisYuanNo158.
00CHANNEL_TYPEPaymentChannelIntegerPleaserefertoappendix2fordetailedinfo.
No1CHARGE_CODETradingupserialnumberStringMerchantstradedupserialnumber(needtobeunique)No20150324001069125999NODIFY_URLAsynchronousnotificationaddressStringTheaddressthatSOUSHOUcannotifythemerchantafterasuccessfulpayment.
1,_type:Requirementfortheformatofthereturningmessage:Jsonorxml,xmlisthedefaultformatwhenthisparameterisnotset.
2,encrypt:Currentlysupportsthe3DESencryptiontothecontentofthemessage.
Whentheparameterisempty,willnotdoanyencryption.
Yeshttp://221.
12.
11.
172:8081/sosopayweb/sosopaytest_type=json&encrypt=3DESPAY_SUBJECTPaymentdescriptionStringPaymentdescriptionNoQRCodetopaygoodsInfosProductinformationdescriptionListFornodeinformation,pleaserefertoAppendix1,"commodityinformationdefinition""YesPleaserefertorequestsample2.
4ReturnparameterTable3.
5ReturningparameterforscanninginterfaceParameterParameternameTypeParameterDescriptionSampleRESULTResponsecodeObjectThesub-nodeincluding:CODE:Responsecode,pleaserefertoappendix5fordetailedinfo.
INFO:ReturnmessagePleaserefertothesampleinsection3.
6fordetailedinfo.
CHARGE_DOWN_CODETradingdownserialnumberStringThetransactionserialnumberreturnedbySOUSHOU1435736619488CHARGE_CODETradingserialnumberStringMerchantstradedupserialnumber(needtobeunique)20150324001069125999MERCHANTPARAUserparametersStringUserparameterisencodedbybase64andtheinterfacereturnthedataasreturned.
01000001BAR_CODEPaymentlinksStringUsedtogeneratetheQRcodeofthepayment(alipay,WeChatpay),orthepaymentlinkofotherbankpayments.
https://qr.
alipay.
com/baidecagzveqxn6oe7WeChatOfficialAccountspaymentprocedureInterfaceintroductionrequest:com.
sosopay.
request.
SosopayTradePrecreateRequestclient:SosopayAPIClientFactory.
getSosopayClient(参数…);response:com.
sosopay.
response.
SosopayTradePrecreateResponseRequestparametertableTable4.
2RequestingparameterforinterfaceParameterParameternameTypeParameterDescriptionCanbeemptySampleBUSI_IDMerchantIDStringMerchantIDisallocatedcentrallybySOUSHOUNo0010000001OPER_IDOperatorIDStringOperatorIDNoOperator01DEV_IDDevicenumberStringDevicenumberNoCashRegister01MERCHANTPARAUserparameterStringTheuserparameterisencodedusingbase64,andtheinterfacewillreturnitwithoutanymodification.
Yes01000001REGISTER_IDStorecodeStringStorecodeYes02016AMTThetransactionamountStringUnitisYuanNo158.
00CHANNEL_TYPEPaymentChannelIntegerPleaserefertoappendix2fordetailedinfo.
No1TRADE_TYPEPaytypeStringvalues:JSAPI,NATIVE,APPDefaultisNATIVEYesJSAPIsubAppidTheappidofSubmerchantStringTheappidofSubmerchantdistributedbyWeChat,thisparamisrequiredwhenyouneedobtainsub_openidafterpaymentcompletionYeswx8888888888888888subOpenidSubopenidundersubappidStringIftrade_type==JSAPI,thisparametercan'tbeempty,itisuniquelyidentifyunderthesub-merchantappidforuserYesCHARGE_CODETradingserialnumberStringMerchantstradedupserialnumber(needtobeunique)No20150324001069125999NODIFY_URLAsynchronousnotificationaddressStringTheaddressthatSOUSHOUcannotifythemerchantafterasuccessfulpayment.
1,_type:Requirementfortheformatofthereturningmessage:Jsonorxml,xmlisthedefaultformatwhenthisparameterisnotset.
2,encrypt:Currentlysupportsthe3DESencryptiontothecontentofthemessage.
Whentheparameterisempty,willnotdoanyencryption.
Yeshttp://221.
12.
11.
172:8081/sosopayweb/sosopaytest_type=json&encrypt=3DESPAY_SUBJECTPaymentdescriptionStringPaymentdescriptionNoQRCodetopayGOODS_DETAILProductinformationdescriptionListThedescriptionfortheproductwhichcancontainmultipleitems.
Fornodeinformation,pleaserefertotheappendix1fordetailedinfo.
YesPleasereferto"4.
3Sampleforrequestingmessage"fordetailedinfo.
ReturnparameterTable3.
5returnsparametersParameterParameternameTypeParameterDescriptionCanbeemptySampleRESULTResponsecodeObjectXmlnodenodesincludeCODE:returncode.
PleaserefertoAppendix5fordetailsINFO:returnmessageNoPleaserefertothereturnexampleCHARGE_DOWN_CODETradingdownserialnumberStringTransactionserialnumberreturnedfromKuaishouNo1435736619488CHARGE_CODETradingupserialnumberStringMerchantstradedupserialnumber(needtobeunique)No20150324001069125999CHARGE_THIRD_CODEChannelsserialnumberStringserialnumberofpaychannel(alipay,Wechatpay.
.
.
)No2016071521001004510282746866MERCHANTPARAUserParameterStringTheuserparameterisencodedusingbase64,andtheinterfacewillreturnitwithoutanymodification.
Yes01000001appIdWechatofficialaccountidStringServiceproviderAPPIDNotimeStamptimestampStringtimestampNononceStrRandomstringStringRandomstringNopackageDataOrderdetailsextensionstringStringOrderdetailsextensionstringNosignTypesignStringsignNosignsignStringsignNoAsynchronousnotificationInterfaceintroductionTheasynchronousinterfaceisapplicableforreturningpaymentresultwhencustomerscanningmerchant'sQRcode/barcodeforpayment.
URL:Merchant'saddressforreceivingtheasynchronousnotification_type=json&encrypt=3DES&sign={sign}InvocationMode:POSTTheasynchronousnotificationwillstopwhentheresponsecodeofthehttprequestis200,otherwisewillkeepqueryingthenotificationinterfacefor30timesper5seconds.
Formatfornotificationmessage:according'_type'parametertodetermine:ifitisnotspecified,thendefaultformatisxml,andifitissetas"json",thenthereturningmessagewillbeinjsonformat.
Whethertoencryptthereturningmessage:according'encrypt'todetermine,ifitisempty,thennoencryptionisapplied.
Currently,3DESencryptionissupported.
NotificationparametersTable4.
2ParametersforasynchronousinterfaceParameterParameternameTypeParameterdescriptionCanbeemptySampleBUSI_IDMerchantIDStringMerchantIDisassignedbySOUSHOUNo0010000001OPER_IDOperatorIDStringOperatorIDNoCashregister01DEV_IDDevicenumberStringDevicenumberNoCashregister01AMTTradingamountStringUnitisCentNo15800CHANNEL_TYPEPaymentchannelIntegerPleaserefertoappendix2fordetailedinfo.
No1CHARGE_CODETradingserialnumberStringMerchantstradingupserialnumber(needtobeunique)No20150324001069125999CHARGE_DOWN_CODETradingdownserialnumberStringTradingdownserialnumberreturnedbySOUSHOUNo1435736619488CHARGE_THIRD_CODESerialnumberofpaychannelStringserialnumberofpaychannel(alipay,wechatpay.
.
.
)No2016071521001004510282746866PAY_SUBJECTDescriptionforpaymentinformationStringDescriptionforpaymentinformationNoQRcodeproductsGOODS_DETAILProductdetailsListTheproductinformationwhichcancontainmultipleproducts.
Fornodeinformation,pleaserefertoappendix1fordetailedinfo.
YesPleasereferto4.
3forsample.
STATEOrderstatusIntegerPleaserefertoappendix4fordetailedinfo.
No1MERCHANTPARAUserparameterStringTheuserparameterisencodedusingbase64,andtheinterfacewillreturnitwithoutanymodification.
Yes01000001FUND_BILL_LISTInformationforPaymentchannelListThepaymentchannelinformationforthistransaction,anditcancontaintheinformationofthesub-node()formultiplechannels,theparametersincludedbythenodeare:AMOUNT:Thetradingamountwhichispaidviathespecifiedpaymentchannel,andtheunitisYuan.
FUND_CHANNEL:Paymentchannel,pleaserefertoappendix3fordetailedinfo.
NoPleasereferto4.
3forsampleNotificationmessagesampleJSONformat{"PAY_NODIFY":{"BUSI_ID":"0010000001","CHARGE_CODE":"1C88FADB-75D2-4517-9C38-F273D423FFF3","CHARGE_DOWN_CODE":"20151123100000095182","CHANNEL_TYPE":1,"STATE":1,"AMT":1,"OPER_ID":"TEST1","PAY_SUBJECT":"嗖嗖产品1","FUND_BILL_LIST":{"TRADEFUNDBILL":[{"FUND_CHANNEL":"10","AMOUNT":"0.
01"}]},"DEV_ID":"QQQQ","MERCHANTPARA":"111111111111111111111111"}}Notificationreturnmessage(notification,returnSUCCESS,stopnotification)RefundinterfaceInterfaceintroductionrequest:com.
sosopay.
request.
SosopayTradeRefundRequestclient:SosopayAPIClientFactory.
getSosopayClient(parameter…);response:com.
sosopay.
response.
SosopayTradeRefundResponserequestparameterTable6.
2RequestingparametersforrefundinterfaceParameterParameternameTypeParameterdescriptionCanbeemptySampleBUSI_IDMerchantIDStringMerchantIDisassignedbySOUSHOUNo0010000001OPER_IDOperatorIDStringOperatorIDNooper01DEV_IDDevicenumberStringDevicenumberNodev01CHARGE_REFUND_FEEAmountoftherefundStringTherefundamountcannotbegreaterthantheprincipalamount.
TheunitisYuan.
No158.
00REFUND_SUBJECTDescriptionforrefundStringDescriptionforrefundNoMerchantrefundsCHARGE_CODETradingupserialnumberStringTradingupserialnumber(needtobeunique)No20150324001069125999CHARGE_DOWN_CODETradingdownserialnumberStringThetradingdownserialnumberretunedbySOUSHOU(eithertradinguportradingdownserialnumberwillbeleveraged.
Andthetradingdownserialnumberwilltakeprioritywhenbothnumbersareavailable.
)Yes1435736619488OUT_REFUND_NOSerialnumberforrefundingStringMerchantrefundserialnumber(needtobeunique)Yes20150324001069125999ReturnParameterTable5.
4rerurnparameterParameterParameternameTypeParameterdescriptionCanbeemptySampleRESULTResponsecodeStringXmlnodenodesincludeCODE:returncode.
PleaserefertoAppendix5fordetailsINFO:returnmessageNOPleaserefertothereturnexample5.
5AMTTransactionamountStringIn0.
01yuanNO15800CHARGE_CODETransactionserialnumberStringTradingupserialnumber(needtobeunique)NO20150324001069125999CHARGE_DOWN_CODETradingdownserialnumberStringDownserialnumberwillbereturnedfromKuaishouNO1435736619488CHARGE_THIRD_CODEChannelserialnumberStringSerialnumberofpaychannel(alipay,wechatpay.
.
.
)NO2016071521001004510282746866FUND_BILL_LISTRefundchannelListThepaymentchannelinformationforthistransactioninXMLformatanditcancontaintheinformationofthesubnodesformultiplechannels,i.
e.
TRADEFUNDBILL,theparametersincludedbythenodeare:AMOUNT:Thetradingamountwhichispaidviathespecifiedpaymentchannel,theunitisYuan.
FUND_CHANNEL:Paymentchannel,pleaserefertoappendix3fordetailedinfo.
NOPleaserefertothereturnexample5.
5CHANNEL_TYPEPaymentchannelStringPleaserefertoappendix2PaymentchanneldictionaryNO1QueryinterfaceInterfaceintroductionrequest:com.
sosopay.
request.
SosopayTradeQueryRequestclient:SosopayAPIClientFactory.
getSosopayClient(parameter…);response:com.
sosopay.
response.
SosopayTradeQueryResponseSerialnumberCHARGE_CODEwhenclassserType=0oritisnullvalueitisthemerchantsserialnumber,ifserType=1,itisKuaishouserialnumber.
ReturnprarameterTable7.
2QueryinterfacereturnsparametersParametersParameterNameTypeParameterDescriptionCanbeemptySampleRESULTResponsecodeObjectTheXmlnodesubnodesareincluded*CODE:returncode.
PleaserefertoAppendix5fordetails*INFO:returnmessageNOPleaserefertothesampleBUSI_IDMerchantIDStringThemerchantIDisassignedbyKuaishouNO0010000001OPER_IDOperatorIDStringOperatorIDNOCashier01DEV_IDDeviceIDStringDeviceIDNOCashier01MERCHANTPARAUserparameterStringUserparametersareencodedbyBase64,andtheinterfacereturnsaswithoutmodificationYes01000001AMTTransactionamountStringIn0.
01yuanNO15800CHANNEL_TYPEPaymentchannelsStringPleaserefertoAppendix2,paymentchanneldictionary"NO1CHARGE_CODETradingserialnumberStringMerchanttransactionuplinkserialnumberNO20150324001069125999CHARGE_DOWN_CODEDownlinktransactionserialnumberStringDownlinkserialnumberwillbereturnedfromKuaishouNO1435736619488CHARGE_THIRD_CODEChannelserialnumberStringSerialnumberofpaychannel(alipay,wechatpay.
.
.
)NO2016071521001004510282746866PAY_SUBJECTPaymentinformationdescriptionStringPaymentinformationdescriptionNOQRcodeproductpaymentSTATEOrderstatusStringPleaserefertoAppendix4,"orderstatusdictionary""NO1GOODS_DETAILProductdetailsListThetransactiondescriptioncontainsseveralkindsofcommodity.
Fornodeinformation,pleaserefertoAppendix1,"commodityinformationdefinition"".
YesPleaserefertothesampleBEGIN_TIMETransactionstarttimeDateTransactionstarttimeNO2015-10-1404:43:14END_TIMETransactionendtimeDateTransactionendtimeYes2015-10-1404:43:14REGISTER_IDStorenumberStringStorenumberYes02016DYNAMIC_IDDynamiccodeofpayerStringCustomer'sAlipayorWeChatwalletdynamiccode(obtainedbymerchantscanningcustomer'sQR/barcodecode)NO284214903060794755FUND_BILL_LISTPaymentchannelinformationListThepaymentchannelinformationforthistransactioninXMLformatanditcancontaintheinformationofthesubnodesformultiplechannels,i.
e.
TRADEFUNDBILL,theparametersincludedbythenodeare:AMOUNT:Thetradingamountwhichispaidviathespecifiedpaymentchannel,theunitisYuan.
FUND_CHANNEL:Paymentchannel,pleaserefertoappendix3fordetailedinfo.
NOPleaserefertothesamplerevocationinterfaceInterfaceIntroductionrequest:com.
sosopay.
request.
SosopayTradeCancelRequestclient:SosopayAPIClientFactory.
getSosopayClient(parameter…);response:com.
sosopay.
response.
SosopayTradeCancelResponseIfparameteropTypeisnullornotACOrevocationwillbestartedinrealtime,WhenopType=ACOrevocationwillbesubmitted.
Table8.
2ThereturningparameterforrevokinginterfaceParameterParameternameTypeParameterdescriptionSampleRESULTResponsecodeObjectThesub-nodeincluding:CODE:Returningcode,pleaserefertoappendix5fordetailedinfo.
INFO:Returningmessage1BatchqueryinterfaceInterfaceintroductionrequest:com.
sosopay.
request.
SosopayTradeBatchQueryRequestclient:SosopayAPIClientFactory.
getSosopayClient(parameter…);response:com.
sosopay.
response.
SosopayTradeBatchQueryResponseRequestparameterParameterParameternameTypeParameterdescriptionCanbeemptySample_typeResponseformatStringReturndataformat:JSONindefaultNOjsonstateOrderstatusIntegerOrderstatus,pleaserefertoAppendix4(forallstatusdatawhenempty)Yes1beginDateStarttimeStringQuerystartdateformat:YYYY-MM-DDYes2016-01-01endDateEndtimeStringQueryenddateformat:YYYY-MM-DDYes2016-01-31busiCodeMerchantIDStringNO0010000001userIdOperatorIDStringOperatoraccountwhichiscurrentlyusedtologinthePCYestestChannelTypePaymentchannelIntegerPleaserefertoappendix2YesPageNumpageIntegerPagenumberNO1pageSizeRecordsperpageIntegerRecordsperpageNO10ChargeCodeMerchantordernumberStringUplinkordernumberYesReturnParameterParameterParameternameTypeParameterdescriptionCanbeemptySampleRESULTResponsecodeObjectXmlnodenodesincludeCODE:returncode.
PleaserefertoAppendix5fordetailsINFO:returnmessageNOPleaserefertothesamplechargesSizeOrderquantityIntegerReturnedOrderquantityNO1tradeInfosOrderlistListReturnedOrderlistYesPaymentchannelinterfaceInterfaceintroductionrequest:com.
sosopay.
request.
SosopayChannelRequestclient:SosopayAPIClientFactory.
getSosopayClient(parameter…);response:com.
sosopay.
response.
SosopayChannelResponseReturnparameterTable7.
2revocationinterfaceReturnparameterParameterParameternameTypeParameterdescriptionCanbeemptySampleRESULTResponsecodeObjectXmlnodenodesincludeCODE:returncode.
PleaserefertoAppendix5fordetailsINFO:returnmessageNOPleaserefertothereturmsample2.
2"PAY_CHANNEL_LISTPaymentchannelListTheKuaishoucashier'spaymentchannelinformationcontainsmultiplechannelinformationsub-nodes3xmlreturnexample"ForJSONreturnformatSee"8.
4jsonreturnsample"PermissionauthenticationInterfaceintroductionrequest:com.
sosopay.
request.
SosoauthRequestclient:SosopayAPIClientFactory.
getSosopayClient(parameter…);response:com.
sosopay.
response.
SosoauthResponseTable9.
1PermissionauthenticationinputparameterParameterParameternameTypeParameterdescriptionCanbeemptySampleusernameusernameStringUsernameonmobileAPP.
TheusernameforthePOSdeviceistheassigneddevicenumberNOpasswordpasswordStringpasswordNObusiCodeMerchantIDStringProvideMerchantIDtotheuserYes返回参数ReturnParameterTable9.
2PermissionauthenticationinterfacereturnsparametersParameterParameternameTypeParameterdescriptionCanbeemptySamplesuccessResponsecodeStringtrue:Authenticationissuccessfulfalse:AuthenticationisfailedNOPleaserefertothesamplemessageFailedmassageStringErrormessageisreturnedafterfailureYesAccount/passworderroruseruserObjectUserinformarionYesidDevideIDStringUserIDYes1companyIdMerchantIDStringYesloginNameLoginnameStringYesnameusernameStringYesuserTypeUsertypeString1:Norefundpermission2:WithrefundpermissionYes2loginDateLatestlogindateString2015-11-0214:28:36YesloginFlagForbidornotString0:Logindisabled1:LoginavailableYesPleaserefertothesampledelFlagDeleteornotString0:Available1:DeteledYesPleaserefertothesampleIMEIDeviceserialnumberStringYesteTypeTerminalsoftwareversionString1AndroidYesappVerTerminalsoftwareversionnumberStringYesloginStatusOnlinestatus0:Offline1:OnlineYescompanyMerchantsObjectYesidMerchantIDYesnameMerchantnameYescodeMerchantcodeAfterthecertificationispassed,theordermerchantcodeneedstobecheckedagainwiththisparameter,andthesamemerchantcanberefundedYesuseableMerchantstatus0Onbehalfoftheaudit1Auditpassed2auditfailedYesdelFlagWhethermerchantisdeleted0:Available1:DeletedYesamountLimitTransactionlimitYesrefundAtSceneWhetherrefundsite0:Yes,1:NoYeschargeModeTradingmode1Offlinepayments2cashierYesprofitrateYestimeLimitTimeoutlimit(minute)YesisUploadGoodsWhetherUploadcommodityinformation0don'tupload1UploadYesprivateUrlMerchantURLYesReturnexampleFormat:JSONAppendixAppendix1DefinitionoftheProductInformationTable8.
1ProductinformationGOODS_DETAILParameterParameternameTypeParameterDescriptionCanbeemptySampleGOOD_IDProductIDStringProductIDNo2010GOOD_NAMEProductnameStringProductnameNoIPhoneGOOD_CLASSClassificationofproductsStringDevicecodeNoMobilephoneGOOD_PRICEAmountoftheproductStringUnitisYuanNo4999.
00GOOD_SUBJECTProductdescriptionStringPleaserefertoappendix2fordetailedinfo.
NoDigitalproductsGOOD_QUANTITYThenumberofproductsStringNeedtobeuniqueNo1GOOD_SHOWURLExhibitionaddressfortheproductStringTheaddressofthegoodsYeswww.
sssyin.
cnAppendix2PaymentChannelDataDictionary(Itemswhicharemarkedinredarenotsupportedyet)Table8.
2CHANNEL_TYPECodeofpaymentcodePaymentchannel0whenCustomer'sQRcodeisscannedbymerchanttopay,wewillautomaticdeterminationchannelsifset0.
1Alipay2WeChatpay3ChinaMerchantsBank4ICBC5CCB6BankofCommunications7EverbrightBankofChina8HuaxiaBank9AgriculturalBank10ShanghaiPudongDevelopmentBank11MinshengBankofChina12IndustrialBank13BankofChina14CITICBank15ChinaGuangfaBank16PingAnBank17Reserved18ShenzhenDevelopmentBank19HSBC20BankofEastAsia21HangSengBank22Citibank23StandardCharteredBank24BaiduWallet25ChinaMobileHeBaowallet26Unicompays27ChinaTelecomYipayment28MiWallet29ApplePay30SamsungPay31QQWalletAppendix3PaymentChannelDataDictionaryTable8.
3PaymentchannelsFUND_BILL_LISTCodeofpaymentchannelPaymentchannel00Alipaybonus10Alipaybalance60Alipayprepaidcard30AlipayJiFenbao70PaymentbyAlipaycredit40Discountvouchers80Prepaidcard90CreditPayment(consumerloan)11WeChatPay41PaymentbyWeChatcashcoupon12QQWalletpay42QQWalletcashcouponpay100Alipayfinancialaccounts101Merchantstorecard102Merchantcoupons103Bankcard(viaAlipay)104Merchantbonus9001Bankcard(viaBank,includingdebitandcreditcards)9002Randomdiscount9003Free9004Applycorrespondingdiscountwhentransactionamountmeetthepre-setdiscountingamountbythemerchantAppendix4OrderStatusDictionaryTable8.
4OrderStateOrderstatusDescription0Pendingpayment1Paid2Revoked3Applicationforrevocation4Partialrefund5Refunded6Transactionclosed8Refunding(Platformdidnotreturnaresultofrefund)9Refundfailed10Toberefunded(checktherefundwhenthecorrespondingmerchantserialnumberOUT_REFUND_Nreturntothestate)11Refundsuccessful(queryrefundwhenthecorrespondingbusinessintotheserialnumberOUT_REFUND_N,returntothestate)12RefundCanceled(checkrefundtimetoreturntothecorrespondingbusinessserialnumberOUT_REFUND_Nreturntothestate)13Refundfailed(checktherefundwhenthecorrespondingmerchantserialnumberOUT_REFUND_Nreturntothestate)14Canceltheorderofsuccess(checktherefundwhenthecorrespondingmerchantserialnumberOUT_REFUND_Nreturntothestate)Appendix5ReturnCodeDataDictionaryTable9.
5ReturncodeReturncodeDescriptionSUCESSSuccessFAILFailILLEGAL_PARAMETERParametererrorINVALID_SIGNSignatureerrorAMT_ERRORAmounterrorDATABASE_ERRORDatabaseconnectionexceptionINVALID_CONTRACTInvalidcontractstatusUNREGISTERED_BUSIUnregisteredmerchantEXCEPTIONUnknownexceptionCHARGE_NONEXISTENTThetransactiondoesnotexistSERVICE_UNAVAILABLEServiceisnotavailableHTTP_EXCEPTIONHTTPrequestingexceptionIO_EXCEPTIONIOexceptionCREATE_SECURITY_CONNECTION_ERRORFailedtocreatesecurelinks!
AREADY_REVOKEDTheorderhasbeenrevokedSERIAL_REPEATTheserialnumberisduplicatedwiththeexistingrecordinthesystem.
VersionHistoryVersionUpdatingDateEditorUpdatedcontent1.
0.
02016.
3.
15Guangmu,ZhangFirstdraft1.
0.
12016.
7.
15Guangmu,ZhangWeChatOfficialAccountspayment1.
0.
22016.
7.
18Yongchao,WangAdddetailsaboutstatisticsandbatchqueries,andmodifythedetailsofthedocument1.
1.
02016.
8.
5Yongchao,WangAddinformationaboutqueryinterface,refundinterfaceandthird-partyordernumberreturningCatalogue1.
Summary42.
UsingoftheAPI53.
QRcodepaymentprocedure(scannedbymerchants)74.
QRcodepaymentprocedure(scannedbyconsumers)95.
WeChatOfficialAccountspaymentprocedure126.
Asynchronousnotification147.
Refundinterface168.
Queryinterface179.
Revocationinterface1910.
Batchqueryinterface2011.
Paymentchannelinterface2112.
Authorityauthenticationinterface2213.
Appendix24Appendix1:Definitionofcommodityinformation24Appendix2:Paymentplatformsdatadictionary(Markedinredareunsupportedyet)24Appendix3:Paymentproductsdatadictionary25Appendix4:Orderstatusdictionary26Appendix5:Returncodedatadictionary27SummaryThisserviceisimplementedbasedonhttp/httpsUTF-8Characterset:UTF-8ShortlinkMessageformat:SupportJSONMessageencryption(notessential,butencryptionofHTTPprotocolcommunicationisrecommended)Messageencryptionissupported.
Itdependsonwhethertheparameter'encrypt'isempty.
Messageisnotencryptedwhenitisempty,otherwiseitwillbeencrypted.
Currently3DESencryptionissupported.
TheoriginalmessageisencryptedandencodedwithBASE64duringtheencryption.
Protocolentrancehttps:Productionenvironmentonhttps:https://www.
sssyin.
cn/openGateway/openService/http:Productionenvironmentonhttp:http://www.
sssyin.
cn/openGateway/openService/Testingenvironment:http://uat.
sssyin.
cn:9000/openGateway/openService/Protocolinvokinginclude:QRcodepaymentprocedure(scannedbyconsumers)QRcodepaymentprocedure(scannedbymerchants)Asynchronousnotification(Reverseinterface)ReturninterfaceTransactioninquiryRevocationinterfaceUsingoftheAPICreaterequestobjectrequestInSDK,itcontainsalltherequeststhatneedtobeused.
Justcreatetherequestsandsetthenecessaryparameterswhenitisused.
Hereisthecode:GetclientGetclientprovidesaunifiedfactoryclassthatdoesnotneedtobecreated:Whenyougettheclient,youneedtoimporttheclientthatinvokestheSDK.
IfitisaJAVAcall,youcanusethecodeabove.
Ifit'sanAndroidinvoking,youneedtoimport'false'Inaddition,thefactoryclassalsoprovidesthetransactionclientandWriteoffclientTransactionclientWhenyougettheclient,youneedtoimporttheclientthatinvokestheSDK.
IfitisaJAVAcall,youcanusethecodeabove.
Ifit'sanAndroidinvoking,youneedtoimport'false'WriteoffclientResponseExecutetherequestandgetthereturnresultToexecutetherequest,justinvoketheclient'sexecutemethod,hereisthecode:Theexecutionprocessmustcaptureandhandleexceptions.
Iftherequiredparametersarenotcomplete,therewillbeaerror.
ResultprocessingAftertheresponseisacquired,startbusinessprocessabouttheresult.
DeterminewhethertheresultissuccessfulornotQRcodepaymentprocedure(scannedbymerchants)DemonstrationInterfaceprofiles:request:com.
sosopay.
request.
SosopayTradePayRequestclient:SosopayAPIClientFactory.
getSosopayClient(参数…);response:com.
sosopay.
response.
SosopayTradePayResponseTimeoutaboutthisinterfaceis80seconds.
Ifthepaymentisnotcompletedwithin80seconds,thetransactionorderwillbecancelledautomatically.
Thepaymentchannelwillbeautomaticallyjudgedwithoutentryandwillbereturnedtothespecificpaymentchannelafterthepaymentissuccessful.
RequestparameterTable2.
3RequestingparameterParameterParameterNameTypeParameterDescriptionCanbeemptySampleBUSI_IDMerchantIDStringMerchantIDisassignedcentrallybySOUSHOUNo0010000001OPER_IDOperatorIDStringOperatorIDNooper01DEV_IDDevicenumberStringDevicenumberNodev01MERCHANTPARAUserparameterStringTheuserparameterisencodedusingbase64,andtheinterfacewillreturnitwithoutanymodification.
Yes01000001REGISTER_IDStorecodeStringStorecodeYes02016AMTThetransactionamountStringUnitisCNYNo158.
00DYNAMIC_IDDynamiccodeforclientsIntegerCustomer'sAlipayorWeChatwalletdynamiccode(obtainedbymerchantscanningcustomer'sQR/barcodecode)No284214903060794755CHARGE_CODETradingupserialnumberStringMerchantstradedupserialnumber(needtobeunique)No20150324001069125999PAY_SUBJECTPaymentdescriptionStringPaymentdescriptionNo20150324001069125999goodsInfosProductinformationdescriptionListFornodeinformation,pleaserefertoAppendix1,"commodityinformationdefinition""YesPleaserefertorequestsample2.
4ReturnmessageTable2.
5ReturningparameterforscannedinterfaceParametersParameterNameTypeParameterDescriptionSampleRESULTResponsecodeObjectResponsecodeoftheinterface.
Thesub-nodeofthenodeincluding:CODE:Returnedcode.
Pleaserefertoappendix5fordetailedinfo.
INFO:Returninformation.
Pleasereferto"2.
6Returningsample"fordetailedinfo.
CHANNEL_TYPEPaymentchannelIntegerPleaserefertoappendix2fordetailedinfo.
1CHARGE_CODETradingupserialnumberStringMerchanttradingupserialnumber20150324001069125999CHARGE_DOWN_CODETradingdownserialnumberStringTradingdownserialnumberfromSOUSHOU1435736619488CHARGE_THIRD_CODESerialnumberofpaychannelStringserialnumberofpaychannel(alipay,wechatpay.
.
.
)2088110245121545154MERCHANTPARAUserParameterStringTheuserparameterisencodedusingbase64,andtheinterfacewillreturnitwithoutanymodification.
01000001FUND_BILL_LISTPaymentchannelinformationListThepaymentchannelinformationforthistransactionanditcancontaintheinformationofthesubnodesformultiplechannels,i.
e.
TRADEFUNDBILL,theparametersincludedbythenodeare:AMOUNT:Thetradingamountwhichispaidviathespecifiedpaymentchannel,theunitisYuan.
FUND_CHANNEL:Paymentchannel,pleaserefertoappendix3fordetailedinfo.
Pleasereferto"2.
6Sampleforreturningmessage"OPER_IDOperatorIDStringOperatorIDoper01DEV_IDDevicenumberStringDevicenumberdev01BEGIN_TIMEThetransactiondateDateThetransactiondate2015-10-1404:43:14AMTThetransactionamountStringUnitiscent15800QRcodepaymentprocedure(scannedbyconsumers)DemonstrationInterfaceintroductionrequest:com.
sosopay.
request.
SosopayTradePrecreateRequestclient:SosopayAPIClientFactory.
getSosopayClient(Parameter…);response:com.
sosopay.
response.
SosopayTradePrecreateResponseRequestparameterlistTable3.
3RequestparameterParameterParameternameTypeParameterdescriptionCanbeemptySampleBUSI_IDMerchantIDStringMerchantIDisallocatedcentrallybySOUSHOUNo0010000001OPER_IDOperatorIDStringOperatorIDNoOperator01DEV_IDDevicenumberStringDevicenumberNoCashRegister01MERCHANTPARAUserparameterStringTheuserparameterisencodedusingbase64,andtheinterfacewillreturnitwithoutanymodification.
Yes01000001REGISTER_IDStorecodeStringStorecodeYes02016AMTThetransactionamountStringUnitisYuanNo158.
00CHANNEL_TYPEPaymentChannelIntegerPleaserefertoappendix2fordetailedinfo.
No1CHARGE_CODETradingupserialnumberStringMerchantstradedupserialnumber(needtobeunique)No20150324001069125999NODIFY_URLAsynchronousnotificationaddressStringTheaddressthatSOUSHOUcannotifythemerchantafterasuccessfulpayment.
1,_type:Requirementfortheformatofthereturningmessage:Jsonorxml,xmlisthedefaultformatwhenthisparameterisnotset.
2,encrypt:Currentlysupportsthe3DESencryptiontothecontentofthemessage.
Whentheparameterisempty,willnotdoanyencryption.
Yeshttp://221.
12.
11.
172:8081/sosopayweb/sosopaytest_type=json&encrypt=3DESPAY_SUBJECTPaymentdescriptionStringPaymentdescriptionNoQRCodetopaygoodsInfosProductinformationdescriptionListFornodeinformation,pleaserefertoAppendix1,"commodityinformationdefinition""YesPleaserefertorequestsample2.
4ReturnparameterTable3.
5ReturningparameterforscanninginterfaceParameterParameternameTypeParameterDescriptionSampleRESULTResponsecodeObjectThesub-nodeincluding:CODE:Responsecode,pleaserefertoappendix5fordetailedinfo.
INFO:ReturnmessagePleaserefertothesampleinsection3.
6fordetailedinfo.
CHARGE_DOWN_CODETradingdownserialnumberStringThetransactionserialnumberreturnedbySOUSHOU1435736619488CHARGE_CODETradingserialnumberStringMerchantstradedupserialnumber(needtobeunique)20150324001069125999MERCHANTPARAUserparametersStringUserparameterisencodedbybase64andtheinterfacereturnthedataasreturned.
01000001BAR_CODEPaymentlinksStringUsedtogeneratetheQRcodeofthepayment(alipay,WeChatpay),orthepaymentlinkofotherbankpayments.
https://qr.
alipay.
com/baidecagzveqxn6oe7WeChatOfficialAccountspaymentprocedureInterfaceintroductionrequest:com.
sosopay.
request.
SosopayTradePrecreateRequestclient:SosopayAPIClientFactory.
getSosopayClient(参数…);response:com.
sosopay.
response.
SosopayTradePrecreateResponseRequestparametertableTable4.
2RequestingparameterforinterfaceParameterParameternameTypeParameterDescriptionCanbeemptySampleBUSI_IDMerchantIDStringMerchantIDisallocatedcentrallybySOUSHOUNo0010000001OPER_IDOperatorIDStringOperatorIDNoOperator01DEV_IDDevicenumberStringDevicenumberNoCashRegister01MERCHANTPARAUserparameterStringTheuserparameterisencodedusingbase64,andtheinterfacewillreturnitwithoutanymodification.
Yes01000001REGISTER_IDStorecodeStringStorecodeYes02016AMTThetransactionamountStringUnitisYuanNo158.
00CHANNEL_TYPEPaymentChannelIntegerPleaserefertoappendix2fordetailedinfo.
No1TRADE_TYPEPaytypeStringvalues:JSAPI,NATIVE,APPDefaultisNATIVEYesJSAPIsubAppidTheappidofSubmerchantStringTheappidofSubmerchantdistributedbyWeChat,thisparamisrequiredwhenyouneedobtainsub_openidafterpaymentcompletionYeswx8888888888888888subOpenidSubopenidundersubappidStringIftrade_type==JSAPI,thisparametercan'tbeempty,itisuniquelyidentifyunderthesub-merchantappidforuserYesCHARGE_CODETradingserialnumberStringMerchantstradedupserialnumber(needtobeunique)No20150324001069125999NODIFY_URLAsynchronousnotificationaddressStringTheaddressthatSOUSHOUcannotifythemerchantafterasuccessfulpayment.
1,_type:Requirementfortheformatofthereturningmessage:Jsonorxml,xmlisthedefaultformatwhenthisparameterisnotset.
2,encrypt:Currentlysupportsthe3DESencryptiontothecontentofthemessage.
Whentheparameterisempty,willnotdoanyencryption.
Yeshttp://221.
12.
11.
172:8081/sosopayweb/sosopaytest_type=json&encrypt=3DESPAY_SUBJECTPaymentdescriptionStringPaymentdescriptionNoQRCodetopayGOODS_DETAILProductinformationdescriptionListThedescriptionfortheproductwhichcancontainmultipleitems.
Fornodeinformation,pleaserefertotheappendix1fordetailedinfo.
YesPleasereferto"4.
3Sampleforrequestingmessage"fordetailedinfo.
ReturnparameterTable3.
5returnsparametersParameterParameternameTypeParameterDescriptionCanbeemptySampleRESULTResponsecodeObjectXmlnodenodesincludeCODE:returncode.
PleaserefertoAppendix5fordetailsINFO:returnmessageNoPleaserefertothereturnexampleCHARGE_DOWN_CODETradingdownserialnumberStringTransactionserialnumberreturnedfromKuaishouNo1435736619488CHARGE_CODETradingupserialnumberStringMerchantstradedupserialnumber(needtobeunique)No20150324001069125999CHARGE_THIRD_CODEChannelsserialnumberStringserialnumberofpaychannel(alipay,Wechatpay.
.
.
)No2016071521001004510282746866MERCHANTPARAUserParameterStringTheuserparameterisencodedusingbase64,andtheinterfacewillreturnitwithoutanymodification.
Yes01000001appIdWechatofficialaccountidStringServiceproviderAPPIDNotimeStamptimestampStringtimestampNononceStrRandomstringStringRandomstringNopackageDataOrderdetailsextensionstringStringOrderdetailsextensionstringNosignTypesignStringsignNosignsignStringsignNoAsynchronousnotificationInterfaceintroductionTheasynchronousinterfaceisapplicableforreturningpaymentresultwhencustomerscanningmerchant'sQRcode/barcodeforpayment.
URL:Merchant'saddressforreceivingtheasynchronousnotification_type=json&encrypt=3DES&sign={sign}InvocationMode:POSTTheasynchronousnotificationwillstopwhentheresponsecodeofthehttprequestis200,otherwisewillkeepqueryingthenotificationinterfacefor30timesper5seconds.
Formatfornotificationmessage:according'_type'parametertodetermine:ifitisnotspecified,thendefaultformatisxml,andifitissetas"json",thenthereturningmessagewillbeinjsonformat.
Whethertoencryptthereturningmessage:according'encrypt'todetermine,ifitisempty,thennoencryptionisapplied.
Currently,3DESencryptionissupported.
NotificationparametersTable4.
2ParametersforasynchronousinterfaceParameterParameternameTypeParameterdescriptionCanbeemptySampleBUSI_IDMerchantIDStringMerchantIDisassignedbySOUSHOUNo0010000001OPER_IDOperatorIDStringOperatorIDNoCashregister01DEV_IDDevicenumberStringDevicenumberNoCashregister01AMTTradingamountStringUnitisCentNo15800CHANNEL_TYPEPaymentchannelIntegerPleaserefertoappendix2fordetailedinfo.
No1CHARGE_CODETradingserialnumberStringMerchantstradingupserialnumber(needtobeunique)No20150324001069125999CHARGE_DOWN_CODETradingdownserialnumberStringTradingdownserialnumberreturnedbySOUSHOUNo1435736619488CHARGE_THIRD_CODESerialnumberofpaychannelStringserialnumberofpaychannel(alipay,wechatpay.
.
.
)No2016071521001004510282746866PAY_SUBJECTDescriptionforpaymentinformationStringDescriptionforpaymentinformationNoQRcodeproductsGOODS_DETAILProductdetailsListTheproductinformationwhichcancontainmultipleproducts.
Fornodeinformation,pleaserefertoappendix1fordetailedinfo.
YesPleasereferto4.
3forsample.
STATEOrderstatusIntegerPleaserefertoappendix4fordetailedinfo.
No1MERCHANTPARAUserparameterStringTheuserparameterisencodedusingbase64,andtheinterfacewillreturnitwithoutanymodification.
Yes01000001FUND_BILL_LISTInformationforPaymentchannelListThepaymentchannelinformationforthistransaction,anditcancontaintheinformationofthesub-node()formultiplechannels,theparametersincludedbythenodeare:AMOUNT:Thetradingamountwhichispaidviathespecifiedpaymentchannel,andtheunitisYuan.
FUND_CHANNEL:Paymentchannel,pleaserefertoappendix3fordetailedinfo.
NoPleasereferto4.
3forsampleNotificationmessagesampleJSONformat{"PAY_NODIFY":{"BUSI_ID":"0010000001","CHARGE_CODE":"1C88FADB-75D2-4517-9C38-F273D423FFF3","CHARGE_DOWN_CODE":"20151123100000095182","CHANNEL_TYPE":1,"STATE":1,"AMT":1,"OPER_ID":"TEST1","PAY_SUBJECT":"嗖嗖产品1","FUND_BILL_LIST":{"TRADEFUNDBILL":[{"FUND_CHANNEL":"10","AMOUNT":"0.
01"}]},"DEV_ID":"QQQQ","MERCHANTPARA":"111111111111111111111111"}}Notificationreturnmessage(notification,returnSUCCESS,stopnotification)RefundinterfaceInterfaceintroductionrequest:com.
sosopay.
request.
SosopayTradeRefundRequestclient:SosopayAPIClientFactory.
getSosopayClient(parameter…);response:com.
sosopay.
response.
SosopayTradeRefundResponserequestparameterTable6.
2RequestingparametersforrefundinterfaceParameterParameternameTypeParameterdescriptionCanbeemptySampleBUSI_IDMerchantIDStringMerchantIDisassignedbySOUSHOUNo0010000001OPER_IDOperatorIDStringOperatorIDNooper01DEV_IDDevicenumberStringDevicenumberNodev01CHARGE_REFUND_FEEAmountoftherefundStringTherefundamountcannotbegreaterthantheprincipalamount.
TheunitisYuan.
No158.
00REFUND_SUBJECTDescriptionforrefundStringDescriptionforrefundNoMerchantrefundsCHARGE_CODETradingupserialnumberStringTradingupserialnumber(needtobeunique)No20150324001069125999CHARGE_DOWN_CODETradingdownserialnumberStringThetradingdownserialnumberretunedbySOUSHOU(eithertradinguportradingdownserialnumberwillbeleveraged.
Andthetradingdownserialnumberwilltakeprioritywhenbothnumbersareavailable.
)Yes1435736619488OUT_REFUND_NOSerialnumberforrefundingStringMerchantrefundserialnumber(needtobeunique)Yes20150324001069125999ReturnParameterTable5.
4rerurnparameterParameterParameternameTypeParameterdescriptionCanbeemptySampleRESULTResponsecodeStringXmlnodenodesincludeCODE:returncode.
PleaserefertoAppendix5fordetailsINFO:returnmessageNOPleaserefertothereturnexample5.
5AMTTransactionamountStringIn0.
01yuanNO15800CHARGE_CODETransactionserialnumberStringTradingupserialnumber(needtobeunique)NO20150324001069125999CHARGE_DOWN_CODETradingdownserialnumberStringDownserialnumberwillbereturnedfromKuaishouNO1435736619488CHARGE_THIRD_CODEChannelserialnumberStringSerialnumberofpaychannel(alipay,wechatpay.
.
.
)NO2016071521001004510282746866FUND_BILL_LISTRefundchannelListThepaymentchannelinformationforthistransactioninXMLformatanditcancontaintheinformationofthesubnodesformultiplechannels,i.
e.
TRADEFUNDBILL,theparametersincludedbythenodeare:AMOUNT:Thetradingamountwhichispaidviathespecifiedpaymentchannel,theunitisYuan.
FUND_CHANNEL:Paymentchannel,pleaserefertoappendix3fordetailedinfo.
NOPleaserefertothereturnexample5.
5CHANNEL_TYPEPaymentchannelStringPleaserefertoappendix2PaymentchanneldictionaryNO1QueryinterfaceInterfaceintroductionrequest:com.
sosopay.
request.
SosopayTradeQueryRequestclient:SosopayAPIClientFactory.
getSosopayClient(parameter…);response:com.
sosopay.
response.
SosopayTradeQueryResponseSerialnumberCHARGE_CODEwhenclassserType=0oritisnullvalueitisthemerchantsserialnumber,ifserType=1,itisKuaishouserialnumber.
ReturnprarameterTable7.
2QueryinterfacereturnsparametersParametersParameterNameTypeParameterDescriptionCanbeemptySampleRESULTResponsecodeObjectTheXmlnodesubnodesareincluded*CODE:returncode.
PleaserefertoAppendix5fordetails*INFO:returnmessageNOPleaserefertothesampleBUSI_IDMerchantIDStringThemerchantIDisassignedbyKuaishouNO0010000001OPER_IDOperatorIDStringOperatorIDNOCashier01DEV_IDDeviceIDStringDeviceIDNOCashier01MERCHANTPARAUserparameterStringUserparametersareencodedbyBase64,andtheinterfacereturnsaswithoutmodificationYes01000001AMTTransactionamountStringIn0.
01yuanNO15800CHANNEL_TYPEPaymentchannelsStringPleaserefertoAppendix2,paymentchanneldictionary"NO1CHARGE_CODETradingserialnumberStringMerchanttransactionuplinkserialnumberNO20150324001069125999CHARGE_DOWN_CODEDownlinktransactionserialnumberStringDownlinkserialnumberwillbereturnedfromKuaishouNO1435736619488CHARGE_THIRD_CODEChannelserialnumberStringSerialnumberofpaychannel(alipay,wechatpay.
.
.
)NO2016071521001004510282746866PAY_SUBJECTPaymentinformationdescriptionStringPaymentinformationdescriptionNOQRcodeproductpaymentSTATEOrderstatusStringPleaserefertoAppendix4,"orderstatusdictionary""NO1GOODS_DETAILProductdetailsListThetransactiondescriptioncontainsseveralkindsofcommodity.
Fornodeinformation,pleaserefertoAppendix1,"commodityinformationdefinition"".
YesPleaserefertothesampleBEGIN_TIMETransactionstarttimeDateTransactionstarttimeNO2015-10-1404:43:14END_TIMETransactionendtimeDateTransactionendtimeYes2015-10-1404:43:14REGISTER_IDStorenumberStringStorenumberYes02016DYNAMIC_IDDynamiccodeofpayerStringCustomer'sAlipayorWeChatwalletdynamiccode(obtainedbymerchantscanningcustomer'sQR/barcodecode)NO284214903060794755FUND_BILL_LISTPaymentchannelinformationListThepaymentchannelinformationforthistransactioninXMLformatanditcancontaintheinformationofthesubnodesformultiplechannels,i.
e.
TRADEFUNDBILL,theparametersincludedbythenodeare:AMOUNT:Thetradingamountwhichispaidviathespecifiedpaymentchannel,theunitisYuan.
FUND_CHANNEL:Paymentchannel,pleaserefertoappendix3fordetailedinfo.
NOPleaserefertothesamplerevocationinterfaceInterfaceIntroductionrequest:com.
sosopay.
request.
SosopayTradeCancelRequestclient:SosopayAPIClientFactory.
getSosopayClient(parameter…);response:com.
sosopay.
response.
SosopayTradeCancelResponseIfparameteropTypeisnullornotACOrevocationwillbestartedinrealtime,WhenopType=ACOrevocationwillbesubmitted.
Table8.
2ThereturningparameterforrevokinginterfaceParameterParameternameTypeParameterdescriptionSampleRESULTResponsecodeObjectThesub-nodeincluding:CODE:Returningcode,pleaserefertoappendix5fordetailedinfo.
INFO:Returningmessage1BatchqueryinterfaceInterfaceintroductionrequest:com.
sosopay.
request.
SosopayTradeBatchQueryRequestclient:SosopayAPIClientFactory.
getSosopayClient(parameter…);response:com.
sosopay.
response.
SosopayTradeBatchQueryResponseRequestparameterParameterParameternameTypeParameterdescriptionCanbeemptySample_typeResponseformatStringReturndataformat:JSONindefaultNOjsonstateOrderstatusIntegerOrderstatus,pleaserefertoAppendix4(forallstatusdatawhenempty)Yes1beginDateStarttimeStringQuerystartdateformat:YYYY-MM-DDYes2016-01-01endDateEndtimeStringQueryenddateformat:YYYY-MM-DDYes2016-01-31busiCodeMerchantIDStringNO0010000001userIdOperatorIDStringOperatoraccountwhichiscurrentlyusedtologinthePCYestestChannelTypePaymentchannelIntegerPleaserefertoappendix2YesPageNumpageIntegerPagenumberNO1pageSizeRecordsperpageIntegerRecordsperpageNO10ChargeCodeMerchantordernumberStringUplinkordernumberYesReturnParameterParameterParameternameTypeParameterdescriptionCanbeemptySampleRESULTResponsecodeObjectXmlnodenodesincludeCODE:returncode.
PleaserefertoAppendix5fordetailsINFO:returnmessageNOPleaserefertothesamplechargesSizeOrderquantityIntegerReturnedOrderquantityNO1tradeInfosOrderlistListReturnedOrderlistYesPaymentchannelinterfaceInterfaceintroductionrequest:com.
sosopay.
request.
SosopayChannelRequestclient:SosopayAPIClientFactory.
getSosopayClient(parameter…);response:com.
sosopay.
response.
SosopayChannelResponseReturnparameterTable7.
2revocationinterfaceReturnparameterParameterParameternameTypeParameterdescriptionCanbeemptySampleRESULTResponsecodeObjectXmlnodenodesincludeCODE:returncode.
PleaserefertoAppendix5fordetailsINFO:returnmessageNOPleaserefertothereturmsample2.
2"PAY_CHANNEL_LISTPaymentchannelListTheKuaishoucashier'spaymentchannelinformationcontainsmultiplechannelinformationsub-nodes
4jsonreturnsample"PermissionauthenticationInterfaceintroductionrequest:com.
sosopay.
request.
SosoauthRequestclient:SosopayAPIClientFactory.
getSosopayClient(parameter…);response:com.
sosopay.
response.
SosoauthResponseTable9.
1PermissionauthenticationinputparameterParameterParameternameTypeParameterdescriptionCanbeemptySampleusernameusernameStringUsernameonmobileAPP.
TheusernameforthePOSdeviceistheassigneddevicenumberNOpasswordpasswordStringpasswordNObusiCodeMerchantIDStringProvideMerchantIDtotheuserYes返回参数ReturnParameterTable9.
2PermissionauthenticationinterfacereturnsparametersParameterParameternameTypeParameterdescriptionCanbeemptySamplesuccessResponsecodeStringtrue:Authenticationissuccessfulfalse:AuthenticationisfailedNOPleaserefertothesamplemessageFailedmassageStringErrormessageisreturnedafterfailureYesAccount/passworderroruseruserObjectUserinformarionYesidDevideIDStringUserIDYes1companyIdMerchantIDStringYesloginNameLoginnameStringYesnameusernameStringYesuserTypeUsertypeString1:Norefundpermission2:WithrefundpermissionYes2loginDateLatestlogindateString2015-11-0214:28:36YesloginFlagForbidornotString0:Logindisabled1:LoginavailableYesPleaserefertothesampledelFlagDeleteornotString0:Available1:DeteledYesPleaserefertothesampleIMEIDeviceserialnumberStringYesteTypeTerminalsoftwareversionString1AndroidYesappVerTerminalsoftwareversionnumberStringYesloginStatusOnlinestatus0:Offline1:OnlineYescompanyMerchantsObjectYesidMerchantIDYesnameMerchantnameYescodeMerchantcodeAfterthecertificationispassed,theordermerchantcodeneedstobecheckedagainwiththisparameter,andthesamemerchantcanberefundedYesuseableMerchantstatus0Onbehalfoftheaudit1Auditpassed2auditfailedYesdelFlagWhethermerchantisdeleted0:Available1:DeletedYesamountLimitTransactionlimitYesrefundAtSceneWhetherrefundsite0:Yes,1:NoYeschargeModeTradingmode1Offlinepayments2cashierYesprofitrateYestimeLimitTimeoutlimit(minute)YesisUploadGoodsWhetherUploadcommodityinformation0don'tupload1UploadYesprivateUrlMerchantURLYesReturnexampleFormat:JSONAppendixAppendix1DefinitionoftheProductInformationTable8.
1ProductinformationGOODS_DETAILParameterParameternameTypeParameterDescriptionCanbeemptySampleGOOD_IDProductIDStringProductIDNo2010GOOD_NAMEProductnameStringProductnameNoIPhoneGOOD_CLASSClassificationofproductsStringDevicecodeNoMobilephoneGOOD_PRICEAmountoftheproductStringUnitisYuanNo4999.
00GOOD_SUBJECTProductdescriptionStringPleaserefertoappendix2fordetailedinfo.
NoDigitalproductsGOOD_QUANTITYThenumberofproductsStringNeedtobeuniqueNo1GOOD_SHOWURLExhibitionaddressfortheproductStringTheaddressofthegoodsYeswww.
sssyin.
cnAppendix2PaymentChannelDataDictionary(Itemswhicharemarkedinredarenotsupportedyet)Table8.
2CHANNEL_TYPECodeofpaymentcodePaymentchannel0whenCustomer'sQRcodeisscannedbymerchanttopay,wewillautomaticdeterminationchannelsifset0.
1Alipay2WeChatpay3ChinaMerchantsBank4ICBC5CCB6BankofCommunications7EverbrightBankofChina8HuaxiaBank9AgriculturalBank10ShanghaiPudongDevelopmentBank11MinshengBankofChina12IndustrialBank13BankofChina14CITICBank15ChinaGuangfaBank16PingAnBank17Reserved18ShenzhenDevelopmentBank19HSBC20BankofEastAsia21HangSengBank22Citibank23StandardCharteredBank24BaiduWallet25ChinaMobileHeBaowallet26Unicompays27ChinaTelecomYipayment28MiWallet29ApplePay30SamsungPay31QQWalletAppendix3PaymentChannelDataDictionaryTable8.
3PaymentchannelsFUND_BILL_LISTCodeofpaymentchannelPaymentchannel00Alipaybonus10Alipaybalance60Alipayprepaidcard30AlipayJiFenbao70PaymentbyAlipaycredit40Discountvouchers80Prepaidcard90CreditPayment(consumerloan)11WeChatPay41PaymentbyWeChatcashcoupon12QQWalletpay42QQWalletcashcouponpay100Alipayfinancialaccounts101Merchantstorecard102Merchantcoupons103Bankcard(viaAlipay)104Merchantbonus9001Bankcard(viaBank,includingdebitandcreditcards)9002Randomdiscount9003Free9004Applycorrespondingdiscountwhentransactionamountmeetthepre-setdiscountingamountbythemerchantAppendix4OrderStatusDictionaryTable8.
4OrderStateOrderstatusDescription0Pendingpayment1Paid2Revoked3Applicationforrevocation4Partialrefund5Refunded6Transactionclosed8Refunding(Platformdidnotreturnaresultofrefund)9Refundfailed10Toberefunded(checktherefundwhenthecorrespondingmerchantserialnumberOUT_REFUND_Nreturntothestate)11Refundsuccessful(queryrefundwhenthecorrespondingbusinessintotheserialnumberOUT_REFUND_N,returntothestate)12RefundCanceled(checkrefundtimetoreturntothecorrespondingbusinessserialnumberOUT_REFUND_Nreturntothestate)13Refundfailed(checktherefundwhenthecorrespondingmerchantserialnumberOUT_REFUND_Nreturntothestate)14Canceltheorderofsuccess(checktherefundwhenthecorrespondingmerchantserialnumberOUT_REFUND_Nreturntothestate)Appendix5ReturnCodeDataDictionaryTable9.
5ReturncodeReturncodeDescriptionSUCESSSuccessFAILFailILLEGAL_PARAMETERParametererrorINVALID_SIGNSignatureerrorAMT_ERRORAmounterrorDATABASE_ERRORDatabaseconnectionexceptionINVALID_CONTRACTInvalidcontractstatusUNREGISTERED_BUSIUnregisteredmerchantEXCEPTIONUnknownexceptionCHARGE_NONEXISTENTThetransactiondoesnotexistSERVICE_UNAVAILABLEServiceisnotavailableHTTP_EXCEPTIONHTTPrequestingexceptionIO_EXCEPTIONIOexceptionCREATE_SECURITY_CONNECTION_ERRORFailedtocreatesecurelinks!
AREADY_REVOKEDTheorderhasbeenrevokedSERIAL_REPEATTheserialnumberisduplicatedwiththeexistingrecordinthesystem.
HostMem，最新优惠促销，全场75折优惠，大硬盘VPS特价优惠，美国洛杉矶QuadraNet机房，KVM虚拟架构，KVM虚拟架构，2核2G内存240GB SSD，100Mbps带宽，27美元/年
HostMem近日发布了最新的优惠消息，全场云服务器产品一律75折优惠，美国洛杉矶QuadraNet机房，基于KVM虚拟架构，2核心2G内存240G SSD固态硬盘100Mbps带宽4TB流量，27美元/年，线路方面电信CN2 GT，联通CU移动CM，有需要美国大硬盘VPS云服务器的朋友可以关注一下。HostMem怎么样？HostMem服务器好不好？HostMem值不值得购买？HostMem是一家...
HostSlim,双E5-2620v2/4x 1TB SATA大硬盘,荷兰服务器60美元月
hostslim美国独立日活动正在进行中，针对一款大硬盘荷兰专用服务器：双E5-2620v2/4x 1TB SATA硬盘，活动价60美元月。HostSlim荷兰服务器允许大人内容，不过只支持电汇、信用卡和比特币付款，商家支持7天内退款保证，有需要欧洲服务器的可以入手试试，记得注册的时候选择中国，这样不用交20%的税。hostslim怎么样?HostSlim是一家成立于2008年的荷兰托管服务器商，...
licloud：$39/月，香港物理服务器，30M带宽，e3-1230v3/16G内存/1T硬盘
licloud官方消息：当前对香港机房的接近100台物理机(香港服务器)进行打折处理，30Mbps带宽，低至不到40美元/月，速度快，性价比高，跑绝大多数项目都是绰绰有余了。该款香港服务器自带启动、关闭、一键重装功能，正常工作日内30~60分钟交货（不包括非工作日）。 官方网站：https://licloud.io 特价香港物理服务器 CPU：e3-1230v2（4核心、8线程、3.3GH...
sosos为你推荐
-
易pc笔记本电脑好?还是易PC笔记本电脑好？行业关键词机械行业最热门的关键词有哪些！！！网站运营一般网站如何运营arm开发板arm开发板是干什么用的，是用在什么领域方面的办公协同软件最好用的协同办公软件是哪个ios7固件下载ios7发布当天是否有固件下载安装迅雷看看播放器迅雷看看播放器安装mate8价格华为mate8手机参数配置如何，多少元机械键盘轴大家觉得机械键盘什么轴最舒服网管工具网吧工具有什么？