T

i
i
l
l
i
i

u
u
t
t

c
c
h
h
h
h

p
p
w
w
e
e
b
b
s
s
i
i
t
t
e
e

[
[
P
P
a
a
y
y
g
g
a
a
t
t
e
e
0
0
0
0
1
1
]
]

Phin bn 2.0 12 28 2011







Revision History
Phin bn Ngy thc hin Ni dung Ngi thc hin
1.0 2010/15/12 To mi Khc Chi Hun
2.0 2012/28/12 Sa Khc Chi Hun


I. Tng quan
1. S d t ng quan b tb ng Paygate
VTC Paygate
Ngi mua hng
Mua bn trc
tuyn
Bank
V in t khc
Ti khon
Np tin
Rt tin
Thanh ton
Chuyn
khon
Bo co
Qun tr

M hnh trn m t tng qut cc thnh phn chc nng trong cng thanh ton VTC
Paygate v s tng tc vi cc i tc khc gm:
Nh cung cp, bn v phn phi sn phm trc tuyn
Khch hng thanh ton trc tuyn
Cc v in t lin kt
Ngn hng lin kt
2. Cbc nng tcb bp tbanb ton Paygate

Chc nng tch hp thanh ton gip khch hng thng qua Paygate c th chi tr cc n
hng online thng qua:
V in t Paygate
Ti khon ngn hng, v in t
Qua ti khon eBank
Vi v in t Paygate, khch hng c th mua hng online trn cc website tch hp
Paygate.
3. Muc dcb tai liu
Ti liu c vit vi mc ch cho i tc hiu r chc nng tch hp thanh ton trn cng
thanh ton VTC Paygate
H tr i tc lp trnh tch hp chc nng thanh ton trn website ca mnh
II. Hng dn dng k website tcb bp tbanb ton
ng k tch hp thanh ton qua Paygate, bn cn ng nhp vo ti khon trn
Paygate, truy cp vo menu "H s\Tch hp\Tch hp website ng k mt website tch
hp. Paygate s hin ra trang qun l cc website tch hp ca bn. in cc thng tin cn thit
v lm theo yu cu hon thnh ng k tch hp.
Ch :
- Url nhn kt qu: L trang s nhn kt qu sau khi tr v (bao gm hai phng thc
POST v GET) sau khi x l n hng t Paygate.
III. Lp trnb tcb bp tbanb ton
1. Quy trnh tch hp thanh ton

sd Payment
Websi te bn hng
Khch hng
VTC Paygate Ngn hng/V
i n t
La chn sn phm()
To n
hng()
Thanh ton qua Paygate
HTTP Get()
Thanh ton bng TK ngn hng()
Http Get/ Http Post()
Check v x l kt qu tr v()
Thng bo
kt qu()


Nghip v: i tc sau khi ng k website trn Paygate, sau lp trnh tch hp thanh
ton qua n hng qua Paygate. Khch hng qua site chn hnh thc thanh ton qua Paygate, lc
s to ra mt n hng truyn sang Paygate qua Url. D liu truyn sang s c m ha
RSA vi private key ca i tc. Paygate s x l sau tr kt qu thc hin v site ca i tc
bng cch:
u tin s dng phng thc POST kt qu n hang v site i tc. Da vo
d liu post v, i tc s bit c tnh trng giao dch: Thnh cng, tht bi,
nghi vn.
Sau s dng phng thc GET redirect v trang ca i tc
2. i tc s dng pbng tbc Cet cbuyn sang Paygate d tbanb ton dn
bang
Cu trc Url:
Url = paygate_url? websiteid=websiteid_value& paymentmethod=method_value&
data=data_value&sign=sign_value&loginaccount =account_value& des=
description_value&customer_name=name_value&customer_mobile=mobile_number
Trong :
Trng Kiu Bt
buc
M t
paygate_url string Y a ch trang thanh ton trn paygate:
http://sandbox1.vtcebank.vn/Paygate3/Paygate/payment-order.html (
a ch ny s thay i khi trin khai ln h thng tht)
websiteid Int Y M ca website ng k trn Paygate, xem trong phn qun l tch hp
website trong Paygate
paymentmethod int Y Phng thc thanh ton,
0: thanh ton bng c VND v Vcoin,
1: ch thanh ton bng VND,
2: ch thanh ton bng Vcoin
3: cho php thanh ton bng Vcoin Game (ch mt s i tc ca VTC
c php)
4: thanh ton bng VN, Vcoin game, Vcoin thanh ton
data string Y Thng tin n hng truyn ln paygate
data = orderID|totalAmount|receivePayageAcc
loginaccount string N Ti khon ng nhp vo website tch hp, S dng vi cc i tc s
dng ti khon ebank. Vi cc website tch hp c ti khon ng nhp
l ti khon ebank th bt buc phi in thng tin ny. Cn khng th
b qua
orderID string(55) Y M n hng. Ch gm s [0-9] v cc ch ci [a-z,A-Z]. Khng cha
cc k t c bit
totalAmount number Y Tng s tin thanh ton. S tin truyn ln Paygate lun quy i ra tin
VND
receivePayageAcc string Y Ti khon Paygate nhn tin (ti khon Paygate ca ngi bn). Tin
thanh ton n hng s chuyn v ti khon ny
des String(50) N M t thng tin n hng
customer_name String(20) N Tn ca khch hng mua hng
customer_mobile number N S di ng ca khch hng mua hng.
sign string T M ha RSA. Sau encode ri truyn ln Url
-Trng hp truyn loginaccount:
websiteid|paymentmethod|data| loginaccount
Vd: sign= CreateRSASign(14|2|123456|300000|0986021866)
-Nu khng truyn loginaccount th d liu m ha s l:
websiteid|paymentmethod|data)
Vd: sign=
CreateRSASign(14|2|123456|300000|0986021866|ebanktest)

