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
}
﻿
﻿

Updated 05 Sep 2024

Did this page help you?

API Convenience Store

Status Inquiry - API Convenience Store

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
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

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