NICEPAY Inquiry Virtual Account

23 min

About API NICEPAY Inquiry Virtual Account
﻿
Bulk ﻿ uses for ﻿ NICEPAY Inquiry Virtual Account type ﻿. In this ﻿, ﻿s maintain ﻿ data. So, every ﻿ from a ﻿, ﻿ requires ﻿ data inquiry to ﻿ ﻿. Also included for ﻿ confirmation, ﻿ makes a ﻿ request to ﻿ ﻿.
﻿
NICEPAY Inquiry Virtual Account Flow
﻿
﻿
Flow NICEPAY Inquiry Virtual Account
﻿
﻿
Inquiry Process NICEPAY to Merchant
﻿
This ﻿ aims to find out ﻿ details of ﻿ bill. After ﻿ gets an inquiry request from ﻿ ﻿. ﻿ will call ﻿ ﻿ ﻿ to get detailed ﻿ data ﻿. Then, ﻿ data will be stored in ﻿ internal history of ﻿ ﻿ ﻿ and sent to ﻿ ﻿ using ﻿ inquiry ﻿ response format.
API URL
https:// < merchant URL for inquiry >
Request Method 
﻿POST (Body Raw JSON)﻿
Merchant Token
-
Request Format
-
﻿
Inquiry Request Parameter 
﻿
The following is a list of ﻿s to ﻿ ﻿ ﻿ Inquiry ﻿ to ﻿ ﻿ from ﻿ executed ﻿ on ﻿'s NICEPAY Inquiry Virtual Account type ﻿. This ﻿ uses through ﻿ ﻿ ﻿ platform as one of ﻿ stages so that ﻿ ﻿'s ﻿ can connect with ﻿s from ﻿.
Parameter
Type
Size
Description
Example / Notes
customerId
N
9
﻿﻿ ID
891011101
merchantToken
AN
255
SHA256 (Merchant ID + Customer ID + Merchant Key)
141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b
prefix
N
7
﻿﻿ Prefix Number
7015102
bankCd
AN
4
﻿Bank Code﻿ 
"CENA
﻿
Inquiry Response Parameter 
﻿
Following are ﻿ response ﻿s from ﻿ results of ﻿ request ﻿s for ﻿ ﻿ to ﻿ Inquiry Process.
Parameter
Type
Size
Description
Example / Notes
billingNm
N
100
﻿﻿ Name
John Doe
goodsNm
AN
100
Goods/Item name
Testing Buying
referenceNo
N
40
Reference Number for ﻿ 
ordNo20221130101148
amt
AN
12
Total Bill Amount 
5000
﻿
Normal Amount 
Only
resultCd
N
4
﻿Result Code﻿ of Inquiry Status
0000
resultMsg
AN
255
Result Message for ﻿ Result Code﻿﻿
SUCCESS
﻿
Sample JSON Inquiry Process Nicepay to Merchant
﻿
JSON Request
JSON Response
Java Request
{
    "resultCd" : "0000",
    "resultMsg" : "SUCCESS",
    "billingNm" : "John Doe",
    "goodsNm" : "Testing Buying",
    "referenceNo" : "ordNo20221130101148",
    "amt" : "5000"
}
{
    "resultCd" : "0000",
    "resultMsg" : "SUCCESS",
    "billingNm" : "John Doe",
    "goodsNm" : "Testing Buying",
    "referenceNo" : "ordNo20221130101148",
    "amt" : "5000"
}
﻿
﻿
Payment Process NICEPAY to Merchant
﻿
Payment Process NICEPAY to Merchant is ﻿ stage to continue ﻿ ﻿ ﻿ made by ﻿ ﻿. When ﻿ ﻿ makes a ﻿ request to ﻿ using a ﻿ number, ﻿ will call ﻿ ﻿ ﻿ URL ﻿ to ﻿ ﻿ ﻿. The ﻿ determines ﻿ ﻿ response to accept or reject ﻿s from ﻿s.
API End Point
https:// < ﻿ URL for ﻿  >
Method 
﻿POST (Body Raw JSON)﻿
﻿
Payment Request Parameter 
﻿
The following is a list of ﻿s for ﻿ ﻿ NICEPAY to Merchant Payment Process from ﻿s made on ﻿ ﻿'s NICEPAY Inquiry Virtual Account type ﻿. This ﻿ is used through ﻿ ﻿ ﻿ platform as one of ﻿ stages so that ﻿ ﻿'s ﻿ can be connected to ﻿s from ﻿.
Parameter
Type
Size
Description
Example / Notes
customerId
N
9
﻿﻿ ID
110000001
merchantToken
AN
255
SHA256 (Merchant ID + Customer ID + amt + Merchant Key)
141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b
referenceNo
AN
40
Reference Number From Inquiry
OrdNo202210102323223
prefix
N
7
﻿﻿ Prefix Number
7015102
bankCd
AN
4
﻿Bank Code﻿ 
CENA
amt
N
12
Total Bill Amount 
10000
tXid
AN
30
Transaction ID from ﻿ 
NORMALTEST02202211301010513135
﻿
Payment Response Parameter 
﻿
Following are ﻿ response ﻿s from ﻿ results of ﻿ request ﻿s for ﻿ NICEPAY to Merchant Payment Process.
Parameter
Type
Size
Description
Example / Notes
billingNm
N
100
﻿﻿ Name
John Doe
goodsNm
AN
255
Goods/Item name
Testing Buying
referenceNo
N
7
Reference Number for ﻿ 
ordNo2022113010114
amt
AN
4
Total Bill Amount 
Normal amount 
only
resultCd
﻿
4
﻿Result Code﻿ of Inquiry Status
0000
resultMsg
AN
255
Result Message for ﻿ Result Code﻿﻿
SUCCESS
﻿
Sample JSON Payment Process NICEPAY to Merchant
﻿
JSON Request
JSON Response
Java Request
{
    "resultCd" : "0000",
    "resultMsg" : "SUCCESS",
    "billingNm" : "John Doe",
    "goodsNm" : "Testing Buying",
    "referenceNo" : "ordNo20221130101148",
    "amt" : "10000"
}
{
    "resultCd" : "0000",
    "resultMsg" : "SUCCESS",
    "billingNm" : "John Doe",
    "goodsNm" : "Testing Buying",
    "referenceNo" : "ordNo20221130101148",
    "amt" : "10000"
}
﻿
﻿
Reversal Process NICEPAY to Merchant
﻿
Reversal Process NICEPAY to Merchant is a refund ﻿ that occurs caused of an issue happen from internal ﻿ ﻿. In this ﻿, ﻿ will continue ﻿ ﻿ ﻿ receive from ﻿ to ﻿ ﻿.
API End Point
https:// < ﻿ URL for reversal>
Method 
﻿POST (Body Raw JSON)﻿
﻿
Process Flow
Proses Reversal VA 
﻿
﻿
Reversal Request Parameter 
﻿
The following is a list of ﻿s for performing ﻿ NICEPAY to Merchant Reversal Process from ﻿s made to ﻿ NICEPAY Inquiry Virtual Account type ﻿ ﻿. This ﻿ is used through ﻿ ﻿ ﻿ platform as one of ﻿ stages so that ﻿ ﻿'s ﻿ can connect with ﻿s from ﻿.
Parameter
Type
Size
Description
Example / Notes
customerId
N
9
﻿﻿ ID
110000001
merchantToken
AN
255
SHA256 (Merchant ID + Customer ID + amt + Merchant Key)
141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b
referenceNo
AN
40
Reference Number from Inquiry
OrdNo202210102323223
prefix
N
7
﻿﻿ Prefix Number
7015102
bankCd
AN
4
﻿Bank Code﻿ 
CENA
amt
N
12
Total Bill Amount 
10000
tXid
AN
30
Transaction ID from ﻿ 
NORMALTEST02202211301010513135
﻿
Reversal Response Parameter 
﻿
Following are ﻿ response ﻿s from ﻿ results of ﻿ request ﻿s for ﻿ NICEPAY to Merchant Reversal Process.
Parameter
Type
Size
Description
Example / Notes
billingNm
N
100
﻿﻿ Name
John Doe
﻿
Topup mount 
only
goodsNm
AN
100
Goods/Item Name
Testing Reversal Transaction
﻿
Topup amount 
only
referenceNo
N
40
Reference Number for ﻿ 
OrdNo202210102323223
amt
AN
12
Total Bill Amount 
50000
resultCd
﻿
34
Result Code of Inquiry Status Result Code﻿ 
0000
resultMsg
﻿
255
Result Message for ﻿ Result Code﻿﻿
SUCCESS
﻿
Sample JSON Reversal Process NICEPAY to Merchant
﻿
JSON Request
JSON Response
Java Request
{
    "resultCd" : "0000",
    "resultMsg" : "SUCCESS",
    "billingNm" : "John Doe",
    "referenceNo" : "OrdNo202210102323223",
    "goodsNm" : "Testing Reversal Transaction",
    "amt" : "50000"
}
{
    "resultCd" : "0000",
    "resultMsg" : "SUCCESS",
    "billingNm" : "John Doe",
    "referenceNo" : "OrdNo202210102323223",
    "goodsNm" : "Testing Reversal Transaction",
    "amt" : "50000"
}
﻿
﻿
See also
﻿﻿ ﻿ Status Inquiry - API Checkout﻿ ﻿ to find out ﻿ to check ﻿ inquiry specific for ﻿.
﻿﻿ ﻿ Cancel - API Checkout﻿ ﻿ to find out ﻿ to cancel ﻿ specific for ﻿ .
﻿﻿ ﻿ Status Inquiry - API Virtual Account﻿ ﻿ to find out ﻿ ﻿ ﻿ to check ﻿ inquiry on ﻿ specific for ﻿.
﻿﻿ ﻿ Cancel - API Virtual Account﻿ ﻿ to find out ﻿ ﻿ to cancel ﻿ ﻿ on ﻿ specific for ﻿.
﻿

