Payment - API E-Wallet

12min

Tentang API E-Wallet Payment 
﻿

Melalui 
﻿ 
﻿, 
﻿ menawarkan 
﻿ kemudahan 
﻿ lintas aplikasi (Jump App) untuk 
﻿ 
﻿. Notifikasi akan dikirimkan ke 
﻿ secara real-time sesaat setelah 
﻿ menyelesaikan 
﻿.
﻿
﻿ kunjungi 
﻿ Alur Pembayaran E-Wallet﻿ untuk mengetahui perbedaan alur 
﻿ secara umum dengan AstraPay.
﻿
﻿ kunjungi 
﻿ E-Wallet﻿ untuk mempelajari 
﻿ umum mengenai 
﻿ 
﻿. 
﻿
API E-Wallet Payment 

﻿
﻿
﻿ 
﻿ 
﻿ bertujuan supaya mengaktifkan 
﻿ 
﻿ pada 
﻿, sehingga 
﻿ dapat melakukan 
﻿ 
﻿ menggunakan 
﻿ dengan 
﻿. Tahapan ini bertujuan untuk melakukan 
﻿ 
﻿ dari 
﻿ dengan 
﻿ dari 
﻿. 
API URL
/nicepay/direct/v2/payment
Request Method
﻿POP UP, Redirect, Submit﻿
Description
Performs 
﻿ Request to 
﻿

Merchant Token
SHA256(timeStamp+iMid+referenceNo+amt+merchantKey) 
Request Format
application/x-www-form-urlencoded
Proses 
﻿ hanya dapat dijalankan setelah melalui 
﻿ registrasi, silakan pelajari lebih lengkap tentang registrasi pada 
﻿ Registration - API E-Wallet﻿.
﻿
Request Parameter for E-Wallet Payment
﻿

Berikut ini adalah daftar 
﻿ untuk melakukan pengajuan registrasi 
﻿ 
﻿. Parameter ini digunakan melalui platform pengujian 
﻿ sebagai salah satu tahapan supaya 
﻿ milik 
﻿ dapat terhubung dengan 
﻿ dari 
﻿.  
Catatan tambahan untuk ShopeePay, dalam rangka menghasilkan pengalaman Pengguna lebih baik pada 
﻿, silakan berikan 
﻿ pesan peringatan (warning message) ke 
﻿ untuk mengakses melalui perangkat ponsel.
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
timeStamp
﻿Required﻿
N
14
Request Timestamp (YYYYMMDDHH24MISS)
20221208065959
tXid
﻿Required﻿
AN
30
Transaction ID
IONPAYTEST05202212081111197444
merchantToken
﻿Required﻿
AN
255
﻿
﻿ Token	
﻿

324a7d07d9f3fe30a3960b28af29a91fc30a33fb3332cf33d40394f30d1f399f
callBackUrl
﻿Required﻿
AN
255
Result Page
https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp
returnJsonFormat
﻿
Required for ShopeePay
﻿
AN
100
If 
﻿ value is 1, then it will return ShopeePay link.
If 
﻿ value is empty/0, then it will redirect to other HTML Page.
1: return redirectUrlApp and/or redirectUrlHttp
empty/0 : return HTML to redirect
﻿
﻿ dapat mengikuti panduan 
﻿ dan 
﻿ ShopeePay 
﻿ pada 
﻿ Integrasi & Testing E-Wallet﻿.
﻿
CallBack Handling E-Wallet
﻿
Setelah melakukan request 
﻿ 
﻿, response 
﻿ didapatkan dari 
﻿ 
﻿ adalah berupa Callback. 
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
resultCd
N
14
﻿Result Code﻿﻿
0000
resultMsg
AN
225
Result Message: Error Code﻿﻿
Success
tXid
AN
30
Transaction ID
﻿

IONPAYTEST05202406260930529202
referenceNo
ANS
40
﻿
﻿'s Reference Number
20240626093051
payMethod
﻿
N
2
﻿Payment Method Code﻿﻿
05
amt
N
12
Amount
10000
transDt
N
8
Transaction Date (YYYYMMDD)
20240626
transTm
N
6
Transaction Date (HH24MISS)
093052
mitraCd
AN
4
﻿Mitra Code﻿﻿
ESHP
callBackUrl
ANS
500
﻿
﻿ result forward URL (on browser)
https://merchant.co.id/nicepay-callback
Ketika Callback diterima callbackurl 
﻿, 
﻿ merekomendasikan 
﻿ untuk melakukan verifikasi 
﻿ dengan menggunakan Status Inquiry - API E-Wallet﻿.
CallBack Handling sangat penting untuk membantu meminimalisir tindakan Fraud. 
﻿ sangat merekomendasikan 
﻿ untuk melakukan verifikasi menggunakan CallBack Handling.
URL CallBack
https://merchant.co.id/nicepay-callback?resultCd=0000&resultMsg=SUCCESS&tXid=IONPAYTEST05202406260930529202&referenceNo=20240626093051&payMethod=05&amt=2000&transDt=20240626&transTm=093652&mitraCd=ESHP&callBackUrl=https%3A%2F%2Fwebhook.site%2Fe1e151bc-23f5-4db9-8272-6addeea95701
https://merchant.co.id/nicepay-callback?resultCd=0000&resultMsg=SUCCESS&tXid=IONPAYTEST05202406260930529202&referenceNo=20240626093051&payMethod=05&amt=2000&transDt=20240626&transTm=093652&mitraCd=ESHP&callBackUrl=https%3A%2F%2Fwebhook.site%2Fe1e151bc-23f5-4db9-8272-6addeea95701
﻿
﻿
Response Parameter for E-Wallet Payment
﻿
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
resultCd
N
4
﻿Result Code﻿﻿
0000
resultMsg
AN
255
Result M
essage: Error Code﻿﻿
Success
tXid
AN
30
Transaction ID

