Registration - API E-Wallet

13 min

Tentang API for E-Wallet Registration

﻿
Saat ini ﻿ sudah bekerja sama dengan 5 channel ﻿ ﻿ memudahkan ﻿ ﻿ pada ﻿ ﻿, yaitu:
OVO.
LinkAja.
DANA.
ShopeePay.
AstraPay.
Tahap-tahap ﻿ pada ﻿ OVO, LinkAja, DANA, dan ShopeePay pada umumnya adalah sama. Namun, terdapat perbedaan ﻿ signifikan pada ﻿ ﻿ AstraPay. Khusus Registrasi dan Payment AstraPay, silakan kunjungi AstraPay Registration - API E-Wallet﻿ dan AstraPay Payment - API E-Wallet﻿.
﻿
API for E-Wallet Registration
﻿
﻿﻿ ﻿ Registration digunakan supaya ﻿ dapat terhubung dengan ﻿﻿﻿ ﻿ ﻿ dengan ﻿ dari ﻿. Sehingga ﻿ ﻿ ﻿ sudah disediakan dan di-host dari sisi ﻿ dapat ter﻿ dengan ﻿ dari ﻿. ﻿ berikut dapat digunakan untuk ﻿ OVO, LinkAja, DANA, dan ShopeePay.
API Endpoint
/nicepay/direct/v2/registration
Request Method
﻿POST﻿
Description
Performs Transaction Regist to ﻿
Merchant Token
SHA256(timeStamp+iMid+tXid+amt+merchantKey)
Request Format
application/json
﻿﻿ berikut ini dapat diterapkan untuk ﻿ OVO, LinkAja, DANA dan ShopeePay. 
﻿﻿ kunjungi ﻿ AstraPay Registration - API E-Wallet﻿ untuk mengetahui ﻿ registrasi ﻿ AstraPay.
﻿﻿ kunjungi ﻿ AstraPay Payment - API E-Wallet﻿ untuk mengetahui cara ﻿ ﻿ ﻿ AstraPay.
﻿
Request Parameter for E-Wallet 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)
20210315112359
iMid
﻿Required﻿
AN
10
﻿﻿ ID	
﻿
IONPAYTEST
payMethod
﻿Required﻿
N
2
﻿Payment Method Code﻿﻿
05
currency
﻿Required﻿
A
3
Currency
﻿
IDR
amt 
﻿Required﻿
N
12
Amount
﻿
1000
referenceNo
 Required﻿
ANS
40
﻿﻿'s Reference Number
ORD54321
goodsNm  ﻿
﻿Required﻿
AN
100
Goods Name	
﻿
Test Transaction ﻿
billingNm 
﻿Required﻿
A
100
Buyer Name	
﻿
John Doe
billingPhone
 Required﻿
N
15
Buyer Phone Number
08123456789
billingEmail
﻿Required﻿
ANS
40
Buyer E-mail	
﻿
email@merchant.com
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﻿﻿
OVOE
userIP 
﻿Required﻿
AN
15
User IP
﻿
127.0.0.1

dbProcessUrl
 Required﻿
ANS
255
Notification URL	
﻿
https://merchant.com/dbProcessUrl
merchantToken
﻿Required﻿
AN
255
﻿﻿ Token	
﻿
a45e163042746131307bad89ef6cc0c517c136895a6cfe6cb77c4a62ce1ee5b3
deliveryNm
A
30
Delivery Name	
John Doe
deliveryPhone
N
15
Delivery Phone	
8124125931
deliveryAddr
AN
100
Delviery Address	
Jln Merdeka Riau 161
deliveryCity
A
50
Delivery City	
Riau
deliveryState
A
50
Delivery State	
Riau
deliveryPostCd
N
10
Delivery Post Code	
14350
deliveryCountry
A
10
Delivery Country	
﻿﻿ 
vat
N
12
﻿﻿ 
0
fee
N
12
Service Fee	
0
description
AN
100
Transaction Description	
Test Transaction

