AstraPay Payment - API E-Wallet

15min

Tentang API E-Wallet AstraPay 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.
﻿
API E-Wallet AstraPay Payment  
﻿
﻿
﻿ ini bertujuan supaya mengaktifkan 
﻿ 
﻿ AstraPay pada 
﻿, sehingga 
﻿ dapat melakukan 
﻿ 
﻿ menggunakan 
﻿ dengan 
﻿. Tahapan ini untuk mengintegrasikan 
﻿ dari 
﻿ dengan 
﻿ dari 
﻿. 
API URL
nicepay/api/linkInitiate.do
Request Method
﻿POP UP, Redirect, Submit﻿
Description
Performs 
﻿ Request to 
﻿

Header
Content-Type: application/form
Merchant Token
SHA256(iMid+referenceNo+amt+merchantKey) 
Request Format
application/json
Proses 
﻿ hanya dapat berjalan setelah melalui 
﻿ registrasi, silakan pelajari lebih lengkap mengenai 
﻿ Registrasi AstraPay pada 
﻿ AstraPay Registration - API E-Wallet﻿.
﻿
Request Parameter for E-Wallet AstraPay Payment
﻿
Berikut ini adalah daftar 
﻿ untuk melakukan request registrasi 
﻿ 
﻿ AstraPay. 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
mandateID 
﻿Required﻿
N
40
Mandate ID
IONPAYTEST123412345
payMethod 
﻿Required﻿
N
2
﻿Payment Method Code﻿﻿
05
currency
AN
3
Currency
IDR
amt
N
12
﻿
﻿ Amount
10000
goodsNm
AN
100
Goods Name
John Doe
referenceNo
 Required﻿
ANS
40
﻿
﻿'s Reference Number	
﻿
ORD54321
billingNm 
﻿Required﻿
A
100
Buyer Name	
﻿
John Doe
billingPhone 
 Required﻿
N
15
Buyer Phone Number	
﻿
08123456789
billingEmail 
﻿Required﻿
ANS
40
Buyer Email	
﻿
[email protected]
billingAddr
AN
100
Buyer Address
Jln Merdeka 123
billingCity
A
50
Buyer City
Jakarta Selatan
billingState
1
50
Billing State
DKI Jakarta
billingPostCd
N
10
Billing Post Number
14350
billingCountry
A
10
Billing Country
﻿
﻿ 
deliveryNm
A
30
Delivery Name
John Doe
deliveryPhone
N
15
Delivery Phone
8124125931
deliveryAddr
AN
100
Delivery 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
﻿
﻿ 
cartData 
﻿Required﻿
JSONstring
4000
Cart Data
{"count":1,"item":[{"goods_name":"Casandra Blush On","goods_detail":"Casandra Blush On","goods_amt":"{{amt}}","goods_quantity":"1","img_url":"https://image.freepik.com/free-psd/simple-black-men-s-tee-mockup_53876-57893.jpg"}]}
mitraCd
﻿Required﻿
A
4
﻿Mitra Code﻿﻿
ASTR
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
description
AN
100
Transaction Description	
Test Transaction
userIP
﻿Required﻿
AN
15
User IP Address
127.0.0.1
returnJsonFormat
AN
100
Return JSON Format	
1: return redirect_Url_App and redirect_Url_Http or empty/
0: return HTML to redirect
callBackUrl
AN
255
Result Page
﻿
﻿
﻿ kunjungi 
﻿ E-Wallet﻿ untuk mempelajari 
﻿ umum mengenai 
﻿ 
﻿. 
﻿
Response Parameter for E-Wallet AstraPay Payment
﻿
Berikut adalah response parameter dari hasil request parameter untuk 
﻿ 
﻿ AstraPay. 
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
IONPAYTEST05202212121533119647
mandateID
AN
40
Instead of Signature Token
IONPAYTEST085695655726
referenceNo
ANS
40
﻿
﻿ Reference Number
ncpy20221214121608
payMethod
N
2
﻿Payment Method Code﻿ 
05
amt
N
12
﻿
﻿ Amount
2123
transDt
N
8
Transaction Date (YYYYMMDD)
20221214
transTm
N
6
Transction Time (HH24MISS)
121608
mitraCd
A
4
﻿Mitra Code﻿ 
ASTR
redirectUrlHttp
ANS
255
Redirect to 
﻿ Page
https://apis.astrapay.com/merchant-service/payments/e574e878-d37f-491e-ba78-08e55de73d7
﻿