V d: Url = http://sandbox1.vtcebank.vn/Paygate3/Paygate/payment-
order.html?websiteid=10&paymentmethod=0&data=20110425105118|50000|0989921623&sign=bu0fN75rcHybujEbgdh+OEqAp8qFeEdniYpc
DnCYKOtpSo/Fbs8onxHabn6FOmjSXR4JP8OL/ShBemcQOX/n8NmXUOh1nw7jpK0fwxeIY0ezXBNFDA9eIxIRvs3nTr8+tmkaUwd/aEiTLL
m54uBeJ1Q35oEosrZONCIwNw9MxSg=&description=M%C3%A3%20th%E1%BA%BB%20Viettel
3. Lp trnh x l kt qu thanh ton tr v t Paygate, cp nht trng thi n hng
n hng sau gi sang Paygate s c Paygate x l. Quy trnh x l n hng t Paygate v
website i tc gm 2 bc ng thi:
3.1. S dng pbng tbc PUST d post d liu.
Da vo d liu post v, i tc s bit c tnh trng giao dch: Thnh cng, tht bi,
nghi vn ( phng thc POST s c thc hin trc khi redirect ngi dng).
D liu post v gm hai trng data v sign
Chi tit:
data= status| orderID|websiteID
status: Trng thi n hng, gi tr:
1: Thnh cng
0: Nghi vn, ang ch x l
-1: Tht bi (<0)
2: Thanh ton tm gi (thnh cng)
orderID: M n hng
websiteID: M ca website ng k trn Paygate, xem trong phn qun l tch
hp website trong Paygate.
sign: M ha RSA ca cc trng data (status| orderID|websiteID)
VD: sign= CreateRSASign(1|123456|14)
Ch : D liu c POST trc tip t server paygate nn nhn c d liu POST
khi test cn phi trin khai ln a ch pulic.
3.2. S dng pbng tbc CET d redirect kbcb bang v trang ca di tc
Url phng thc get: patner_url?pay=order_id
Trong :
patner_url: L ng dn tr v ca site i tc
order_id: L order ca n hng m i tc gi ln
VD: http://sandbox1.vtcebank.vn/Paygate3/Paygate/payment-order.html?pay=09855644
IV. Code tbam kbo
1. To va xc tbc cb k
Trong phn code tham kho trn Paygate, chng ti cung cp code tham kho to v code xc
thc ch k bng 3 ngn ng ph bin l .Net, java, php trong 3 class tng ng. Bn download v v
tch hp vo site ca bn.
2. Tbng tin tai kbon test
Thng tin ti khon merchant test:
Account: 0986021866
Password: paygate@2011
Ti khon test khi thanh ton bng Vcoin:
Account: vtctest1
Password:123456
a ch website test paygate: http://sandbox1.vtcebank.vn/paygate3/community/trang-chu.html
a ch trin khai mi trng tht: https://paygate.vtc.vn/cong-thanh-toan/payment-order.html
V. Cc trng bp cn lu kbi tcb bp
1. Vi trng bp tbanb ton bng eBank {dn v Vcoin]
Paygate s chuyn s Vcoin ca ngi mua s chuyn sang ti khon Vcoin ca ngi bn.
Ti khon Vcoin ngi bn c khai bo trong Ti khon nhn Vcoin ( phn thng tin ti
khon

2. Tbng bo sai cb k
Thng thng sai ch k do cc nguyn nhn sau:
- Sai key: Khng k bng private key tng ng vi public key gi cho Paygate( public key
gi cho Paygate v private key k d liu khng thuc mt cp)
- Sai d liu truyn ln: Khng truyn ng m website (websiteID) website tch hp.
- D liu m ha khng ng fomat Paygate m t trong ti liu
3. Sai dn v tin truyn ln trn Paygate
Cho d phng thc thanh ton (paymentmethod) l g chng na th S tin thanh ton cc n
hng trn Paygate (totalAmount) lun c tnh theo n v VN