IONPAYTEST05202406260930529202
referenceNo
ANS
40
﻿
﻿'s Reference Number
20240626093051
payMethod
﻿
N
2
﻿Payment Method Code﻿﻿
05
amt
N
12
Amount
10000
transDt
N
8
Transaction Date (YYYYMMDD)
20240626
transTm
N
6
Transaction Date (HH24MISS)
093052
mitraCd
AN
4
﻿Mitra Code﻿﻿
ESHP
paymentExpDt
N
8
﻿
﻿ Expiry Date (YYYYMMDD)
20240626
paymentExpTm
N
6
﻿
﻿ Expiry Time (HH24MISS)
093530
redirectUrlHttp
AN
100
Returns a universal link redirecting users to 
﻿ 
﻿ 
﻿.
https://pay.uat.airpay.co.id/h5pay/example
redirectUrlApp
AN
100
Returns a URL redirecting users to 
﻿ 
﻿ mobile apps.
﻿For ShopeePay, this value will be deprecated﻿
redirectToken
﻿
AN
2000
﻿
﻿Used only for LinkAja﻿

Sample JSON for E-Wallet Payment 
﻿
Form-Urlencode Request
Sample Response
{
  "resultCd": "0000",
  "resultMsg": "SUCCESS",
  "tXid": "IONPAYTEST05202406260930529202",
  "referenceNo": "20240626093051",
  "payMethod": "05",
  "amt": "2000",
  "transDt": "20240626",
  "transTm": "093052",
  "mitraCd": "ESHP",
  "paymentExpDt": "20240626",
  "paymentExpTm": "093807",
  "redirectUrlHttp": "https://pay.uat.airpay.co.id/h5pay/example",
  "redirectUrlApp": "",
  "redirectToken": null
}
{
  "resultCd": "0000",
  "resultMsg": "SUCCESS",
  "tXid": "IONPAYTEST05202406260930529202",
  "referenceNo": "20240626093051",
  "payMethod": "05",
  "amt": "2000",
  "transDt": "20240626",
  "transTm": "093052",
  "mitraCd": "ESHP",
  "paymentExpDt": "20240626",
  "paymentExpTm": "093807",
  "redirectUrlHttp": "https://pay.uat.airpay.co.id/h5pay/example",
  "redirectUrlApp": "",
  "redirectToken": null
}
﻿
﻿

API URL	/nicepay/direct/v2/payment
Request Method	POP UP, Redirect, Submit
Description	Performs Request to
Merchant Token	SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Request Format	application/x-www-form-urlencoded

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
timeStamp Required	N	14	Request Timestamp (YYYYMMDDHH24MISS)	20221208065959
tXid Required	AN	30	Transaction ID	IONPAYTEST05202212081111197444
merchantToken Required	AN	255	Token	324a7d07d9f3fe30a3960b28af29a91fc30a33fb3332cf33d40394f30d1f399f
callBackUrl Required	AN	255	Result Page	https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp
returnJsonFormat Required for ShopeePay	AN	100	If value is 1, then it will return ShopeePay link. If value is empty/0, then it will redirect to other HTML Page.	1: return redirectUrlApp and/or redirectUrlHttp empty/0 : return HTML to redirect

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
resultCd	N	14	Result Code	0000
resultMsg	AN	225	Result Message: Error Code	Success
tXid	AN	30	Transaction ID	IONPAYTEST05202406260930529202
referenceNo	ANS	40	's Reference Number	20240626093051
payMethod	N	2	Payment Method Code	05
amt	N	12	Amount	10000
transDt	N	8	Transaction Date (YYYYMMDD)	20240626
transTm	N	6	Transaction Date (HH24MISS)	093052
mitraCd	AN	4	Mitra Code	ESHP
callBackUrl	ANS	500	result forward URL (on browser)	https://merchant.co.id/nicepay-callback

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
resultCd	N	4	Result Code	0000
resultMsg	AN	255	Result M essage: Error Code	Success
tXid	AN	30	Transaction ID	IONPAYTEST05202406260930529202
referenceNo	ANS	40	's Reference Number	20240626093051
payMethod	N	2	Payment Method Code	05
amt	N	12	Amount	10000
transDt	N	8	Transaction Date (YYYYMMDD)	20240626
transTm	N	6	Transaction Date (HH24MISS)	093052
mitraCd	AN	4	Mitra Code	ESHP
paymentExpDt	N	8	Expiry Date (YYYYMMDD)	20240626
paymentExpTm	N	6	Expiry Time (HH24MISS)	093530
redirectUrlHttp	AN	100	Returns a universal link redirecting users to .	https://pay.uat.airpay.co.id/h5pay/example
redirectUrlApp	AN	100	Returns a URL redirecting users to mobile apps.	For ShopeePay, this value will be deprecated
redirectToken	AN	2000		Used only for LinkAja

Updated 18 Sep 2024

Did this page help you?

Registration - API E-Wallet

Status Inquiry - API E-Wallet

Payment - API E-Wallet

Tentang API E-Wallet Payment

API E-Wallet Payment

Request Parameter for E-Wallet Payment

CallBack Handling E-Wallet

Response Parameter for E-Wallet Payment

Sample JSON for E-Wallet Payment

Selamat Datang di NICEPAY DOCS