Sample JSON for E-Wallet AstraPay Payment 
﻿
Form-Urlencode Request
JSON Response
Java Request
timeStamp={timeStamp}
iMid={iMid}
mandateID={mandateID}
referenceNo={referenceNo}
payMethod={payMethod}
currency={currency}
amt={amt}
goodsNm={goodsNm}
billingNm={billingNm}
billingPhone={billingPhone}
billingEmail={billingEmail}
billingAddr={billingAddr}
billingCity={billingCity}
billingState={billingState}
billingPostCd={billingPostCd}
billingCountry={billingCountry}
deliveryNm={deliveryNm}
deliveryPhone={deliveryPhone}
deliveryAddr={deliveryAddr}
deliveryCity={deliveryCity}
deliveryState={deliveryState}
deliveryPostCd={deliveryPostCd}
deliveryCountry={deliveryCountry}
description={description}
userIP={userIP}
cartData={cartData}
callBackUrl={callBackUrl}
dbProcessUrl={dbProcessUrl}
merchantToken={merchantToken}
mitraCd={mitraCd}
returnJsonFormat={returnJsonFormat}
timeStamp={timeStamp}
iMid={iMid}
mandateID={mandateID}
referenceNo={referenceNo}
payMethod={payMethod}
currency={currency}
amt={amt}
goodsNm={goodsNm}
billingNm={billingNm}
billingPhone={billingPhone}
billingEmail={billingEmail}
billingAddr={billingAddr}
billingCity={billingCity}
billingState={billingState}
billingPostCd={billingPostCd}
billingCountry={billingCountry}
deliveryNm={deliveryNm}
deliveryPhone={deliveryPhone}
deliveryAddr={deliveryAddr}
deliveryCity={deliveryCity}
deliveryState={deliveryState}
deliveryPostCd={deliveryPostCd}
deliveryCountry={deliveryCountry}
description={description}
userIP={userIP}
cartData={cartData}
callBackUrl={callBackUrl}
dbProcessUrl={dbProcessUrl}
merchantToken={merchantToken}
mitraCd={mitraCd}
returnJsonFormat={returnJsonFormat}
﻿
﻿
Cart Data E-Wallet AstraPay Payment
﻿
CartData pada Registrasi 
﻿ berguna untuk mendeklarasikan item apa saja 
﻿ dibeli agar bisa dilihat pada rincian item dan harga per barangnya. 
Parameter
Deskripsi
Contoh / Catatan
Count
Total jumlah dari keseluruhan card data
2
Item
Terbagi menjadi 4 macam 
﻿, yaitu img_url, goods_name, goods_detail, dan goods_amt
-
﻿
Penjelasan rincian 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
﻿
cartData E-Wallet AstraPay Payment
{
    "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"
        }  
    ] 
}
﻿

