Payment - API E-Wallet

13 min

About API E-Wallet Payment 
﻿
Through ﻿ ﻿ ﻿, ﻿ offers you ﻿ convenience of cross-app ﻿s (Jump App) for your ﻿s. Notifications will be sent to ﻿s in real-time as soon as ﻿s complete ﻿s.
﻿﻿ visit ﻿ E-Wallet Payment Flow﻿ ﻿ to acknowledge ﻿ flow difference between ﻿ general ﻿ with AstraPay.
﻿﻿ visit ﻿ E-Wallet﻿ ﻿ to learn general ﻿ about ﻿ ﻿.
﻿
API E-Wallet Payment  
﻿
﻿﻿ ﻿ ﻿ aims to activate ﻿ ﻿ ﻿ at ﻿s, so that ﻿ can make ﻿ ﻿s using ﻿ with ﻿s. This stage is to integrate ﻿ ﻿ ﻿ with ﻿ ﻿ ﻿.
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
The payment process can only be carried out after going through the registration process, please learn further about registration on Registration - API E-Wallet﻿ page.
﻿
Request Parameter for E-Wallet Payment
﻿
The following is a list of ﻿s for requesting registration of ﻿ ﻿ ﻿. This ﻿ is used through ﻿ ﻿ ﻿ platform as one of ﻿ stages so that ﻿ ﻿'s ﻿ can connect with ﻿s from ﻿.
Additional notes for ShopeePay, to produce a better user experience for ﻿s, please provide a warning message ﻿ to ﻿s to access via mobile devices.
Parameter
Type
Size
Description
Example / Notes
timeStamp
﻿Required﻿
N
14
Request Timestamp (YYYYMMDDHH24MISS)
20221208065959
tXid
﻿Required﻿
AN
30
Transaction ID
IONPAYTEST05202212081111197444
merchantToken
﻿Required﻿
AN
255
﻿﻿ Token	
﻿

324a7d07d9f3fe30a3960b28af29a91fc30a33fb3332cf33d40394f30d1f399f
callBackUrl
﻿RequirementResult.jd﻿
AN
255
Result Page
https://www.nicepay.co.id/IONPAY_CLIENT/paysp
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
You can follow ﻿ ﻿ and ﻿ guidance of ShopeePay ﻿ on E-Wallet Integration & Testing﻿ ﻿.

﻿
CallBack Handling E-Wallet
﻿
After request for ﻿ ﻿, ﻿ response obtained from ﻿ ﻿s is in ﻿ form of a Callback.
Parameter
Type
Size
Description
Example / Notes
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
When Your callback already received callbackUrl, ﻿ recommended ﻿ ﻿ to do ﻿ ﻿ verification using ﻿ Status Inquiry - API E-Wallet﻿.
CallBack Handling is very important to help minimize fraud. ﻿ highly recommend ﻿ ﻿ to do ﻿ verification using 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
Type
Size
Description
Example / Notes
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	Type	Size	Description	Example / Notes
timeStamp Required	N	14	Request Timestamp (YYYYMMDDHH24MISS)	20221208065959
tXid Required	AN	30	Transaction ID	IONPAYTEST05202212081111197444
merchantToken Required	AN	255	Token	324a7d07d9f3fe30a3960b28af29a91fc30a33fb3332cf33d40394f30d1f399f
callBackUrl RequirementResult.jd	AN	255	Result Page	https://www.nicepay.co.id/IONPAY_CLIENT/paysp
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	Type	Size	Description	Example / Notes
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	Type	Size	Description	Example / Notes
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

Registration - API E-Wallet

Status Inquiry - API E-Wallet

Payment - API E-Wallet

About 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

Welcome to NICEPAY DOCS