NICEPAY Inquiry Virtual Account

23min

Tentang API NICEPAY Inquiry Virtual Account
﻿
Integrasi ﻿ digunakan untuk ﻿ ﻿ tipe NICEPAY Inquiry Virtual Account. Pada ﻿ ini, data ﻿ berada di sisi ﻿. Sehingga, pada setiap ﻿ dari ﻿, ﻿ membutuhkan inquiry data ﻿, konfirmasi ﻿, dan melakukan request ﻿ ke ﻿.
﻿
Alur NICEPAY Inquiry Virtual Account
﻿
Flow NICEPAY Inquiry Virtual Account
﻿
﻿
Inquiry Process NICEPAY to Merchant
﻿
Proses ini bertujuan untuk mengetahui rincian tagihan. Setelah ﻿ mendapatkan permintaan inquiry dari ﻿, ﻿ akan menggunakan Merchant service untuk mendapatkan ﻿ rincian data ﻿. Kemudian, data tersebut akan tersimpan dalam riwayat internal sistem ﻿ dan akan dikirim ke ﻿ menggunakan format response ﻿ inquiry.
API URL
https:// < merchant URL for inquiry >
Request Method 
﻿POST (Body Raw JSON)﻿
Merchant Token
-
Request Format
-
﻿
Inquiry Request Parameter 
﻿
Berikut ini adalah daftar ﻿ untuk melakukan ﻿ Inquiry ﻿ kepada ﻿ dari ﻿ ﻿ dilakukan pada ﻿ ﻿ tipe NICEPAY Inquiry Virtual Account. Parameter ini digunakan melalui platform pengujian ﻿ sebagai salah satu tahapan supaya ﻿ milik ﻿ dapat terhubung dengan ﻿ dari ﻿.  
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
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 
﻿
Berikut adalah response ﻿ dari hasil request ﻿ untuk ﻿ Inquiry ﻿ kepada ﻿. 
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
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 adalah tahap untuk melanjutkan ﻿ ﻿ ﻿ dilakukan ﻿. Saat ﻿ melakukan payment request ke ﻿ menggunakan nomor ﻿, ﻿ akan memanggil Merchant payment URL service untuk ﻿ ﻿. ﻿ menentukan response payment untuk menerima atau menolak ﻿ dari ﻿.
API End Point
https:// < ﻿ URL for ﻿  >
Method 
﻿POST (Body Raw JSON)﻿
﻿
Payment Request Parameter 
﻿
Berikut ini adalah daftar ﻿ untuk melakukan Payment Process NICEPAY to Merchant dari ﻿ ﻿ dilakukan pada ﻿ ﻿ tipe NICEPAY Inquiry Virtual Account. Parameter ini digunakan melalui platform pengujian ﻿ sebagai salah satu tahapan supaya ﻿ milik ﻿ dapat terhubung dengan ﻿ dari ﻿.  
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
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 
﻿
Berikut adalah response parameter dari hasil request ﻿ untuk Payment Process NICEPAY to Merchant. 
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
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 adalah ﻿ pengembalian dana ﻿ terjadi akibat terjadi isu di dalam internal ﻿ ﻿. Pada ﻿ ini, ﻿ akan melanjutkan ﻿ ﻿ ﻿ didapat dari ﻿ kepada ﻿.
API End Point
https:// < ﻿ URL for reversal >
Method 
﻿POST (Body Raw JSON)﻿
﻿
Process Flow
Proses Reversal VA 
﻿
﻿
Reversal Request Parameter 
﻿
Berikut ini adalah daftar ﻿ untuk melakukan Reversal Process NICEPAY to Merchant dari ﻿ ﻿ dilakukan pada ﻿ ﻿ tipe NICEPAY Inquiry Virtual Account. Parameter ini digunakan melalui platform pengujian ﻿ sebagai salah satu tahapan supaya ﻿ milik ﻿ dapat terhubung dengan ﻿ dari ﻿.  
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
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 
﻿
Berikut adalah response ﻿ dari hasil request ﻿ untuk Reversal Process NICEPAY to Merchant. 
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
billingNm
N
100
﻿﻿ Name
John Doe
﻿
Top-Up Amount 
Only
goodsNm
AN
100
Goods/Item Name
Testing Reversal Transaction
﻿
Top-Up 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﻿ untuk mengetahui ﻿ untuk memeriksa ﻿ inquiry khusus ﻿.
﻿﻿ ﻿ Cancel - API Checkout﻿ untuk mengetahui ﻿ untuk membatalkan ﻿ khusus ﻿.
﻿﻿ ﻿ Status Inquiry - API Virtual Account﻿ untuk mengetahui ﻿ ﻿ untuk memeriksa ﻿ inquiry pada ﻿ khusus ﻿.
﻿﻿ ﻿ Cancel - API Virtual Account﻿ untuk mengetahui ﻿ ﻿ untuk membatalkan ﻿ pada ﻿ khusus ﻿.

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

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
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	Tipe	Ukuran	Deskripsi	Contoh / Catatan
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	Tipe	Ukuran	Deskripsi	Contoh / Catatan
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	Tipe	Ukuran	Deskripsi	Contoh / Catatan
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	Tipe	Ukuran	Deskripsi	Contoh / Catatan
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	Tipe	Ukuran	Deskripsi	Contoh / Catatan
billingNm	N	100	Name	John Doe Top-Up Amount Only
goodsNm	AN	100	Goods/Item Name	Testing Reversal Transaction Top-Up 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

Tentang API NICEPAY Inquiry Virtual Account

Alur NICEPAY Inquiry Virtual Account

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

Selamat Datang di NICEPAY DOCS