nestpay merchant integration 3d pay hosting v.1.4

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/


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.....................................................................................................................



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.



4/19

Nestpay 3D Pay Hosting Model

PayHosting Model Diagram



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&&



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



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;


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



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&ample 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



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;


11/19

7800 Billing Parameters 9%ll ptional;00Net $ode ample

?P $ode ample

PHP $ode ample



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

nestpay merchant integration 3d pay hosting v.1.4

Documents