AstraPay Registration - API E-Wallet

10min

About API for E-Wallet AstraPay Registration 
﻿
There are several specific differences for ﻿ ﻿ AstraPay, like on ﻿ ﻿ URL and ﻿ Token ﻿s.
The stages of ﻿ in ﻿ are ﻿ same. However, there are significant differences in ﻿ ﻿ of ﻿ AstraPay. Especially for AstraPay Registration and Payment. ﻿ visit Registration - API E-Wallet﻿ and Payment - API E-Wallet﻿ to know other ﻿ on ﻿ other ﻿.
﻿
API for E-Wallet AstraPay Registration 
﻿
The ﻿ AstraPay Registration ﻿ uses so that ﻿s can connect their ﻿ AstraPay account with ﻿ ﻿ provided by ﻿. So, ﻿ ﻿ ﻿ that has been provided and hosted from ﻿ ﻿ side can integrate with ﻿ ﻿ from ﻿. The following ﻿ can use for ﻿ AstraPay.
API End Point
/nicepay/api/linkEnable.do
Request Method
﻿POP UP, Redirect, Submit﻿
Description
Connecting account to ﻿

Header
Content-Type: application/form
Merchant Token
SHA256 (iMid+referenceNo+billingPhone+merchantKey)
Request Format
application/json
This ﻿ can only be implemented for ﻿ AstraPay.
﻿﻿ visit AstraPay Payment - API E-Wallet﻿ ﻿ to know ﻿ ﻿ specific for ﻿ AstraPay ﻿.
﻿
Request Parameter for E-Wallet Astra Pay Registration 
﻿
The following is a list of ﻿s for requesting registration for ﻿ AstraPay ﻿ ﻿. Request register using ﻿ Call Form - URL. This ﻿ uses through ﻿ ﻿ ﻿ platform as one of ﻿ stages so that ﻿ ﻿'s ﻿ can connect to ﻿s from ﻿.
Parameter
Type
Size
Description
Example / Notes
timeStamp
﻿Required﻿
N
14
Request Timestamp (YYYYMMDDHH24MISS)
20220101123456
iMid
﻿Required﻿
AN
10
﻿﻿ ID	
﻿
Test ﻿ 
referenceNo
﻿Required﻿
ANS
40
﻿﻿'s Reference Number
﻿
ORD12345
payMethod
N
2
﻿Payment Method Code﻿﻿
05
billingNm 
﻿Required﻿
A
100
Buyer Name	
﻿
John Doe
billingPhone 
﻿Required﻿
N
15
Buyer Phone Number
﻿
082111111111
billingEmail 
﻿Required﻿
ANS
40
Buyer E-Mail	
﻿
email@merchant.com
mitraCd
﻿Required ﻿
A
4
﻿Mitra Code﻿  
﻿
ASTR
dbProcessUrl
﻿Required﻿
ANS
255
Notification URL	
﻿
https://merchant.com/api/dbProcessUrl/Notif
merchantToken
﻿Required﻿
AN
255
﻿﻿ Token	
﻿
6cfccfc0046773c1b589d8e 98f8b596c284f3c70a4ecf8 6eba14c18944b74bcd
description
AN
100
Transaction Description	
Test Transaction
userIP
﻿Required﻿
AN
15
User IP address
127.0.0.1
returnJsonFormat
AN
100
Return JSON format
userSessionID
﻿﻿ visit E-Wallet﻿ to learn general ﻿ about ﻿ ﻿s. 
﻿
Response Parameter for E-Wallet AstraPay Registration 
﻿
Following are ﻿ response ﻿s from ﻿ results of ﻿ request ﻿s for registering ﻿ AstraPay ﻿ ﻿.
Parameter
Type
Size
Description
Example / Notes
resultCd
N
4
﻿Result Code﻿﻿
0000
resultMsg
AN
255
Result Message:  Error Code﻿ 
SUCCESS
tXid
AN
30
Transaction ID
IONPAYTEST05202212121533119647
referenceNo
ANS
40
﻿﻿ Reference Number
ncpy20221212153313
payMethod
N
2
﻿Payment Method Code﻿ 
05
amt
N
12
﻿﻿ Amount
null
transDt
N
8
Transaction Date (YYYYMMDD)
20221212
transTm
N
6
Transaction Time (HH24MISS)
153313
mitraCd
A
4
﻿Mitra Code﻿ 
ASTR
paymentExpDt
N
6
QR ﻿ Expiry Date (YYYYMMDD)
null
paymentExpTm
N
6
QR ﻿ Expiry Time (HH24MISS)
null
redirectUrlHttp
ANS
255
Redirect to ﻿ Page
https://sandbox.astrapay.com/merchant-service/link?clientId=1baf55ad-2130-4d46-bf48-91b0b01004a1&merchantUserId=2212124f0ccbef5a913058
redirectUrlApp
AN
100
Redirect URL Apps
null
redirectToken
AN
100
Redirect Token
null
﻿
Sample JSON for E-Wallet Registration 
﻿
Form-urlencode Request
JSON Response
Java Request
{
    "resultCd": "0000",
    "resultMsg": "SUCCESS",
    "tXid": "IONPAYTEST05202212121533119647",
    "referenceNo": "ncpy20221212153313",
    "payMethod": "05",
    "amt": null,
    "transDt": "20221212",
    "transTm": "153313",
    "mitraCd": "ASTR",
    "paymentExpDt": null,
    "paymentExpTm": null,
    "redirectUrlHttp": "https://sandbox.astrapay.com/merchant-service/link?clientId=1baf55ad-2130-4d46-bf48-91b0b01004a1&merchantUserId=2212124f0ccbef5a913058",
    "redirectUrlApp": null,
    "redirectToken": null
}
{
    "resultCd": "0000",
    "resultMsg": "SUCCESS",
    "tXid": "IONPAYTEST05202212121533119647",
    "referenceNo": "ncpy20221212153313",
    "payMethod": "05",
    "amt": null,
    "transDt": "20221212",
    "transTm": "153313",
    "mitraCd": "ASTR",
    "paymentExpDt": null,
    "paymentExpTm": null,
    "redirectUrlHttp": "https://sandbox.astrapay.com/merchant-service/link?clientId=1baf55ad-2130-4d46-bf48-91b0b01004a1&merchantUserId=2212124f0ccbef5a913058",
    "redirectUrlApp": null,
    "redirectToken": null
}
﻿
﻿
CallBack Handling E-Wallet AstraPay Registration
﻿
Callback Handling on ﻿ Registration obtained on URL format after registration is success.
URL CallBack
https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?string=&resultCd=0000&resultMsg=SUCCESS&tXid=IONPAYTEST05202212151804213115&mandateID=IONPAYTEST085695655721&referenceNo=ORD20221215181255&payMethod=05&transDt=20221215&transTm=180517&mitraCd=ASTR
https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?string=&resultCd=0000&resultMsg=SUCCESS&tXid=IONPAYTEST05202212151804213115&mandateID=IONPAYTEST085695655721&referenceNo=ORD20221215181255&payMethod=05&transDt=20221215&transTm=180517&mitraCd=ASTR
﻿

