Through , offers you convenience of cross-application 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.
using aims to activate at s, so that s can make s using with s. This stage is to integrate with .
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/x-www-form-urlencoded |
The can only be after going through registration , please learn further about AstraPay registration on AstraPay Registration - API E-Wallet .
The following is a list of s for requesting registration of AstraPay . This is used through platform as one of stages so that 's can connect with s from .
Parameter | Type | Size | Description | Example / Notes |
|---|---|---|---|---|
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 | 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@merchant.com |
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 | 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 | |
visit E-Wallet to learn general about .
Following are response s from the results of request s for of AstraPay .
Parameter | Type | Size | Description | Example / Notes |
|---|---|---|---|---|
resultCd | N | 4 | 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 | 05 | |
amt | N | 12 | Amount | 2123 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221214 |
transTm | N | 6 | Transaction Time (HH24MISS) | 121608 |
mitraCd | A | 4 | ASTR | |
redirectUrlHttp | ANS | 255 | Redirect to Page | https://apis.astrapay.com/merchant-service/payments/e574e878-d37f-491e-ba78-08e55de73d7 |
CartData in Registration is useful for declaring what items will be checked out along with item details and price per item.
Parameter | Description | Example / Notes |
|---|---|---|
Count | Total from all card data | 2 |
Item | Divide into 4 type, such as img_url, goods_name, goods_detail and goods_amt | - |
Detailed explanation on Item s.
Parameter | Description | Example / Notes |
|---|---|---|
img_url | Goods Picture URL (Ukuran 50px x 50px) | htttps://www.merchant.com/image_goods1.jpg |
goods_name | Goods Name | Nama Item-1 |
goods_detail | Goods Detail Description | Detail Item-1 |
goods_amt | Goods Price | 1000 |
When Your callback already received callbackUrl, recommended to do verification using Status Inquiry - API E-Wallet
CallBack Handling can be very helpful to minimize occurrence of Fraud, highly recommend to do verification using callBack Handling.
By accessing this site, you are agree with the applicable terms and conditions.
Bank Indonesia already release API Standard relate to the Payment listed on Peraturan Anggota Dewan Gubernur No 23/15/PADG/2021 about Standar Nasional Open Application Interface Pembayaran (SNAP) Implementation.
As the form of suppport and compliance to Bank Indonesia Rules, NICEPAY drives all Merchant to conduct the migration to API SNAP BI.
All Merchants aim to complete the API SNAP BI migration on June 2024.