CallBack E-Wallet AstraPay Payment 
﻿
Saat callbackUrl sudah diterima oleh 
﻿, 
﻿ sangat menganjurkan 
﻿ untuk melakukan verifikasi 
﻿ menggunakan Status Inquiry - API E-Wallet﻿.
CallBack Handling dapat sangat membantu untuk meminimalisir terjadinya Fraud, 
﻿ sangat merekomendasikan 
﻿ untuk melakukan verifikasi callBack Handling.
Request Body
URL Callback
https://merchant.co.id/nicepay-callback?string=&resultCd=0000&resultMsg=SUCCESS&tXid=IONPAYTEST05202212141753501704&mandateID=IONPAYTEST085695655726&referenceNo=ncpy20221214175347&payMethod=05&transDt=20221214&transTm=175350&mitraCd=ASTR&amt=10
https://merchant.co.id/nicepay-callback?string=&resultCd=0000&resultMsg=SUCCESS&tXid=IONPAYTEST05202212141753501704&mandateID=IONPAYTEST085695655726&referenceNo=ncpy20221214175347&payMethod=05&transDt=20221214&transTm=175350&mitraCd=ASTR&amt=10
﻿
﻿

API URL	nicepay/api/linkInitiate.do
Request Method	POP UP, Redirect, Submit
Description	Performs Request to
Header	Content-Type: application/form
Merchant Token	SHA256(iMid+referenceNo+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
mandateID Required	N	40	Mandate ID	IONPAYTEST123412345
payMethod Required	N	2	Payment Method Code	05
currency	AN	3	Currency	IDR
amt	N	12	Amount	10000
goodsNm	AN	100	Goods Name	John Doe
referenceNo Required	ANS	40	's Reference Number	ORD54321
billingNm Required	A	100	Buyer Name	John Doe
billingPhone Required	N	15	Buyer Phone Number	08123456789
billingEmail Required	ANS	40	Buyer Email	[email protected]
billingAddr	AN	100	Buyer Address	Jln Merdeka 123
billingCity	A	50	Buyer City	Jakarta Selatan
billingState	1	50	Billing State	DKI Jakarta
billingPostCd	N	10	Billing Post Number	14350
billingCountry	A	10	Billing Country
deliveryNm	A	30	Delivery Name	John Doe
deliveryPhone	N	15	Delivery Phone	8124125931
deliveryAddr	AN	100	Delivery 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
cartData Required	JSONstring	4000	Cart Data	{"count":1,"item":[{"goods_name":"Casandra Blush On","goods_detail":"Casandra Blush On","goods_amt":"{{amt}}","goods_quantity":"1","img_url":"https://image.freepik.com/free-psd/simple-black-men-s-tee-mockup_53876-57893.jpg"}]}
mitraCd Required	A	4	Mitra Code	ASTR
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
description	AN	100	Transaction Description	Test Transaction
userIP Required	AN	15	User IP Address	127.0.0.1
returnJsonFormat	AN	100	Return JSON Format	1: return redirect_Url_App and redirect_Url_Http or empty/ 0: return HTML to redirect
callBackUrl	AN	255	Result Page

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	IONPAYTEST05202212121533119647
mandateID	AN	40	Instead of Signature Token	IONPAYTEST085695655726
referenceNo	ANS	40	Reference Number	ncpy20221214121608
payMethod	N	2	Payment Method Code	05
amt	N	12	Amount	2123
transDt	N	8	Transaction Date (YYYYMMDD)	20221214
transTm	N	6	Transction Time (HH24MISS)	121608
mitraCd	A	4	Mitra Code	ASTR
redirectUrlHttp	ANS	255	Redirect to Page	https://apis.astrapay.com/merchant-service/payments/e574e878-d37f-491e-ba78-08e55de73d7

Parameter	Deskripsi	Contoh / Catatan
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

Updated 18 Sep 2024

Did this page help you?

AstraPay Registration - API E-Wallet

API Payloan

AstraPay Payment - API E-Wallet

Tentang API E-Wallet AstraPay Payment

API E-Wallet AstraPay Payment

Request Parameter for E-Wallet AstraPay Payment

Response Parameter for E-Wallet AstraPay Payment

Sample JSON for E-Wallet AstraPay Payment

Cart Data E-Wallet AstraPay Payment

CallBack E-Wallet AstraPay Payment

Selamat Datang di NICEPAY DOCS