Registration - API Convenience Store

10min

Tentang API Convenience Store Registration 
﻿

﻿ menyediakan Toserba (Indomaret dan Alfamart Group) sebagai 
﻿ sehingga 
﻿ dapat melakukan 
﻿ melalui gerai-gerai 
﻿ Toserba di Seluruh 
﻿. Notifikasi real-time secara langsung akan dikirimkan ketika 
﻿ berhasil.
﻿
﻿ Toserba 
﻿:
Alfamart
Indomaret
Lawson
Alfamidi
Dan+Dan Store
﻿
API Convenience Store Registration 
﻿
﻿
﻿ ini digunakan untuk mengaktifkan 
﻿ 
﻿ pada 
﻿, sehingga 
﻿ dapat melakukan 
﻿ 
﻿ menggunakan 
﻿ dengan 
﻿. Tahapan ini digunakan untuk mengintegrasikan 
﻿ dari 
﻿ dengan 
﻿ dari 
﻿. 
API Endpoint
/nicepay/direct/v2/registration
Request Method
﻿POST﻿
Description
Performs Transaction Regist to 
﻿
Merchant Token
SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Request Format
application/json
﻿
﻿ kunjungi 
﻿ NICEPAY Code﻿ untuk mengetahui daftar istilah kode 
﻿ berhubungan dengan 
﻿ 
﻿.
﻿
Request Parameter for Convenience Store Registration
﻿

Berikut ini adalah daftar 
﻿ untuk melakukan request registrasi 
﻿ 
﻿. Parameter ini digunakan melalui platform pengujian 
﻿ sebagai salah satu tahapan supaya 
﻿ milik 
﻿ dapat terhubung dengan 
﻿ dari 
﻿.  
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
timeStamp
﻿Required﻿
N
14
Request Timestamp (YYYYMMDDHH24MISS)
20221202152801
iMid
﻿Required﻿
AN
10
﻿
﻿ ID	
﻿
IONPAYTEST
payMethod
﻿Required﻿
N
2
﻿Payment Method Code﻿ 
03
currency
﻿Required﻿
A
3
Currency
﻿
IDR
amt 
﻿Required﻿
N
12
Amount
﻿
5000
referenceNo
﻿Required﻿
ANS
40
﻿
﻿'s Reference Number
﻿
Order12345
goodsNm  ﻿
﻿Required﻿
AN
100
Goods Name	
Test Transaction 
﻿
billingNm
﻿Required﻿
A
100
Buyer Name	
﻿
John Doe
billingPhone 
﻿Required﻿
N
15
Buyer Phone Number	
﻿
081214714045
billingEmail 
﻿Required﻿
ANS
40
Buyer E-Mail	
﻿
[email protected]
billingAddr 
﻿Required﻿
AN
100
Buyer Address	
﻿
Jalan Bukit Berbunga 22
billingCity 
﻿Required﻿
A
50
Buyer City	
﻿
Jakarta
billingState 
﻿Required﻿
A
50
Billing State	
﻿
DKI Jakarta
billingPostCd 
﻿Required﻿
N
10
Billing Post Number	
﻿
12345
billingCountry 
﻿Required﻿
A
10
Billing Country	
﻿
﻿
﻿ 
cartData
JSONstring
4000
Cart Data
﻿
mitraCd
﻿Required ﻿
A
4
﻿Mitra Code﻿  
﻿
ALMA
userIP 
AN
15
User IP