API URL	https:// < merchant URL for inquiry >
Request Method	POST (Body Raw JSON)
Merchant Token	-
Request Format	-

Parameter	Type	Size	Description	Example / Notes
customerId	N	9	ID	891011101
merchantToken	AN	255	SHA256 (Merchant ID + Customer ID + Merchant Key)	141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b
prefix	N	7	Prefix Number	7015102
bankCd	AN	4	Bank Code	"CENA

Parameter	Type	Size	Description	Example / Notes
billingNm	N	100	Name	John Doe
goodsNm	AN	100	Goods/Item name	Testing Buying
referenceNo	N	40	Reference Number for	ordNo20221130101148
amt	AN	12	Total Bill Amount	5000 Normal Amount Only
resultCd	N	4	Result Code of Inquiry Status	0000
resultMsg	AN	255	Result Message for Result Code	SUCCESS

API End Point	https:// < URL for >
Method	POST (Body Raw JSON)

Parameter	Type	Size	Description	Example / Notes
customerId	N	9	ID	110000001
merchantToken	AN	255	SHA256 (Merchant ID + Customer ID + amt + Merchant Key)	141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b
referenceNo	AN	40	Reference Number From Inquiry	OrdNo202210102323223
prefix	N	7	Prefix Number	7015102
bankCd	AN	4	Bank Code	CENA
amt	N	12	Total Bill Amount	10000
tXid	AN	30	Transaction ID from	NORMALTEST02202211301010513135

