Wazatel支付网关设计说明.docx
- 文档编号:4592716
- 上传时间:2022-12-07
- 格式:DOCX
- 页数:15
- 大小:99.22KB
Wazatel支付网关设计说明.docx
《Wazatel支付网关设计说明.docx》由会员分享,可在线阅读,更多相关《Wazatel支付网关设计说明.docx(15页珍藏版)》请在冰豆网上搜索。
Wazatel支付网关设计说明
Wazatel支付网关设计说明
需求概要说明
1、新增加Wazatel支付网关
2、运营商在选择该支付网关时填写该支付网关的相关信息。
3、用户在进行信用卡支付时,会根据用户所在的业务组所设定的支付网关进行支付。
数据库结构
1.Wazatel(VSPWazatel支付信息)
说明:
该表用于记录VSP所使用Wazatel支付网关的信息。
Name
Fotmat
Request
Comments
VPSProtocol
varchar
Fixed4characters.
Yes
Defaultorincorrectvalueistakentobe2.00.
TxType
Varchar(15)
Yes
Shouldbeincapitalletters.
Vendor
Varchar(15)
Yes
Usedtoauthenticateyoursite.ThisshouldcontaintheVSPVendorNamesuppliedbyProtxwhenyouraccountwascreated.
Status
Int(11)
Yes
PaymentGatewaystatus1normal0pause
参数说明
1.传递的参数列表
Name
Format
Values
Comments
VPSProtocol
Alphanumeric.
Fixed4characters.
“2.22”inthisrelease
Defaultorincorrectvalueistakento
be2.00.
TxType
Alphanumeric
Max15characters.
“PAYMENT”,“DEFERRED”or
“PREAUTH”
Seecompaniondocument“VSP
ServerandDirectSharedProtocols”
othertransactiontypes(suchas
Refund,Releases,Abortsand
Repeats).
Vendor
Alphanumeric
Max15characters.
VendorLoginName
Usedtoauthenticateyoursite.This
shouldcontaintheVSPVendorName
suppliedbyProtxwhenyouraccount
wascreated.
VendorTxCode
Alphanumeric
Max40characters
VendorTransactionCode
Thisshouldbeyourownreference
codetothetransaction.Your
serversshouldprovideacompletely
uniqueVendorTxCodeforeach
transaction.
Amount
Numeric.
1.00to100,000.00
AmountfortheTransaction
containingminordigits
formattedto2decimalplaces
whereappropriate.
Mustbepositiveandnumeric,and
mayincludeadecimalplacewhere
appropriate.Minordigitsshouldbe
formattedtotwodecimalplaces.e.g.
5.10,or3.29.Valuessuchas3.235
willberejected.
Currency
Alphanumeric
3characters
Three-lettercurrencycodeto
ISO4217Examples:
“GBP”,
“EUR”and“USD”
Thecurrencymustbesupportedby
oneofyourVSPmerchantaccounts
orthetransactionwillberejected.
Description
Alphanumeric
Max100characters
Freetextdescriptionofgoodsor
servicesbeingpurchased
Thedescriptionofgoodpurchasedis
displayedintheAdministrative
screensforyourfuturereference.
CardHolder
Alphanumeric
Max50characters
Thecardholder’sname
Thisshouldbethenamedisplayed
onthecard.
CardNumber
Alphanumeric
Max20characters
Thecreditordebitcardnumber
withnospaces.
Thefullcardnumberisrequired.
StartDate
Optional
Numeric
4characters
TheStartdate(requiredfor
Switch,SoloandAmex)in
MMYYformat
ThestartdateMUSTbeinMMYY
formati.e.0699forJune1999.No/
or–charactersshouldbeincluded.
ExpiryDate
Numeric
4characters
TheExpirydate(requiredfor
ALLcards)inMMYYformat
TheexpirydateMUSTbeinMMYY
formati.e.1206forDecember2006.
No/or–charactersshouldbe
included.
IssueNumber
Optional
Numeric
Max2characters
ThecardIssueNumber(Switch
andSolocardsonly)
TheissuenumberMUSTbeentered
EXACTLYasitappearsonthecard.
e.g.somecardshaveissuenumber
“4”othershave“04”.
CV2
Optional
Numeric
Max4characters
Theextrasecurity3digitson
thesignaturestripofthecard,
ortheextra4digitsonthefront
forAmericanExpressCards
NB:
IfAVS/CV2isONforyour
accountthisfieldbecomes
compulsory.
CardType
Alphanumeric
Max15characters
“VISA”:
4929000000006
”MC”:
5404000000000001
”DELTA”:
4462000000000009
“SOLO”:
6334900000000005
“SWITCH”:
5641820000000005
“AMEX”:
374200000000004
“DC”,“UKE”,or“JCB”
MCisMasterCard,UKEisVisa
Electron.AMEXandDC(DINERS)
canonlybeacceptedifyouhave
additionalmerchantaccountswith
thoseacquirers.
BillingAddress
Optional
Alphanumeric
Max200characters
TheCardHolder’sBilling
Address(theaddressatwhich
thecardisregistered)
WITHOUTthePost/Zipcode.
(previouscalledAddress)
NB:
IfAVS/CV2isONforyour
accountthisfieldbecomes
compulsory.
EnsurethePostcodeisnotincluded
orAddressVerificationcheckswill
fail.
BillingPostCode
Optional
Alphanumeric
Max10characters
ThePost/ZipcodeoftheCard
Holder’sBillingAddress(the
addressatwhichthecardis
registered).Previouscalled
PostCode)
NB:
IfAVS/CV2isONforyour
accountthisfieldbecomes
compulsory.
DeliveryAddress
Optional
Alphanumeric
Max200characters
Freeformatfieldforthe
customer’sDeliveryAddress
withoutthePost/Zipcode
ThisinformationisnotusedinAVS
checksbutisheldonthereporting
systemsforyourrecords.
DeliveryPostCode
Optional
Alphanumeric
Max10characters
ThePostcodeorZipcodeofthe
customer’sdeliveryaddress
ThisinformationisnotusedinAVS
checksbutisheldonthereporting
systemsforyourrecords.
CustomerName
Optional
Alphanumeric
Max100characters
Thenameofthecustomer.
Thisisthenameofcustomerto
whomthegoodsareordered.This
fieldisprovidedbecauseitisnot
necessarilythesameasthe
CardHoldernameabove(whichis
compulsory).
ContactNumber
Optional
Alphanumeric
Max20characters
Thetelephonenumberonwhich
tocontactthecustomer.
Theinformationisnotusedin
customervalidationatpresentandis
availableforreportingpurposesonly.
ContactFax
Optional
Alphanumeric
Max20characters
Thefaxnumberonwhichto
contact
Theinformationisnotusedin
customervalidationatpresentandis
availableforreportingpurposesonly.
CustomerEMail
Optional
Alphanumeric
Max255characters
Thecustomer’se-mailaddress
ThecurrentversionofVSPDirect
doesnotsendconfirmatione-mails
(althoughfutureversionwill)tothe
customer.Thisfieldisprovidedfor
yourrecordsonly.
Basket
Optional
Alphanumeric
Max7500
characters
Seethenextsectionforthe
FormatoftheBasketfield
Thisfieldcanusetosupplydetailsof
thecustomer’sorder.Future
versionsofthesystemwillusethis
fieldtosupplyLineItemdetailfor
purchasecards.
GiftAidPayment
Optional
Flag
0=ThistransactionisnotaGift
Aidcharitabledonation(default)
1=ThispaymentisaGiftAid
charitabledonationandthe
customerhasAGREEDtodonate
thetax.
Onlyofuseifyourvendoraccountis
GiftAidenabled.Settingthisfield
meansthecustomerhastickeda
boxonyoursitetoindicatethey
wishtodonatethetax.SeeGiftAid
rulesformoredetails.
ApplyAVSCV2
Flag
0=IfAVS/CV2enabledthen
checkthem.Ifrulesapply,use
rules.(default)
1=ForceAVS/CV2checkseven
ifnotenabledfortheaccount.If
rulesapply,userules.
2=ForceNOAVS/CV2checks
evenifenabledonaccount.
3=ForceAVS/CV2checkseven
ifnotenabledfortheaccount
butDON’Tapplyanyrules.
Usingthisflagyoucanfinetunethe
AVS/CV2checksandrulesetyou’ve
definedatatransactionlevel.Thisis
usefulincircumstanceswheredirect
andtrustedcustomercontacthas
beenestablishedandyouwishto
overridethedefaultsecuritychecks.
ClientIPAddress
Optional
Alphanumeric
Max15characters
TheIPaddressoftheclient
connectingtoyourserver
makingthepayment.
ThisshouldbeafullIPaddress
whichyoucanobtainfromyour
serverscripts.Wewillattemptto
GeolocatetheIPaddressinyour
reports.
CAVV
Optional
Alphanumeric
28charactersfor
VisaCAVV
32charactersfor
MasterCardUCAF
TheBase64encodedCAVVor
UCAFverificationvalueforthis
3D-Securetransaction.
SuppliedbytheMPI.
Thisistheuniqueauthorisation
signaturefora3D-Secure
transactionthathasbeenvalidated
bytheacquirer.Liabilityshiftoccurs
ifthisispresent.Thevalueis
suppliedbytheProtx3D-MPI
XID
Optional
Alphanumeric
28characters
The3D-SecuretransactionID,
XID,suppliedbytheProtxMPI.
Thisvalueuniquelyidentifiesthe3DSecure
transactioninthethree
domainmodel.Suppliedbythe
ProtxMPI.
ECI
Optional
Alphanumeric
2characters
Thee-Commerceindicatorflag,
suppliedbytheProtxMPI.
Thisfieldidentifesthetransaction
type.Thevalueissuppliedbythe
Protx3D-MPI
3DSecureStatus
Optional
Alphanumeric
Max15characters
The3DStatusreturnedbythe
ProtxMPI.
Thisfieldindicateswhichstageof
the3D-Secureprocessthis
transactionreached.Thevalueis
suppliedbytheProtx3D-MPI
2.返回的参数列表
Name
Format
Values
Comments
VPSProtocol
Alphanumeric.
Fixed4characters.
Versionnumberoftheprotocolofthe
system.Thisreleasewillreturn“2.22”
Thiswillmatchtheprotocol
versionsuppliedinA1.
Status
Alphanumeric
Max15characters.
“OK”–Thetransactionwasauthorised
bythebankandfundshavebeentaken
fromthecustomer.
“MALFORMED”–Inputmessagewas
missingfieldsorbadlyformatted–
normallywillonlyoccurduring
developmentandvendorintegration.
“INVALID”–Transactionwasnot
registeredbecausealthoughthePOST
formatwasvalid,someinformation
suppliedwasinvalid.E.g.incorrect
vendornameorcurrency.
“ERROR”–Acode-relatederroroccurred
whichpreventedtheprocessfrom
executingsuccessfully.
“NOTAUTHED”–Thetransactionwas
notauthorisedbytheacquiringbank.No
fundscouldbetakenfromthecard.
**NEW**
”REJECTED”–TheVSPSystemrejected
thetransactionbecauseoftherulesyou
havesetonyouraccount.
IfthestatusisnotOK,the
StatusDetailfieldwillgive
moreinformationaboutthe
problem.
PleasenotifyPROTXifa
StatusreportofERRORis
seen,togetherwithyour
VendorTxCodeandthe
StatusDetailtext.
StatusDetail
Alphanumeric
Max255characters
Human-readabletextprovidingextra
detailfortheStatusmessage.
AlwayscheckStatusDetailis
theStatusisnotOK
VPSTxId
Alphanumeric
38characters
ProtxIDtouniquelyidentifythe
Transactiononoursystem.
Youshouldstorethisvalue
andquoteittousifyouhave
aqueryaboutthetransaction.
SecurityKey
Alphanumeric
10charact
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- Wazatel 支付 网关 设计 说明