Professional Documents
Culture Documents
Nganluong Integration Guide Checkout v31 en
Nganluong Integration Guide Checkout v31 en
ADVANCED NGANLUONG
INTEGRATION GUIDE
version 3.1
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 1
NganLuong.vn – advance integration – version 3.1
CONCEPTS, TERMINOLOGIES
Terms define Note
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 2
NganLuong.vn – advance integration – version 3.1
TABLE OF CONTENTS
I. Introduction_____________________________________________________________________4
II. Proccess________________________________________________________________________4
1. Provided service Diagrams______________________________________________________4
2. Visual Descriptions_____________________________________________________________4
III. Function API_________________________________________________________________7
1. Live Enviroment________________________________________________________________7
2. Test sandbox__________________________________________________________________7
3. Creat order Function___________________________________________________________8
4. Check order Function_________________________________________________________10
5. Additional Information________________________________________________________12
a. bank_code__________________________________________________________________12
b. error_code__________________________________________________________________14
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 3
NganLuong.vn – advance integration – version 3.1
I. Introduction
When Merchant site have integrated Nganluong API, the customers choose payment method
( include: ATM_ONLINE, ATM_OFFLINE, IB_ONLINE, WALLET, NH_OFFLINE, ... ) on the
merchant site. And then, customers fill infomations of bank or wallet, ... on the nganluong.vn site
with choosed respective method.
II. Proccess
2. Visual Descriptions
- Customer fill their infomations and choose payment method on the merchant site
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 4
NganLuong.vn – advance integration – version 3.1
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 5
NganLuong.vn – advance integration – version 3.1
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 6
NganLuong.vn – advance integration – version 3.1
- Merchant sent order info to Nganluong API using SetExpressCheckout func with POST
method.
+ If correct, Ngan Luong respone checkout url to merchant. And merchant with direct
custommer to that .
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 7
NganLuong.vn – advance integration – version 3.1
- Customer receive successfully notification. Nganluong response results to merchant site through
return_url param
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 8
NganLuong.vn – advance integration – version 3.1
1. Live Enviroment
- Nganluong api: https://www.nganluong.vn/checkout.api.nganluong.post.php
- Registry merchant site link: when you registry successfully, you have merchant_id and
MerchantPass
https://www.nganluong.vn/nganluong/merchant.html
2. Test sandbox
- Registry Nganluong Account link:
https://sandbox.nganluong.vn:8088/nl30/nganluong/home.html
- Test Nganluong api link: https://sandbox.nganluong.vn:8088/nl30/checkout.api.nganluong.post.php
- Registry Merchant site code link: when you registry successfully, you have merchant_id và
MerchantPass
https://sandbox.nganluong.vn:8088/nl30/nganluong/merchant.html
- Note:
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 9
NganLuong.vn – advance integration – version 3.1
Mã OTP: 123456
Func : SetExpressCheckout
Input
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 10
NganLuong.vn – advance integration – version 3.1
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 11
NganLuong.vn – advance integration – version 3.1
Payment Canceled Page URL. when buyer don’t pay and click
cancel_url String(500)
“cancel payment”, it’ll redirect this link
Payment Pending Duration (by minutes); Default = 1440 minutes
time_limit Int
(24 hours)
buyer_fullname String(255) Buyer’s fullname
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 12
NganLuong.vn – advance integration – version 3.1
- Func: GetTransactionDetail
Input
Param Type Description
website/merchant code registered on nganluong(ID
merchant_id string
connection)
= MD5(MerchantPass).
merchant_password string
With MerchantPass: password connection of merchnat_id
version string 3.1
function string GetTransactionDetail
token string Token code of transaction. It’s unique on Nganluong.vn
Output ( format : string XML)
error_code string Error code
token string Token code of transaction. It’s unique on Nganluong.vn
Email address of NganLuong.vn account that uses to
receiver_email string
receive money from the payment
order_code string Order ID generated by the merchant's site
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 13
NganLuong.vn – advance integration – version 3.1
5. Additional Information
a. bank_code
bank_ Payment_method
No Bank Name
code
ATM_ONLINE ATM_OFFLINE NH_OFFLINE IB_ONLINE QRCODE
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 14
NganLuong.vn – advance integration – version 3.1
Bank)
The Vietnam
Technological
3 TCB and Commercial X X X X
JSC Bank
(Techcombank)
Military JSC
4 MB X X X
Bank (MB)
Vietnam
5 VIB International X X
Bank (VIB)
Vietnam Joint
Stock
Commercial
6 ICB Bank for X X X X
Industry and
Trade
(VietinBank)
Vietnam Export
Import
7 EXB Commercial X
Joint Stock Bank
(Eximbank)
Asia
8 ACB Commercial X X X
Bank (ACB)
HoChiMinh City
Development
9 HDB Joint Stock X
Commercial
Bank (HDBank)
Vietnam
Maritime
10 MSB Commercial X X X
Joint Stock Bank
(MariTimeBank)
Nam Viet Bank
11 NVB X
(NaviBank)
Vietnam Asia
Commercial
12 VAB X
Joint Stock Bank
(VietA Bank)
Vietnam
13 VPB Prosperity Bank X
(VPBank)
14 SCB Saigon Thuong X X X
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 15
NganLuong.vn – advance integration – version 3.1
Tin Commercial
Joint Stock Bank
(Sacombank)
Global Petro
Commercial
15 GPB X
Joint Stock Bank
(GPBank)
Vietnam Bank
For Agriculture
16 AGB and Rural X X X X
Development
(Agribank)
Bank for
Investment &
17 BIDV X X X X
Dof Vietnam
(BIDV)
OceanBank
18 OJB X
(OceanBank)
Petrolimex
Group
19 PGB Commercial X X X
Joint Stock Bank
(PGBank)
Saigon Hanoi
Commercial
20 SHB X X X
Joint Stock Bank
(SHB)
21 TPB TienPhong Bank X X
Nam A
22 NAB commercial joint X
stock bank
Sai Gon Bank
for Industry and
23 SGB X
Trade (Saigon
Bank)
Bac A
24 BAB commercial joint X
stock bank
An Binh
25 ABB Commercial X
Joint Stock Bank
Saigon
26 SGCB Commercial X
Bank
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 16
NganLuong.vn – advance integration – version 3.1
b. error_code
Error code list
Mã lỗi Mô tả
00 No Error
10 Invalid Order_code
12 Invalid Currency
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 17
NganLuong.vn – advance integration – version 3.1
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn 18