reqDomain
ANS
100
Request Domain	
merchant.com
reqServerIP
ANS
15
Request Server IP	
127.0.0.1
userIP
﻿Required﻿
AN
15
User IP Address
127.0.0.1
reqClientVer
ANS
50
Client Version	
1.0
userSessionID
AN
100
User Session ID	
userSessionID
userAgent
ANS
100
User Agent	
Mozilla
userLanguage
A
2
User Language	
en-US
userAgent
﻿Required﻿
ANS
100
User Agent Information	
Mozilla
NotaxAmt
N
12
Tax-Free Amount
﻿
reqDt
N
8
Request Date (YYYYMMDD)
﻿
reqTm
N
6
Request Time (HH24MISS)	
﻿
﻿﻿ kunjungi E-Wallet﻿ untuk mempelajari ﻿ umum mengenai ﻿ ﻿. 
﻿
Response Parameter for E-Wallet Registration 
﻿
Berikut adalah response parameter dari hasil request parameter untuk melakukan pendaftaran ﻿ ﻿.
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
resultCd
N
4
﻿Result Code﻿ 
0000
resultMsg
AN
255
Result Message: Error Code﻿ 
SUCCESS
tXid
AN
30
Transaction ID
IONPAYTEST05202103151123583200
referenceNo
ANS
40
﻿﻿ Reference Number
ORD54321
payMethod
N
2
﻿Payment Method Code﻿ 
05
amt
N
12
﻿﻿ Amount
1000
transDt
N
8
Transaction Date (YYYYMMDD)
20210315
transTm
N
6
Transction Time (HH24MISS)
112358
description
AN
100
Transaction Description
null
bankCd
A
4
﻿Bank Code﻿ 
null
vacctNo
N
20
﻿﻿ Number
null
mitraCd
A
4
﻿Mitra Code﻿ 
OVOE
payNo
N
12
CVS ﻿ Number
null
currency
A
3
Currency
IDR
goodsNm
AN
100
Goods Name
Test Transaction ﻿ 
billingNm
A
100
Buyer Name
John Doe
payValidDt
N
8
CVS Expiry Date (YYYYMMDD) (CVS)
null
payValidTm
N
6
CVS Expiry Time (HH24MISS) (CVS)
null
vacctValidDt
N
8
Expiry Date (YYYYMMDD)
null
vacctValidTm
N
6
Expiry Time (HH24MISS)
null
requestURL
ANS
360
Request URL
null
paymentExpDt
N
6
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 E-Wallet Registration 
﻿
JSON Request
JSON Response
Java Request
{
    "resultCd": "0000",
    "resultMsg": "SUCCESS",
    "tXid": "IONPAYTEST05202103151123583200",
    "referenceNo": "ORD54321",
    "payMethod": "05",
    "amt": "1000",
    "transDt": "20210315",
    "transTm": "112358",
    "description": "",
    "bankCd": null,
    "vacctNo": null,
    "mitraCd": "OVOE",
    "payNo": null,
    "currency": "IDR",
    "goodsNm": "Test Transaction Nicepay",
    "billingNm": "John Doe",
    "vacctValidDt": null,
    "vacctValidTm": null,
    "payValidDt": null,
    "payValidTm": null,
    "requestURL": null,
    "paymentExpDt": null,
    "paymentExpTm": null,
    "qrContent": null,
    "qrUrl": null
}
{
    "resultCd": "0000",
    "resultMsg": "SUCCESS",
    "tXid": "IONPAYTEST05202103151123583200",
    "referenceNo": "ORD54321",
    "payMethod": "05",
    "amt": "1000",
    "transDt": "20210315",
    "transTm": "112358",
    "description": "",
    "bankCd": null,
    "vacctNo": null,
    "mitraCd": "OVOE",
    "payNo": null,
    "currency": "IDR",
    "goodsNm": "Test Transaction Nicepay",
    "billingNm": "John Doe",
    "vacctValidDt": null,
    "vacctValidTm": null,
    "payValidDt": null,
    "payValidTm": null,
    "requestURL": null,
    "paymentExpDt": null,
    "paymentExpTm": null,
    "qrContent": null,
    "qrUrl": null
}
﻿
﻿
Cart Data E-Wallet Registration
﻿
CartData pada Registrasi ﻿ berisi daftar item ﻿ akan melalui checkout berserta detail item dan harga per item-nya. 
Parameter
Deskripsi
Contoh
Count
Total jumlah dari keseluruhan card data
2
Item
Terbagi menjadi 4 macam ﻿, yaitu img_url, goods_name, goods_detail, dan goods_amt
-
﻿
Penjelasan detail pada ﻿ Item.
Parameter
Deskripsi
Contoh
img_url
URL Gambar Barang (Ukuran 50px x 50px)
htttps://www.merchant.com/image_goods1.jpg
goods_name
Nama Barang
Nama Item-1
goods_detail
Deskripsi Detail Barang
Detail Item-1
goods_amt
Harga Barang
1000
goods_quantity
Jumlah barang
1
﻿
cartData E-Wallet Registration
{
    "count": "2",  
    "item": [  
        {
            "img_url": "http://www.merchant.com/image_goods1.jpg",  
            "goods_name": "Item 1 Name",
            "goods_detail": "Item 1 Detail",
            "goods_amt": "1000",
            "goods_quantity": "1"
        },  
        {
            "img_url": "http://www.merchant.com/image_goods2.jpg",
            "goods_name": "Item 2 Name",
            "goods_detail": "Item 2 Detail",
            "goods_amt": "1000"
            "goods_quantity": "1"
        }  
    ] 
}
{
    "count": "2",  
    "item": [  
        {
            "img_url": "http://www.merchant.com/image_goods1.jpg",  
            "goods_name": "Item 1 Name",
            "goods_detail": "Item 1 Detail",
            "goods_amt": "1000",
            "goods_quantity": "1"
        },  
        {
            "img_url": "http://www.merchant.com/image_goods2.jpg",
            "goods_name": "Item 2 Name",
            "goods_detail": "Item 2 Detail",
            "goods_amt": "1000"
            "goods_quantity": "1"
        }  
    ] 
}
﻿
﻿

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

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
timeStamp Required	N	14	Request Timestamp (YYYYMMDDHH24MISS)	20210315112359
iMid Required	AN	10	ID	IONPAYTEST
payMethod Required	N	2	Payment Method Code	05
currency Required	A	3	Currency	IDR
amt Required	N	12	Amount	1000
referenceNo Required	ANS	40	's Reference Number	ORD54321
goodsNm Required	AN	100	Goods Name	Test Transaction
billingNm Required	A	100	Buyer Name	John Doe
billingPhone Required	N	15	Buyer Phone Number	08123456789
billingEmail Required	ANS	40	Buyer E-mail	email@merchant.com
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	OVOE
userIP Required	AN	15	User IP	127.0.0.1
dbProcessUrl Required	ANS	255	Notification URL	https://merchant.com/dbProcessUrl
merchantToken Required	AN	255	Token	a45e163042746131307bad89ef6cc0c517c136895a6cfe6cb77c4a62ce1ee5b3
deliveryNm	A	30	Delivery Name	John Doe
deliveryPhone	N	15	Delivery Phone	8124125931
deliveryAddr	AN	100	Delviery Address	Jln Merdeka Riau 161
deliveryCity	A	50	Delivery City	Riau
deliveryState	A	50	Delivery State	Riau
deliveryPostCd	N	10	Delivery Post Code	14350
deliveryCountry	A	10	Delivery Country
vat	N	12		0
fee	N	12	Service Fee	0
description	AN	100	Transaction Description	Test Transaction
reqDomain	ANS	100	Request Domain	merchant.com
reqServerIP	ANS	15	Request Server IP	127.0.0.1
userIP Required	AN	15	User IP Address	127.0.0.1
reqClientVer	ANS	50	Client Version	1.0
userSessionID	AN	100	User Session ID	userSessionID
userAgent	ANS	100	User Agent	Mozilla
userLanguage	A	2	User Language	en-US
userAgent Required	ANS	100	User Agent Information	Mozilla
NotaxAmt	N	12	Tax-Free Amount
reqDt	N	8	Request Date (YYYYMMDD)
reqTm	N	6	Request Time (HH24MISS)

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
resultCd	N	4	Result Code	0000
resultMsg	AN	255	Result Message: Error Code	SUCCESS
tXid	AN	30	Transaction ID	IONPAYTEST05202103151123583200
referenceNo	ANS	40	Reference Number	ORD54321
payMethod	N	2	Payment Method Code	05
amt	N	12	Amount	1000
transDt	N	8	Transaction Date (YYYYMMDD)	20210315
transTm	N	6	Transction Time (HH24MISS)	112358
description	AN	100	Transaction Description	null
bankCd	A	4	Bank Code	null
vacctNo	N	20	Number	null
mitraCd	A	4	Mitra Code	OVOE
payNo	N	12	CVS Number	null
currency	A	3	Currency	IDR
goodsNm	AN	100	Goods Name	Test Transaction
billingNm	A	100	Buyer Name	John Doe
payValidDt	N	8	CVS Expiry Date (YYYYMMDD) (CVS)	null
payValidTm	N	6	CVS Expiry Time (HH24MISS) (CVS)	null
vacctValidDt	N	8	Expiry Date (YYYYMMDD)	null
vacctValidTm	N	6	Expiry Time (HH24MISS)	null
requestURL	ANS	360	Request URL	null
paymentExpDt	N	6	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

Parameter	Deskripsi	Contoh
Count	Total jumlah dari keseluruhan card data	2
Item	Terbagi menjadi 4 macam , yaitu img_url, goods_name, goods_detail, dan goods_amt	-

Parameter	Deskripsi	Contoh
img_url	URL Gambar Barang (Ukuran 50px x 50px)	htttps://www.merchant.com/image_goods1.jpg
goods_name	Nama Barang	Nama Item-1
goods_detail	Deskripsi Detail Barang	Detail Item-1
goods_amt	Harga Barang	1000
goods_quantity	Jumlah barang	1

API E-Wallet

Payment - API E-Wallet

Registration - API E-Wallet

Tentang API for E-Wallet Registration

API for E-Wallet Registration

Request Parameter for E-Wallet Registration

Response Parameter for E-Wallet Registration

Sample JSON for E-Wallet Registration

Cart Data E-Wallet Registration

Selamat Datang di NICEPAY DOCS