127.0.0.1
dbProcessUrl
﻿Required﻿
ANS
255
Notification URL	
https://ptsv2.com/t/test-nicepay-v2
merchantToken
﻿Required﻿
﻿
AN
255
﻿
﻿ Token	
﻿
fa79a58a73bf9f6d07ce84daaabb8f23da6ca61d478d4e917d2e259d5c7e1106
deliveryNm
A
30
Delivery Name	
﻿
﻿@merchant.com
deliveryPhone
N
15
Delivery Phone	
12345678
deliveryAddr
AN
100
Delivery Address	
Jalan Bukit Berbunga 22
deliveryCity
A
50
Delivery City	
Jakarta
deliveryState
A
50
Delivery State	
DKI Jakarta
deliveryPostCd
N
10
Delivery Post Code	
12345
deliveryCountry
A
10
Delivery Country	
﻿
﻿ 
description
AN
100
Transaction Description	
-
reqDomain
ANS
100
Request Domain	
merchant.com
reqServerIP
ANS
15
Request Server IP	
127.0.0.1
reqClientVer
ANS
50
Client Version	
-
userSessionID
AN
100
User Session ID	
697D6922C961070967D3BA1BA5699C2C
﻿
﻿ kunjungi 
﻿ Convenience Store (CVS)﻿ untuk mempelajari 
﻿ umum mengenai 
﻿ 
﻿. 
﻿
Additional Information Request for Convenience Store Registration
﻿
Parameter di bawah berisi 
﻿ tambahan mengenai 
﻿ Registrasi 
﻿.
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
payMethod
﻿Required﻿
N
2
﻿Payment Method Code﻿﻿
03
mitraCd
﻿Required﻿
A
4
﻿
﻿ ID	
﻿
IONPAYTEST
payValidDt
﻿Required﻿
N
8
CVS Expiry Date (YYYYMMDD)
20221212
payValidTm
﻿Required﻿
N
6
CVS Expiry Time (HH24MISS)
201012
﻿
Response Parameter for Convenience Store Registration
﻿
Berikut ini adalah daftar response dari request 
﻿ inquiry pada 
﻿ 
﻿ 
﻿. 
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
resultCd 
N
14
﻿Result Code﻿ 
0000
resultMsg 
﻿
AN
255
Result Message: Error Code﻿ 
SUCCESS
tXid
AN
30
Transaction ID
IONPAYTEST03202212021529034686
referenceNo
ANS
40
﻿
﻿ Reference Number
Order12345
payMethod 
N
2
﻿Payment Method Code﻿ 
03
amt
N
12
﻿
﻿ Amount
5000
transDt ﻿
N
8
Transaction Date (YYYYMMDD)
20221202
transTm
N
6
Transaction Time (HH24MISS)
152903
description
AN
100
Description
null
bankCd
AN
4
﻿Bank Code﻿ 
null
vacctNo
N
20
VA Number
null
mitraCd
AN
4
﻿Mitra Code﻿ 
ALMA
payNo
N
12
﻿
﻿ Number
9041021529034686
currency
AN
3
Currency
null
goodsNm
AN
100
Goods Name
null
billingNm
A
100
Buyer Name
null
vacctValidDt
N
8
VA Expiry Date (YYYYMMDD)
null
vacctValidTm
N
6
VA Expiry Time (HH24MISS)
null
payValidDt
N
8
Expiry Date (YYYYMMDD)
 null
payValidTm 
N
6
Expiry Time (HH24MISS)
null
requestURL
ANS
360
Request URL
null
paymentExpDt
N
8
QR 
﻿ Expiry Date (YYYYMMDD)
null
paymentExpTm
N
6
QR 
﻿ Expiry Time (HH24MISS)
null
qrContent
ANS
360
QR String in Plain Text	
null
qrUrl
ANS
360
URL for QR Image, Valid for 5 minutes	
null
﻿
Sample JSON for Convenience Store Registration
﻿
JSON Request
JSON Response
Java Request
{
    "resultCd": "0000",
    "resultMsg": "SUCCESS",
    "tXid": "IONPAYTEST03202212021529034686",
    "referenceNo": "Order12345",
    "payMethod": "03",
    "amt": "5000",
    "transDt": "20221202",
    "transTm": "152903",
    "description": null,
    "bankCd": null,
    "vacctNo": null,
    "mitraCd": "ALMA",
    "payNo": "9041021529034686",
    "currency": null,
    "goodsNm": null,
    "billingNm": null,
    "vacctValidDt": null,
    "vacctValidTm": null,
    "payValidDt": "20221209",
    "payValidTm": "235959",
    "requestURL": null,
    "paymentExpDt": null,
    "paymentExpTm": null,
    "qrContent": null,
    "qrUrl": null
}
{
    "resultCd": "0000",
    "resultMsg": "SUCCESS",
    "tXid": "IONPAYTEST03202212021529034686",
    "referenceNo": "Order12345",
    "payMethod": "03",
    "amt": "5000",
    "transDt": "20221202",
    "transTm": "152903",
    "description": null,
    "bankCd": null,
    "vacctNo": null,
    "mitraCd": "ALMA",
    "payNo": "9041021529034686",
    "currency": null,
    "goodsNm": null,
    "billingNm": null,
    "vacctValidDt": null,
    "vacctValidTm": null,
    "payValidDt": "20221209",
    "payValidTm": "235959",
    "requestURL": null,
    "paymentExpDt": null,
    "paymentExpTm": null,
    "qrContent": null,
    "qrUrl": null
}
﻿
﻿