API End Point	/nicepay/api/linkEnable.do
Request Method	POP UP, Redirect, Submit
Description	Connecting account to
Header	Content-Type: application/form
Merchant Token	SHA256 (iMid+referenceNo+billingPhone+merchantKey)
Request Format	application/json

Parameter	Type	Size	Description	Example / Notes
timeStamp Required	N	14	Request Timestamp (YYYYMMDDHH24MISS)	20220101123456
iMid Required	AN	10	ID	Test
referenceNo Required	ANS	40	's Reference Number	ORD12345
payMethod	N	2	Payment Method Code	05
billingNm Required	A	100	Buyer Name	John Doe
billingPhone Required	N	15	Buyer Phone Number	082111111111
billingEmail Required	ANS	40	Buyer E-Mail	email@merchant.com
mitraCd Required	A	4	Mitra Code	ASTR
dbProcessUrl Required	ANS	255	Notification URL	https://merchant.com/api/dbProcessUrl/Notif
merchantToken Required	AN	255	Token	6cfccfc0046773c1b589d8e 98f8b596c284f3c70a4ecf8 6eba14c18944b74bcd
description	AN	100	Transaction Description	Test Transaction
userIP Required	AN	15	User IP address	127.0.0.1
returnJsonFormat	AN	100	Return JSON format	userSessionID

Parameter	Type	Size	Description	Example / Notes
resultCd	N	4	Result Code	0000
resultMsg	AN	255	Result Message: Error Code	SUCCESS
tXid	AN	30	Transaction ID	IONPAYTEST05202212121533119647
referenceNo	ANS	40	Reference Number	ncpy20221212153313
payMethod	N	2	Payment Method Code	05
amt	N	12	Amount	null
transDt	N	8	Transaction Date (YYYYMMDD)	20221212
transTm	N	6	Transaction Time (HH24MISS)	153313
mitraCd	A	4	Mitra Code	ASTR
paymentExpDt	N	6	QR Expiry Date (YYYYMMDD)	null
paymentExpTm	N	6	QR Expiry Time (HH24MISS)	null
redirectUrlHttp	ANS	255	Redirect to Page	https://sandbox.astrapay.com/merchant-service/link?clientId=1baf55ad-2130-4d46-bf48-91b0b01004a1&merchantUserId=2212124f0ccbef5a913058
redirectUrlApp	AN	100	Redirect URL Apps	null
redirectToken	AN	100	Redirect Token	null

Cancel - API E-Wallet

AstraPay Payment - API E-Wallet

AstraPay Registration - API E-Wallet

About API for E-Wallet AstraPay Registration

API for E-Wallet AstraPay Registration

Request Parameter for E-Wallet Astra Pay Registration

Response Parameter for E-Wallet AstraPay Registration

Sample JSON for E-Wallet Registration

CallBack Handling E-Wallet AstraPay Registration

Welcome to NICEPAY DOCS