AstraPay Payment - API E-Wallet
Through the E-Wallet payment method, NICEPAY offers you the convenience of cross-application payments (Jump App) for your customers. Notifications will be sent to Customers in real-time as soon as Customers complete payments.
Please visit the E-Wallet Payment Flow page to acknowledge the flow difference between the general E-Wallet with AstraPay.
Payment using E-Wallet aims to activate the E-Wallet payment method at Merchants, so that Customers can make payment transactions using E-Wallet with Merchants. This stage is to integrate the Merchant system with the NICEPAY system.
API URL | nicepay/api/linkInitiate.do |
Request Method | POP UP, Redirect, Submit |
Description | Performs Payment Request to NICEPAY |
Header | Content-Type: application/form |
Merchant Token | SHA256(iMid+referenceNo+amt+merchantKey) |
Request Format | application/x-www-form-urlencoded |
The payment process can only be proceed after going through the registration process, please learn further about AstraPay registration API on AstraPay Registration - API E-Wallet page.
The following is a list of parameters for requesting registration of the E-Wallet AstraPay payment method. This parameter is used through the API testing platform as one of the stages so that the Merchant's system can connect with services from NICEPAY.
Parameter | Type | Size | Description | Example / Notes |
timeStamp Required | N | 14 | Request Timestamp (YYYYMMDDHH24MISS) | 20210315112359 |
iMid Required | AN | 10 | Merchant ID | IONPAYTEST |
mandateID Required | N | 40 | Mandate ID | IONPAYTEST123412345 |
payMethod Required | N | 2 | 05 | |
currency | AN | 3 | Currency | IDR |
amt | N | 12 | Payment Amount | 10000 |
goodsNm | AN | 100 | Goods Name | John Doe |
referenceNo Required | ANS | 40 | Merchant's RefNo. | ORD54321 |
billingNm Required | A | 100 | Buyer Name | John Doe |
billingPhone Required | N | 15 | Buyer Phone No. | 08123456789 |
billingEmail Required | ANS | 40 | Buyer Email | |
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 | Indonesia |
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 | Indonesia |
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 | Merchant 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 | |
Please visit E-Wallet to learn general information about E-Wallet payment method.
Following are the response parameters from the results of the request parameters for the payment of the AstraPay E-Wallet payment method.
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 | Merchant Ref. No | ncpy20221214121608 |
payMethod | N | 2 | 05 | |
amt | N | 12 | Payment Amount | 2123 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221214 |
transTm | N | 6 | Transction Time (HH24MISS) | 121608 |
mitraCd | A | 4 | ASTR | |
redirectUrlHttp | ANS | 255 | Redirect to MitraPage | https://apis.astrapay.com/merchant-service/payments/e574e878-d37f-491e-ba78-08e55de73d7 |
CartData in E-Wallet Registration is useful for declaring what items will be checked out along with item details and the price per item.
Parameter | Description | Example / Notes |
Count | Total from all card data | 2 |
Item | Divide into 4 parameter type, such as img_url, goods_name, goods_detail and goods_amt | - |
Detailed explanation on Item parameters
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, NICEPAY recommended the Merchant to do the status verification using the Status Inquiry - API E-Wallet
CallBack Handling can be very helpful to minimize the occurrence of Fraud, NICEPAY highly recommend the Merchant to do the verification using callBack Handling