API Endpoint	/nicepay/direct/v2/registration
Request Method	POST
Description	Performs Transaction Regist to
Merchant Token	SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Request Format	application/json

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
timeStamp Required	N	14	Request Timestamp (YYYYMMDDHH24MISS)	20221202152801
iMid Required	AN	10	ID	IONPAYTEST
payMethod Required	N	2	Payment Method Code	03
currency Required	A	3	Currency	IDR
amt Required	N	12	Amount	5000
referenceNo Required	ANS	40	's Reference Number	Order12345
goodsNm Required	AN	100	Goods Name	Test Transaction
billingNm Required	A	100	Buyer Name	John Doe
billingPhone Required	N	15	Buyer Phone Number	081214714045
billingEmail Required	ANS	40	Buyer E-Mail	[email protected]
billingAddr Required	AN	100	Buyer Address	Jalan Bukit Berbunga 22
billingCity Required	A	50	Buyer City	Jakarta
billingState Required	A	50	Billing State	DKI Jakarta
billingPostCd Required	N	10	Billing Post Number	12345
billingCountry Required	A	10	Billing Country
cartData	JSONstring	4000	Cart Data
mitraCd Required	A	4	Mitra Code	ALMA
userIP	AN	15	User IP	127.0.0.1
dbProcessUrl Required	ANS	255	Notification URL	https://ptsv2.com/t/test-nicepay-v2
merchantToken Required	AN	255	Token	fa79a58a73bf9f6d07ce84daaabb8f23da6ca61d478d4e917d2e259d5c7e1106
deliveryNm	A	30	Delivery Name	@merchant.com
deliveryPhone	N	15	Delivery Phone	12345678
deliveryAddr	AN	100	Delivery Address	Jalan Bukit Berbunga 22
deliveryCity	A	50	Delivery City	Jakarta
deliveryState	A	50	Delivery State	DKI Jakarta
deliveryPostCd	N	10	Delivery Post Code	12345
deliveryCountry	A	10	Delivery Country
description	AN	100	Transaction Description	-
reqDomain	ANS	100	Request Domain	merchant.com
reqServerIP	ANS	15	Request Server IP	127.0.0.1
reqClientVer	ANS	50	Client Version	-
userSessionID	AN	100	User Session ID	697D6922C961070967D3BA1BA5699C2C

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
payMethod Required	N	2	Payment Method Code	03
mitraCd Required	A	4	ID	IONPAYTEST
payValidDt Required	N	8	CVS Expiry Date (YYYYMMDD)	20221212
payValidTm Required	N	6	CVS Expiry Time (HH24MISS)	201012

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
resultCd	N	14	Result Code	0000
resultMsg	AN	255	Result Message: Error Code	SUCCESS
tXid	AN	30	Transaction ID	IONPAYTEST03202212021529034686
referenceNo	ANS	40	Reference Number	Order12345
payMethod	N	2	Payment Method Code	03
amt	N	12	Amount	5000
transDt	N	8	Transaction Date (YYYYMMDD)	20221202
transTm	N	6	Transaction Time (HH24MISS)	152903
description	AN	100	Description	null
bankCd	AN	4	Bank Code	null
vacctNo	N	20	VA Number	null
mitraCd	AN	4	Mitra Code	ALMA
payNo	N	12	Number	9041021529034686
currency	AN	3	Currency	null
goodsNm	AN	100	Goods Name	null
billingNm	A	100	Buyer Name	null
vacctValidDt	N	8	VA Expiry Date (YYYYMMDD)	null
vacctValidTm	N	6	VA Expiry Time (HH24MISS)	null
payValidDt	N	8	Expiry Date (YYYYMMDD)	null
payValidTm	N	6	Expiry Time (HH24MISS)	null
requestURL	ANS	360	Request URL	null
paymentExpDt	N	8	QR Expiry Date (YYYYMMDD)	null
paymentExpTm	N	6	QR Expiry Time (HH24MISS)	null
qrContent	ANS	360	QR String in Plain Text	null
qrUrl	ANS	360	URL for QR Image, Valid for 5 minutes	null

Updated 05 Sep 2024

Did this page help you?

API Convenience Store

Status Inquiry - API Convenience Store

Registration - API Convenience Store

Tentang API Convenience Store Registration

API Convenience Store Registration

Request Parameter for Convenience Store Registration

Additional Information Request for Convenience Store Registration

Response Parameter for Convenience Store Registration

Sample JSON for Convenience Store Registration

Selamat Datang di NICEPAY DOCS