参数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是一家...
819云（240元）香港CN2 日本CN2 物理机 E5 16G 1T 20M 3IP
819云是我们的老熟人了，服务器一直都是稳定为主，老板人也很好，这次给大家带来了新活动，十分给力 香港CN2 日本CN2 物理机 E5 16G 1T 20M 3IP 240元0官方网站：https://www.819yun.com/ 特惠专员Q：442379204套餐介绍套餐CPU内存硬盘带宽IP价格香港CN2 （特价）E5 随机分配16G1T 机械20M3IP240元/月日本CN2 （...
统计一下racknerd正在卖的超便宜VPS，值得推荐的便宜美国VPS
racknerd从成立到现在发展是相当迅速，用最低的价格霸占了大部分低端便宜vps市场，虽然VPS价格便宜，但是VPS的质量和服务一点儿都不拉跨，服务器稳定、性能给力，尤其是售后方面时间短技术解决能力强，估计这也是racknerd这个品牌能如此成功的原因吧！ 官方网站：https://www.racknerd.com 多种加密数字货币、信用卡、PayPal、支付宝、银联、webmoney，可...
sosos为你推荐
-
qq空间装扮qq空间怎么装扮bt封杀BT下载可以封杀迅雷吗?什么原理?能破吗?系统分析员系统分析员的工作内容网站地图制作如何制作、提交网站地图qq等级表QQ等级列表优锁一个大家还没有认的产品,应该怎么去做市场呢?basic语言教程怎么学习VB语言？能给我提供些教材吗？阿里云备案阿里云服务器备案需要哪些资料双线双线下载是什么意思双线手表双线是什么意思