参数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.
DMIT(8.72美元)日本国际线路KVM月付8折起,年付5折
DMIT.io是成立于2018年的一家国外主机商，提供VPS主机和独立服务器租用，数据中心包括中国香港、美国洛杉矶和日本等，其中日本VPS是新上的节点，基于KVM架构，国际线路，1Gbps带宽，同时提供月付循环8折优惠码，或者年付一次性5折优惠码，优惠后最低每月8.72美元或者首年65.4美元起，支持使用PayPal或者支付宝等付款方式。下面列出部分日本VPS主机配置信息，价格以月付为例。CPU：...
Megalayer（159元 ）年付CN2优化带宽VPS
Megalayer 商家我们还算是比较熟悉的，商家主要业务方向是CN2优化带宽、国际BGP和全向带宽的独立服务器和站群服务器，且后来也有增加云服务器（VPS主机）业务。这次中秋节促销活动期间，有发布促销活动，这次活动力度认为还是比较大的，有提供香港、美国、菲律宾的年付VPS主机，CN2优化方案线路的低至年付159元。这次活动截止到10月30日，如果我们有需要的话可以选择。第一、特价限量年付VPS主...
bgpto：BGP促销,日本日本服务器6.5折$93/月低至6.5折、$93/月
bgpto怎么样?bgp.to日本机房、新加坡机房的独立服务器在搞特价促销，日本独立服务器低至6.5折优惠，新加坡独立服务器低至7.5折优惠，所有优惠都是循环的，终身不涨价。服务器不限制流量，支持升级带宽，免费支持Linux和Windows server中文版(还包括Windows 10). 特色：自动部署，无需人工干预，用户可以在后台自己重装系统、重启、关机等操作!bgpto主打日本(东京、大阪...
sosos为你推荐
-
万维读者网罂粟花的含义?行业关键词企业应如何做关键词排名深圳公交车路线深圳公交线路最新qq空间代码qq空间都是有哪些免费代码！（要全部）怎么样免费装扮qq空间如何免费装扮qq空间万网核心代理哪里可以注册免费代理？bluestacks安卓模拟器BlueStacks如何安装使用？godaddy美国GODADDY 域名支持域名别名解析吗？网页打开很慢如何解决网速正常 网页打开很慢问题虚拟专用网intranet，extranet，虚拟专用网与internet有什么区别与联系