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