nestpay merchant integration 3d pay hosting v.1.4
Post on 10-Feb-2018
602 Views
Preview:
TRANSCRIPT
-
7/22/2019 Nestpay Merchant Integration 3D Pay Hosting v.1.4
1/19
MERCHANT INTEGRATION
3D PAY HOSTING MODELVersion 1.4
25 Jne 2!12
NESTPAY VIRTUAL POS TEST INFORMATION MANUALNESTPAY VIRTUAL POS TEST INFORMATION MANUAL
http://www.est.com.tr/ -
7/22/2019 Nestpay Merchant Integration 3D Pay Hosting v.1.4
2/19
Version Date Description
1.4 25 June 2012 Added hidden encodin !"#"$e%e#.
INDEX
3D Pay Hosting Model....................................................................................................................Nestpay 3D Pay Hosting Model.....................................................................................................Quick Start Guide...........................................................................................................................
Generate Hash for Client Authentication.................................................................................................Posting hidden Parameters.....................................................................................................................
VISA Payment Page ..............................................................................................................................3D Authentication ...................................................................................................................................Transaction Result Page.........................................................................................................................erchant Success Page.........................................................................................................................
!asic transaction res"onse "arameters for full authenticated successful 3D transaction#............................$or the e%am"le transaction a&o'e the transaction res"onse "arameters (ould &e#...................................
Integration Basics ..........................................................................................................................HTTP Post Integration.............................................................................................................................
Sam"le HTTP form (ith mandatory and o"tional "arameters.......................................................................Card Transactions...............................................................................................................................................
PI Res"onse Parameters............................................................................................................................Possi&le mdStatus Values............................................................................................................................
Successful Transaction................................................................................................................................. $ailed Transaction........................................................................................................................................Transaction Res"onse Parameters...............................................................................................................PI Res"onse Parameters...........................................................................................................................Possi&le Transaction Results........................................................................................................................
Hash Chec)ing.......................................................................................................................................Generating the "lain te%t for hash.......................................................................................................................
Assuming that the transaction res"onse "arameters...................................................................................
Code Samples.................................................................................................................................ASP Code Sam"le...................................................................................................................................*et Code Sam"le...................................................................................................................................+SP Code Sam"le...................................................................................................................................PHP Code Sam"le..................................................................................................................................
PP!NDI" # Gate$ay Parameters..............................................................................................andatory In"ut Parameters...................................................................................................................,"tional In"ut Parameters......................................................................................................................Transaction Res"onse Parameters.........................................................................................................PI Res"onse Parameters.....................................................................................................................
NESTPAY VIRTUAL POS TEST INFORMATION MANUALNESTPAY VIRTUAL POS TEST INFORMATION MANUAL
-
7/22/2019 Nestpay Merchant Integration 3D Pay Hosting v.1.4
3/19
3D Pay Hosting Model&' P"( )o*%in $ode+ i* %he ,"*ic in%e#ne% in%e#"%ion $ode+ -i%h !"($en% !"e
ho*%in *u!!o#%in &' %#"n*"c%ion*.
Basic Properties:
En",+e* !#oce**in o/ &' *ecu#e c"#d %#"n*"c%ion*
)TTP Po*% $e%hod /o# $e#ch"n% in%e#"%ion
P"($en% i* done "u%o$"%ic"++( ,( Ne*%!"(.
A/%e# o,%"inin "++ nece**"#( *ho!!in d"%" /#o$ cu*%o$e# +ie o#de# "$oun%
cu##enc( cu*%o$e# n"$e*u#n"$e e%c.3 $e#ch"n% *e#e# ene#"%e* " uniue o#de# I'.
Nece**"#( !"#"$e%e#* "#e !o*%ed -i%h )TTP Po*% $e%hod %o Ne*%!"( "%e-"(.
Fo# c"#d !"($en% $e%hod* Vi*" M"*%e#6"#d e%c.3 $e#ch"n% *e#e# need* %o *u,$i%
%he c"#d de%"i+* +ie c"#d nu$,e# 6VV2 "nd e7!i#( d"%e in/o#$"%ion. A/%e# %he
o#de#c"#d d"%" i* o,%"ined /#o$ %he u*e# %he &' /+o- en#o++$en% "nd "u%hen%ic"%ion
ue#ie*3 *%"#%*. In &' /+o- %he &' "u%hen%ic"%ion in/o#$"%ion o/ %he cu*%o$e# i*
ue#ied ,( %he i**ue# ,"n. The $e%hod* /o# &' "u%hen%ic"%ion c"n ,e di//e#en% /o#
di//e#en% i**ue#*. E7"$!+e* o/ &' "u%hen%ic"%ion $e%hod* "#e u*"e o/ &' *ecu#e
!"**-o#d one8%i$e !"**-o#d *ecu#i%( ue*%ion*.
1. The cu*%o$e# no-* %h"% hi*he# !e#*on"+ in/o#$"%ion i* no% *"ed ,( %he
$e#ch"n% ,ec"u*e c#edi% c"#d in/o#$"%ion i* ue#ied ,( Ne*%!"( no% %he
$e#ch"n%.
2. In%e#"%ion !#oce** i* e"*(.
&. 9"n:* SSL ce#%i/ic"%e i* u*ed. The#e/o#e %he *o/%-"#e c"nno% ,e u!d"%ed.
4. In "ddi%ion %o %he o,+i"%o#( !"#"$e%e#* $e#ch"n% c"n POST i%* o-n d"%" *uch"* u*e#n"$e u*e# e$"i+ o# u*e# id. Tho*e d"%" i* *en% ,"c %o %he $e#ch"n% ,(
%he ,"n.
NESTPAY VIRTUAL POS TEST INFORMATION MANUALNESTPAY VIRTUAL POS TEST INFORMATION MANUAL
-
7/22/2019 Nestpay Merchant Integration 3D Pay Hosting v.1.4
4/19
Nestpay 3D Pay Hosting Model
PayHosting Model Diagram
NESTPAY VIRTUAL POS TEST INFORMATION MANUALNESTPAY VIRTUAL POS TEST INFORMATION MANUAL
-
7/22/2019 Nestpay Merchant Integration 3D Pay Hosting v.1.4
5/19
Quick tart !uide
M"in *ucce**/u+ *"+e VISA %#"n*"c%ion -i%h 3D PayHosting Mode+.
!enerate Has" #or $lient %ut"entication)"*h i* %he ,"*e;48encoded e#*ion o/ %he h"*hed %e7% -hich i* ene#"%ed -i%h S)A1
"+o#i%h$. To ene#"%e %he h"*hed /o# c+ien% "u%hen%ic"%ion ou#+ > /"i+u#+ > %#"n*"c%ion %(!e> in*%"+$en% > #nd>*%o#ee( ?
@ien !"#"$e%e#*
clienid : 990000000000001
oid : 1291899411421
amount : 91.96
okurl : https://www.teststore.com/success.php
failurl : https://www.teststore.com/fail.php
transaction type: Auth
instalment : 2
rnd : asdf
storekey : 123456
)"*h
plaintext= 990000000000001129189941142191.96
https://www.teststore.com/success.phphttps://www.teststore.com/fail.
phpAuth2asdf123456
ash = !ase64"#A1"plai$te%t&&
NESTPAY VIRTUAL POS TEST INFORMATION MANUALNESTPAY VIRTUAL POS TEST INFORMATION MANUAL
-
7/22/2019 Nestpay Merchant Integration 3D Pay Hosting v.1.4
6/19
Posting "idden Parameters
Po*%in %he $"nd"%o#( in!u% !"#"$e%e#* %o Ne*%!"( P"($en% @"%e-"( +oc"%ed "%
"ttps:''"ost'#im'est3dgate "* hidden !"#"$e%e#*.
clientid : Me#ch"n% I' ien ,( Ne*%!"(3
storetype : (3d)pay)"osting*
"as" : )"*h "+ue /o# c+ien% "u%hen%ic"%ion
islemtipi :Au%h
amount : "$oun% %#"n*"c%ion "$oun%
currency :ISO code o/ %#"n*"c%ion cu##enc( B4B /o# TL3
oid : Uniue iden%i/ie# o/ %he o#de#
encoding :UTF8C
ok+rl :The #e%u#n URL %o -hich Nestpay Payment !ate,ay#edi#ec%* %he
,#o-*e# o/ %he cu*%o$e# i/ %#"n*"c%ion i* co$!+e%ed *ucce**/u++(.
#ail+rl : The #e%u#n URL %o -hich Nestpay Payment !ate,ay#edi#ec%* %he
,#o-*e# o/ %he cu*%o$e# i/ %#"n*"c%ion i* co$!+e%ed un*ucce**/u++(.
lang : L"nu"e o/ %he !"($en% !"e* ho*%ed ,( Ne*%!"( %# /o# Tu#i*h en
/o# En+i*h3
pan :6"#d nu$,e#
Ecom)Payment)$ard)E&pDate)-ear :E7!i#( (e"#
Ecom)Payment)$ard)E&pDate)Mont" : E7!i#( $on%h
NESTPAY VIRTUAL POS TEST INFORMATION MANUALNESTPAY VIRTUAL POS TEST INFORMATION MANUAL
-
7/22/2019 Nestpay Merchant Integration 3D Pay Hosting v.1.4
7/19
ample H..P #orm ,it" mandatory parameter set
Please!o*% %he /o++o-in !"#"$e%e#* %o Ne*%!"( @"%e-"( "* " hidden !"#"$e%e#
-i%h )TTP /o#$.
'i$put t(pe=)hidde$) $ame=)encoding) *alue=)+,-8) $"nd"%o#( !"#"$e%e# *o+e*
%he encodin !#o,+e$ o/ %he !"($en% "nd #e%u#n !"e* du#in %he %#"n*"c%ion"c%ion.
'form method=)post) actio$="https://host/fim/est3dgate">
'i$put t(pe=)hidde$) $ame=)clientid) *alue=)990000000000001)/
'i$put t(pe=)hidde$) $ame=)storetype) *alue=)3dpa() /
'i$put t(pe=)hidde$) $ame=)hash"*alue=)ie6cd47;
-
7/22/2019 Nestpay Merchant Integration 3D Pay Hosting v.1.4
8/19
VI% Payment Page6on*u$e# -i++ en%e# hi*he# c"#d de%"i+* %o co$!+e%e %he %#"n*"c%ion "nd c+ic* %he P"(
,u%%on.
/ig01
3D %ut"enticationIn &' /+o- %he &' "u%hen%ic"%ion in/o#$"%ion o/ %he cu*%o$e# i* ue#ied ,( %he
i**ue# ,"n. The $e%hod* /o# &' "u%hen%ic"%ion c"n ,e di//e#en% /o# di//e#en% i**ue#*.
E7"$!+e* o/ &' "u%hen%ic"%ion $e%hod* "#e u*"e o/ &' *ecu#e !"**-o#d one8%i$e
!"**-o#d *ecu#i%( ue*%ion*.
.ransaction 2esult Page
The %#"n*"c%ion #e*u+% -i++ ,e di*!+"(ed %o cu*%o$e#. I/ %he %#"n*"c%ion i* *ucce**/u+
%he "u%ho#iD"%ion code -i++ ,e di*!+"(ed. The cu*%o$e# -i++ ,e #edi#ec%ed %o oU#+ i/
#e/#e*h%i$e i* oe#.
/ig0
NESTPAY VIRTUAL POS TEST INFORMATION MANUALNESTPAY VIRTUAL POS TEST INFORMATION MANUAL
-
7/22/2019 Nestpay Merchant Integration 3D Pay Hosting v.1.4
9/19
Merc"ant uccess PageI/ %he %#"n*"c%ion i* *ucce**/u+ %he cu*%o$e# -i++ ,e #edi#ec%ed %o ok+rl -hich i*
*u,$i%%ed on *%e! 2 %o Ne*%!"( P"($en% @"%e-"(. A++ !"#"$e%e#* !o*%ed ,( $e#ch"n%
#e%u#n* ,"c %he $e#ch"n%. In "ddi%ion %o $e#ch"n% !"#"$e%e#* "%e-"( #e%u#n* %he
%#"n*"c%ion #e*!on*e !"#"$e%e#* "nd MPI #e*!on*e !"#"$e%e#* #e+"%ed %o &' *ecu#e%#"n*"c%ion /+o-3 -hich c"n ,e /ound in A!!endi7 A.
Basic transaction response parameters #or #ull aut"enticated success#ul3D transaction:
2esponse : %ppro4ed
%ut"$ode :Au%ho#iD"%ion code o/ %he %#"n*"c%ion
Host2e#Num :)o*% #e/e#ence nu$,e#
Proc2eturn$ode :00
.ransId :Uniue %#"n*"c%ion I'
mdtatus :1
/or t"e e&le transaction a5o4e t"e transaction response parameters,ould 5e:
2esponse : 6%ppro4ed6
%ut"$ode : 544CCB
Host2e#Num :0&4B10000&20
Proc2eturn$ode : (00
.ransId : 10&4B115&&10B100&&
mdtatus :1
NESTPAY VIRTUAL POS TEST INFORMATION MANUALNESTPAY VIRTUAL POS TEST INFORMATION MANUAL
-
7/22/2019 Nestpay Merchant Integration 3D Pay Hosting v.1.4
10/19
Integration Basics
H..P Post IntegrationA/%e# #eceiin " "+id o#de# !"#"$e%e#* "#e !o*% %o Ne*%!"( !"($en% "%e-"( "*
hidden !"#"$e%e#* -i%h )TTP /o#$. In "ddi%ion %o $"nd"%o#( !"#"$e%e#* $e#ch"n%
c"n !o*% o#de# ,i++in*hi!!in "nd o#de# i%e$ de%"i+* %o !"($en% "%e-"( -hich c"n
,e ie-ed +"%e# on Me#ch"n% Ad$ini*%#"%ion P"ne+. Fo# o!%ion"+ !"#"$e%e#*
e7!+"n"%ion* !+e"*e #e/e# %o A!!endi7 G A.
The 2C ,(%e8+on ,"*e8;4 encoded 7id !"#"$e%e# i* %he uniue In%e#ne% %#"n*"c%ion
I' -hich i* #eui#ed /o# &' *ecu#e %#"n*"c%ion*. I/ i% i* no% *en% ,( %he $e#ch"n% i%
-i++ ,e c#e"%ed "u%o$"%ic"++( ,( %he *(*%e$.
ample H..P #orm ,it" mandatory and optional parameters
'form method=)post) actio$=)https://host/fim/>estpa(?ate)
'i$put t(pe=)hidde$) $ame=)clie$tid) *alue=)990000000000001)/
'i$put t(pe=)hidde$) $ame=)storet(pe) *alue=)3dpa(hosti$?) /
'i$put t(pe=)hidde$) $ame=)hash) *alue=)ie6cd47;
-
7/22/2019 Nestpay Merchant Integration 3D Pay Hosting v.1.4
11/19
7800 Billing Parameters 9%ll ptional;00Net $ode ample
?P $ode ample
PHP $ode ample
NESTPAY VIRTUAL POS TEST INFORMATION MANUALNESTPAY VIRTUAL POS TEST INFORMATION MANUAL
-
7/22/2019 Nestpay Merchant Integration 3D Pay Hosting v.1.4
16/19
%PPENDIX %: !ate,ay Parameters
Mandatory Input Parameters
Parameter Description /ormat
c+ien%id Me#ch"n% I' M"7i$u$ 15 ch"#"c%e#*
*%o#e%(!e Me#ch"n% !"($en% $ode+ Po**i,+e "+ue*< !"(ho*%in
&d!"( &d&d!"(ho*%in
i*+e$%i!i T#"n*"c%ion %(!e Se% %o Au%h /o# "u%ho#iD"%ionP#eAu%h /o# !#e"u%ho#iD"%ion
"$oun% "$oun% %#"n*"c%ion "$oun% U*e . o# "* deci$"+*e!"#"%o# do no% u*e #ou!inch"#"c%e#
cu##enc( ISO code o/ %#"n*"c%ion cu##enc( & ch"#"c%e#* e7"$!+e< B4B /o#
TL3
oid Uniue iden%i/ie# o/ %he o#de# M"7i$u$ ;4 ch"#"c%e#*
encodin encodin !"#"$e%e# UTF8C
!"n 6"#d nu$,e# M"7i$u$ 20 dii%*
Eco$P"($en%6"#dE7!'"%eYe"#
6"#d e7!i#( (e"# 4 dii%*
Eco$P"($en%6"#dE7!'"%eMon%h
6"#d e7!i#( $on%h 2 dii%*
oU#+ The #e%u#n URL %o -hich Ne*%!"(#edi#ec%* %he cu*%o$e# i/ %#"n*"c%ion i*
co$!+e%ed *ucce**/u++(.
E7"$!+e
top related