Authentication

10min

Proses Authentication
﻿
Authentication merupakan prosedur keamanan ﻿ untuk mengenali identitas dari suatu request asing. Apabila identitas tersebut sudah dikenali oleh ﻿, maka request tersebut dapat mengakses ﻿ tersebut.
Dalam hal ini, ﻿ membutuhkan identitas ﻿ Key terlebih dahulu ﻿ disebut merchantKey dari request ﻿, sehingga ﻿ dapat terhubung dengan ﻿ tanpa hambatan apapun. Selain merchantKey, ﻿ juga dibutuhkan untuk mengirim mandatory parameter, yaitu merchantToken.
﻿
Merchant Key
﻿﻿ Key terbagi menjadi dua tipe, yaitu Sandbox Credentials dan Production Credentials.
Sandbox Credentials
Apabila ﻿ ingin melakukan uji coba ﻿ kami terlebih dahulu sebelum melakukan ﻿ ﻿ dengan ﻿, silakan menggunakan kredensial ﻿ telah disediakan di bawah ini dengan menggunakan iMid IONPAYTEST. 
iMid merupakan identitas atau ID ﻿ sebagai ﻿ pada ﻿. iMid ﻿ hanya dikhususkan untuk penggunaan ﻿ ﻿ akan diberikan setelah ﻿ resmi terdaftar sebagai ﻿ kami. 
Untuk melakukan ﻿, silakan memakai iMid IONPAYTEST dan memakai ﻿ Key khusus tersebut di Sandbox Credentials.


iMid 
﻿(Merchant ID)﻿
IONPAYTEST
(AutoPaid)
merchantKey
33F49GnCMS1mFYlGXisbUDzVf2ATWCl9k3R++d5hDd3Frmuos/XLx8XhXpe+LDYAbpGKZYSwtlyyLOtS/8aD7A==
Kredensial di atas disediakan hanya untuk keperluan ﻿ serta ﻿ ﻿ akan dibuat berhasil secara otomatis (AutoPaid).
Production/Live Credentials
Apabila ﻿ sudah resmi terdaftar menjadi ﻿ ﻿ dan ingin melakukan tahap ﻿ dengan ﻿ nyata, ﻿ dapat melihat merchantKey yang kami buatkan khusus dengan iMid ﻿ di dalam portal Merchant Back Office﻿.
Berikut langkah untuk mendapatkan merchantKey:
Akses dashboard Merchant Back Office ﻿.
﻿﻿ ﻿ Profile﻿.
﻿﻿ ﻿ Merchant Data﻿.
﻿﻿ tab Other.
Scroll ke bawah untuk mendapatkan merchantKey ﻿.
Panduan Melihat M_KEY / Merchant Key
﻿
Jangan lupa untuk mencantumkan ﻿ iMid sesuai dengan iMid ﻿ terdaftar untuk ﻿ ﻿ saat melakukan ﻿ dengan kami.
﻿
Merchant Token
MerchantToken digunakan ﻿ untuk melakukan ﻿ autentikasi keamanan dengan ﻿ ﻿. Parameter ini dibuat dengan menggunakan metode hashing SHA-256 ﻿ sudah termasuk ﻿ iMid, merchantKey, serta variabel lain ﻿ dibutuhkan. Berikut detail dari ﻿ Token.
JS
//Generate merchantToken//
merchantData = timeStamp + iMid + refNo + amount + merchantKey;
merTok = CryptoJS.SHA256(merchantData).toString(CryptoJS.enc.Hex);

Sample:

merchantData = 20221202101271 + IONPAYTEST + OrdNo-20221202101271 + 100000 + 33F49GnCMS1mFYlGXisbUDzVf2ATWCl9k3R++d5hDd3Frmuos/XLx8XhXpe+LDYAbpGKZYSwtlyyLOtS/8aD7A==
merTok = d7c10cfccd64fdb21836f4330bb23f9ed357bc4b02420399d48b4661b89a55a0
//Generate merchantToken//
merchantData = timeStamp + iMid + refNo + amount + merchantKey;
merTok = CryptoJS.SHA256(merchantData).toString(CryptoJS.enc.Hex);