Parameter	Type	Size	Description	Example / Notes
billingNm	N	100	Name	John Doe
goodsNm	AN	255	Goods/Item name	Testing Buying
referenceNo	N	7	Reference Number for	ordNo2022113010114
amt	AN	4	Total Bill Amount	Normal amount only
resultCd		4	Result Code of Inquiry Status	0000
resultMsg	AN	255	Result Message for Result Code	SUCCESS

API End Point	https:// < URL for reversal>
Method	POST (Body Raw JSON)

Parameter	Type	Size	Description	Example / Notes
customerId	N	9	ID	110000001
merchantToken	AN	255	SHA256 (Merchant ID + Customer ID + amt + Merchant Key)	141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b
referenceNo	AN	40	Reference Number from Inquiry	OrdNo202210102323223
prefix	N	7	Prefix Number	7015102
bankCd	AN	4	Bank Code	CENA
amt	N	12	Total Bill Amount	10000
tXid	AN	30	Transaction ID from	NORMALTEST02202211301010513135

Parameter	Type	Size	Description	Example / Notes
billingNm	N	100	Name	John Doe Topup mount only
goodsNm	AN	100	Goods/Item Name	Testing Reversal Transaction Topup amount only
referenceNo	N	40	Reference Number for	OrdNo202210102323223
amt	AN	12	Total Bill Amount	50000
resultCd		34	Result Code of Inquiry Status Result Code	0000
resultMsg		255	Result Message for Result Code	SUCCESS

Virtual Account Static

Inquiry List API

NICEPAY Inquiry Virtual Account

About API NICEPAY Inquiry Virtual Account

NICEPAY Inquiry Virtual Account Flow

Inquiry Process NICEPAY to Merchant

Inquiry Request Parameter

Inquiry Response Parameter

Sample JSON Inquiry Process Nicepay to Merchant

Payment Process NICEPAY to Merchant

Payment Request Parameter

Payment Response Parameter

Sample JSON Payment Process NICEPAY to Merchant

Reversal Process NICEPAY to Merchant

Process Flow

Reversal Request Parameter

Reversal Response Parameter

Sample JSON Reversal Process NICEPAY to Merchant

See also

Welcome to NICEPAY DOCS