参数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.
JUSTG（5.99美元/月）最新5折优惠，KVM虚拟虚拟512Mkvm路线
Justg是一家俄罗斯VPS云服务器提供商，主要提供南非地区的VPS服务器产品，CN2高质量线路网络，100Mbps带宽，自带一个IPv4和8个IPv6，线路质量还不错，主要是用户较少，带宽使用率不高，比较空闲，不拥挤，比较适合面向非洲、欧美的用户业务需求，也适合追求速度快又需要冷门的朋友。justg的俄罗斯VPS云服务器位于莫斯科机房，到美国和中国速度都非常不错，到欧洲的平均延迟时间为40毫秒，...
RackNerd新上圣何塞、芝加哥、达拉斯、亚特兰大INTEL系列,$9.49/年
racknerd怎么样?racknerd商家最近促销三款美国便宜vps，最低只需要9.49美元，可以选择美国圣何塞、西雅图、纽约和芝加哥机房。RackNerd是一家成立于2019年的美国高性价比服务器商家，主要从事美国和荷兰数据中心的便宜vps、独立服务器销售!支持中文工单、支持支付宝和微信以及PayPal付款购买!点击直达：racknerd官方网站INTEL系列可选机房：加利福尼亚州圣何塞、芝加...
2021HawkHost老鹰主机黑色星期五虚拟主机低至3.5折 永久4.5折
老鹰主机HawkHost是个人比较喜欢的海外主机商，如果没有记错的话，大约2012年左右的时候算是比较早提供支付宝付款的主机商。当然这个主机商成立时间更早一些的，由于早期提供支付宝付款后，所以受众用户比较青睐，要知道我们早期购买海外主机是比较麻烦的，信用卡和PAYPAL还没有普及，大家可能只有银联和支付宝，很多人选择海外主机还需要代购。虽然如今很多人建站少了，而且大部分人都用云服务器。但是老鹰主机...
sosos为你推荐
-
暴风影音怎么截图暴风影音3 如何截图工信部备案怎样在工信部进行域名备案?要详细ios7固件下载iphone自动下载IOS7固件版本怎么删除迅雷云点播账号求一个迅雷云点播vip的账号，只是看的，绝不动任何手脚。虚拟机软件下载谁有好用的虚拟机软件?域名库求解：请将您的域名：别名（CNAME）主机解析到idc1.xiaodoutao.com防钓鱼游戏中的防钓鱼检查是什么?2018最火爆的歌曲2018最火十大歌曲是哪些？液晶显示器电源维修液晶显示器开关电源维修注意事项有哪些adobephotoshop教程Photoshop从头学起精品教程