参数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.
VirMach：$27.3/月-E3-1240v1/16GB/1TB/10TB/洛杉矶等多机房
上次部落分享过VirMach提供的End of Life Plans系列的VPS主机，最近他们又发布了DEDICATED MIGRATION SPECIALS产品，并提供6.5-7.5折优惠码，优惠后最低每月27.3美元起。同样的这些机器现在订购，将在2021年9月30日至2022年4月30日之间迁移，目前这些等待迁移机器可以在洛杉矶、达拉斯、亚特兰大、纽约、芝加哥等5个地区机房开设，未来迁移的时...
RAKsmart：美国洛杉矶独服,E3处理器/16G/1TB,$76.77/月;美国/香港/日本/韩国站群服务器,自带5+253个IPv4
RAKsmart怎么样？RAKsmart机房即日起开始针对洛杉矶机房的独立服务器进行特别促销活动：低至$76.77/月，最低100Mbps带宽，最高10Gbps带宽，优化线路，不限制流量，具体包括有：常规服务器、站群服务器、10G大带宽服务器、整机机柜托管。活动截止6月30日结束。RAKsmart，美国华人老牌机房，专注于圣何塞服务器，有VPS、独立服务器等。支持PayPal、支付宝付款。点击直达...
VinaHost，越南vps,国内延时100MS;不限流量100Mbps
vinahost怎么样?vinahost是一家越南的主机商家，至今已经成13年了，企业运营，老牌商家，销售VPS、虚拟主机、域名、邮箱、独立服务器等，机房全部在越南，有Viettle和VNPT两个机房，其中VNPT机房中三网直连国内的机房，他家的产品优势就是100Mbps不限流量。目前，VinaHost商家发布了新的优惠，购买虚拟主机、邮箱、云服务器、VPS超过三个月都有赠送相应的时长，最高送半年...
sosos为你推荐
-
快递打印如何用打印机打印快递单天天酷跑刷积分教程最近一直有人说天天酷跑刷积分，怎么刷的。打开网页出现错误网页出现错误怎么解决?要最简单的那种百度抢票浏览器手机百度浏览器抢票版根本就没预约抢票。噱头而已！唱吧电脑版官方下载唱吧有电脑版的么？ 在哪里下载啊？蘑菇街美丽说蘑菇街、美丽说这类网站前期是怎么推广的？保护气球如何才能让气球放久了不会没气商标注册查询官网全国商标注册查询在哪里查呀？云挂机云挂机每天2+元你提了吗？电子商务网站模板我想开发一个电子商务网站，但是想加入自己设计的模板，可以吗？