Sample:

merchantData = 20221202101271 + IONPAYTEST + OrdNo-20221202101271 + 100000 + 33F49GnCMS1mFYlGXisbUDzVf2ATWCl9k3R++d5hDd3Frmuos/XLx8XhXpe+LDYAbpGKZYSwtlyyLOtS/8aD7A==
merTok = d7c10cfccd64fdb21836f4330bb23f9ed357bc4b02420399d48b4661b89a55a0
﻿
Parameter
Tipe
Ukuran
Deskripsi
timeStamp 
N
14
Transaction Timestamp (YYYYMMDDHHMMSS)
iMid 
AN
10
﻿﻿ ID
refNo 
ANS
40
﻿﻿'s Reference Number
amount 
N
12
Amount
merchantKey
ANS
88
﻿﻿ Key
﻿
NICEPAY API URL
Berikut ﻿ ﻿ URL ﻿ dapat ﻿ gunakan sesuai dengan kebutuhan ﻿. URL ini harus di-request melalui protokol HTTPS agar dapat terhubung dengan kami.
Environment
Protocol
Base URL
Development
https
https://dev.nicepay.co.id/
Staging
https
https://staging.nicepay.co.id/
Production
https
https://www.nicepay.co.id/
﻿
Uji Coba Metode Pembayaran
Setelah ﻿ mendapatkan semua keperluan autentikasi agar dapat berinteraksi dengan ﻿ kami, silakan kunjungi laman di bawah ini untuk uji ﻿ dengan ﻿ kami.
Metode Pembayaran
Kredensial
﻿﻿ 
﻿Integrasi & Testing Kartu Kredit﻿﻿
﻿﻿ 
﻿Integrasi & Testing VA﻿﻿
﻿﻿ 
﻿Integrasi & Testing CVS﻿﻿
﻿﻿ 
﻿Integrasi & Testing Direct Debit﻿﻿
﻿﻿ 
﻿Integrasi & Testing E-Wallet﻿﻿
﻿﻿ 
﻿Integrasi & Testing Payloan﻿﻿
﻿﻿ 
﻿Integrasi & Testing GPN﻿﻿
﻿﻿ 
﻿Integrasi & Testing QRIS﻿﻿
﻿﻿ 
﻿Integrasi & Testing Payout﻿﻿
﻿
See also
﻿﻿ ﻿ Postman Collection﻿ untuk mengetahui cara uji coba ﻿ ﻿ dengan menggunakan Postman.
﻿﻿ ﻿ NICEPAY Library﻿ untuk mengetahui SDK ﻿ digunakan pada ﻿.

iMid (Merchant ID)	IONPAYTEST (AutoPaid)
merchantKey	33F49GnCMS1mFYlGXisbUDzVf2ATWCl9k3R++d5hDd3Frmuos/XLx8XhXpe+LDYAbpGKZYSwtlyyLOtS/8aD7A==

Parameter	Tipe	Ukuran	Deskripsi
timeStamp	N	14	Transaction Timestamp (YYYYMMDDHHMMSS)
iMid	AN	10	ID
refNo	ANS	40	's Reference Number
amount	N	12	Amount
merchantKey	ANS	88	Key

Environment	Protocol	Base URL
Development	https	https://dev.nicepay.co.id/
Staging	https	https://staging.nicepay.co.id/
Production	https	https://www.nicepay.co.id/

Metode Pembayaran	Kredensial
	Integrasi & Testing Kartu Kredit
	Integrasi & Testing VA
	Integrasi & Testing CVS
	Integrasi & Testing Direct Debit
	Integrasi & Testing E-Wallet
	Integrasi & Testing Payloan
	Integrasi & Testing GPN
	Integrasi & Testing QRIS
	Integrasi & Testing Payout

API Versi 2

Checkout API

Authentication

Proses Authentication

Merchant Key

Sandbox Credentials

Production/Live Credentials

Merchant Token

NICEPAY API URL

Uji Coba Metode Pembayaran

See also

Selamat Datang di NICEPAY DOCS