Function API
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
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
+ Registry Nganluong Account: choose Type of transaction authentication is Payment Password
+ Payment with ATM ONLINE, choose Bac A Bank with infomations:
Number card ATM: 9874563254178962
Card holder: Nguyen Hue
Release date: 10/2016
Mã OTP: 123456
+ Payment with Internet banking, choose BIDV Bank with infomations:
Account Number: 9874563254178962
Cardholder/account: Nguyen Hue
Password payment bank: 123456
Release date: 10/2016
OTP code: 123456
+ Payment with VISA, informations:
Number card: 4444003254178962
The name printed on the card: Nguyen Hue
Expiration date: 10/2023
CVV/CVV2 code: 123
OTP code: 123456
Creat order Function
Using POST method to send data.
Func : SetExpressCheckout
Using send order to Nganluong
Input
|
Param
|
Type
|
Description
|
merchant_id
|
Int
|
website/merchant code registered on nganluong(ID connection)
|
merchant_password
|
String
|
= MD5(MerchantPass).
With MerchantPass: password connection of merchnat_id
|
version
|
String
|
3.1
|
function
|
String
|
SetExpressCheckout
|
receiver_email
|
String(500)
|
Email address of NganLuong.vn account that uses to receive money from the payment
|
order_code
|
String
|
Order ID generated by the merchant's site
|
total_amount
|
Int
|
Total prices of Order
|
payment_method
|
String
|
Values for the payment method:
NL: Pay with E-wallet balance
VISA ( with bank_code: VISA or MASTER): Pay with Visa, Master Card
ATM_ONLINE: Pay with ATM card/Bank account balance
ATM_OFFLINE: Transfer money at ATM
NH_OFFLINE: Transer money via Internet Banking or at Bank's counter
IB_ONLINE (with bank_code : VCB, TCB, DAB, BIDV: pay with internet banking
CREDIT_CARD_PREPAID : pay with prepaid credit card
|
bank_code
|
String
|
Bank id (required with payment_method: ATM_ONLINE, ATM_OFFLINE, NH_OFFLINE , IB_ONLINE, VISA )
|
payment_type
|
String
|
Payment type: 1 - Immediate Payment; 2 - Custodial Payment; If you don't send this parameter or it is null, the parameter will be set as NganLuong.vn's default policy.
|
order_description
|
String(500)
|
Order Description
|
tax_amount
|
int
|
Total Tax Amount
|
discount_amount
|
int
|
Discount amount
|
fee_shipping
|
int
|
Shipping Fee
|
return_url
|
String(500)
|
Payment Succeeded Page URL . when buyer pay successfully, it’ll redirect this link
|
cancel_url
|
String(500)
|
Payment Canceled Page URL. when buyer don’t pay and click “cancel payment”, it’ll redirect this link
|
time_limit
|
Int
|
Payment Pending Duration (by minutes); Default = 1440 minutes (24 hours)
|
buyer_fullname
|
String(255)
|
Buyer’s fullname
|
buyer_email
|
String(255)
|
Buyer’s email
|
buyer_mobile
|
String(20)
|
Buyer’s number phone
|
buyer_address
|
String(500)
|
Buyer's Billing Address
|
cur_code
|
String
|
Currency type. Value is “vnd” or “usd”
|
lang_code
|
String
|
The language have been dislay on nganluong checkout.
Value is “vi” or “en”
|
affiliate_code
|
String(255)
|
Nganluong Affiliate's ID
|
total_item
|
String
|
Total Quantity order
|
item_name1
|
String
|
Item 1st Name
|
item_quantity1
|
String
|
Item 1st Quantity
|
item_amount1
|
String
|
Item 1st Price
|
item_url1
|
String
|
Item 1st URL
|
Output ( format : string XML)
|
Param
|
Type
|
Description
|
error_code
|
String (2)
|
Error code. Detail on index III.5.b
|
token
|
string
|
Token code of transaction. It’s unique on Nganluong.vn
|
checkout_url
|
string
|
Payment Page URL or Payment Guide Page URL for Money Transfer
|
time_limit
|
string
|
Payment Pending Time by minute, Default = 1440 minutes (24 hours)
|
description
|
string
|
Error Description (if any)
|
Check order Function
Using POST method to send and receive data.
Func: GetTransactionDetail
Using to checking order status and get a transaction info.
Input
|
Param
|
Type
|
Description
|
merchant_id
|
string
|
website/merchant code registered on nganluong(ID connection)
|
merchant_password
|
string
|
= MD5(MerchantPass).
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
|
receiver_email
|
string
|
Email address of NganLuong.vn account that uses to receive money from the payment
|
order_code
|
string
|
Order ID generated by the merchant's site
|
total_amount
|
Integer
|
Total prices of Order
|
payment_method
|
string
|
Values for the payment method:
NL: Pay with E-wallet balance
VISA ( with bank_code: VISA or MASTER): Pay with Visa, Master Card
ATM_ONLINE: Pay with ATM card/Bank account balance
ATM_OFFLINE: Transfer money at ATM
NH_OFFLINE: Transer money via Internet Banking or at Bank's counter
IB_ONLINE (with bank_code : VCB, TCB, DAB, BIDV: pay with internet banking
CREDIT_CARD_PREPAID : pay with prepaid credit card
|
bank_code
|
string
|
Bank id (required with payment_method: ATM_ONLINE, ATM_OFFLINE, NH_OFFLINE , IB_ONLINE, VISA )
|
payment_type
|
string
|
Payment type: 1 - Immediate Payment; 2 - Custodial Payment; If merchant don't send this parameter or it is null, the parameter will be set as NganLuong.vn's default policy.
|
order_description
|
string
|
Order Description
|
tax_amount
|
int
|
Total Tax Amount
|
discount_amount
|
int
|
Discount amount
|
fee_shipping
|
int
|
Shipping Fee
|
return_url
|
string
|
Payment Succeeded Page URL . when buyer pay successfully, it’ll redirect this link
|
cancel_url
|
string
|
Payment Canceled Page URL. when buyer don’t pay and click “cancel payment”, it’ll redirect this link
|
time_limit
|
String
|
Payment Pending Duration (by minutes); Default = 1440 minutes (24 hours)
|
buyer_fullname
|
string
|
Buyer’s fullname
|
buyer_email
|
string
|
Buyer’s email
|
buyer_mobile
|
string
|
Buyer’s number phone
|
buyer_address
|
string
|
Buyer's Billing Address
|
affiliate_code
|
string
|
Nganluong Affiliate's ID
|
transaction_status
|
string
|
00 –successsful;
01 – processing;
02 - unsuccessful
|
transaction_id
|
string
|
Transaction ID on nganluong.vn
|
description
|
string
|
Other description (if any)
|
Additional Information bank_code
STT
|
bank_code
|
Bank Name
|
Payment_method
|
ATM_ONLINE
|
ATM_OFFLINE
|
NH_OFFLINE
|
IB_ONLINE
|
1
|
VCB
|
JSC Bank for Foreign Trade of Vietnam (Vietcombank)
|
X
|
X
|
X
|
x
|
2
|
DAB
|
DongA JSC Bank (DongA Bank)
|
X
|
X
|
X
|
x
|
3
|
TCB
|
The Vietnam Technological and Commercial JSC Bank (Techcombank)
|
X
|
X
|
X
|
x
|
4
|
MB
|
Military JSC Bank (MB)
|
X
|
X
|
X
|
|
5
|
VIB
|
Vietnam International Bank (VIB)
|
X
|
|
X
|
|
6
|
ICB
|
Vietnam Joint Stock Commercial Bank for Industry and Trade (VietinBank)
|
X
|
X
|
X
|
|
7
|
EXB
|
Vietnam Export Import Commercial Joint Stock Bank (Eximbank)
|
X
|
|
|
|
8
|
ACB
|
Asia Commercial Bank (ACB)
|
X
|
X
|
X
|
|
9
|
HDB
|
HoChiMinh City Development Joint Stock Commercial Bank (HDBank)
|
X
|
|
|
|
10
|
MSB
|
Vietnam Maritime Commercial Joint Stock Bank (MariTimeBank)
|
X
|
X
|
X
|
|
11
|
NVB
|
Nam Viet Bank (NaviBank)
|
X
|
|
|
|
12
|
VAB
|
Vietnam Asia Commercial Joint Stock Bank (VietA Bank)
|
X
|
|
|
|
13
|
VPB
|
Vietnam Prosperity Bank (VPBank)
|
X
|
|
|
|
14
|
SCB
|
Saigon Thuong Tin Commercial Joint Stock Bank (Sacombank)
|
X
|
X
|
X
|
|
15
|
GPB
|
Global Petro Commercial Joint Stock Bank (GPBank)
|
X
|
|
|
|
16
|
AGB
|
Vietnam Bank For Agriculture and Rural Development (Agribank)
|
X
|
X
|
X
|
|
17
|
BIDV
|
Bank for Investment & Dof Vietnam (BIDV)
|
X
|
X
|
X
|
x
|
18
|
OJB
|
OceanBank (OceanBank)
|
X
|
|
|
|
19
|
PGB
|
Petrolimex Group Commercial Joint Stock Bank (PGBank)
|
X
|
X
|
X
|
|
20
|
SHB
|
Saigon Hanoi Commercial Joint Stock Bank (SHB)
|
X
|
X
|
|
|
21
|
TPB
|
TienPhong Bank
|
X
|
|
X
|
|
22
|
NAB
|
Nam A commercial joint stock bank
|
X
|
|
|
|
23
|
SGB
|
Sai Gon Bank for Industry and Trade (Saigon Bank)
|
X
|
|
|
|
24
|
BAB
|
Bac A commercial joint stock bank
|
X
|
|
|
|
error_code
Error code list
|
Mã lỗi
|
Mô tả
|
00
|
No Error
|
99
|
Undefined Error or Unknown Error
|
02
|
Merchant IP request denied
|
03
|
Incorrect checksum, access is denied
|
04
|
Invalid API function (not exist)
|
05
|
Incorrect API version
|
06
|
Merchant ID not exist or not activated
|
07
|
Incorrect Merchant password
|
08
|
Merchant account not exist
|
09
|
Merchant account freezed
|
10
|
Invalid Order_code
|
11
|
Invalide Total Amount
|
12
|
Invalid Currency
|
29
|
Token not exist
|
80
|
Order can’t create
|
81
|
Order haven’t paid yet
|
110
|
This is not main receiver email
|
111
|
Receiver email has been locked
|
113
|
Receiver account is not digital merchant account
|
114
|
Transaction is not completed
|
115
|
Transaction is cancelled
|
118
|
Invalid tax_amount
|
119
|
Invalid discount_amount
|
120
|
Invalid fee_shipping
|
121
|
Invalid return_url
|
122
|
Invalid cancel_url
|
123
|
Invalid items
|
124
|
Invalid transation_info
|
125
|
Invalid quantity
|
126
|
Invalid order_description
|
127
|
Invalid affiliate_code
|
128
|
Invalid time_limit
|
129
|
Invalid buyer_fullname
|
130
|
Invalid buyer_email
|
131
|
Invalid buyer_mobile
|
132
|
Invalid buyer_address
|
133
|
Invalid total_item
|
134
|
Invalid payment_method, bank_code
|
135
|
Error connect to the bank
|
140
|
can’t pay the installment payment
|
Skype: nganluong_sup_tech
Mail: hotrokythuat@nganluong.vn
Chia sẻ với bạn bè của bạn: |