NICEPAY Inquiry Virtual Account
Bulk integration uses for Virtual Account NICEPAY Inquiry Virtual Account type payment method. In this payment method, Merchants maintain Customer data. So, every payment from a Bank, NICEPAY requires Customer data inquiry to the Merchant. Also included for payment confirmation, NICEPAY makes a payment request to the Merchant.
![Flow NICEPAY Inquiry Virtual Account Flow NICEPAY Inquiry Virtual Account](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/OJT2u3IojTYOzGRGOaDFd_payment-va-bulk.png?format=webp)
This process aims to find out the details of the bill. After NICEPAY gets an inquiry request from the Bank. NICEPAY will call the merchant service to get detailed customer data information. Then, the data will be stored in the internal history of the NICEPAY system and sent to the Bank using the inquiry Bank response format.
API URL | https:// < merchant URL for inquiry > |
Request Method | POST (Body Raw JSON) |
Merchant Token | - |
Request Format | - |
The following is a list of parameters to proceed the NICEPAY Inquiry process to the Merchant from the executed transaction on Virtual Account's NICEPAY Inquiry Virtual Account type payment method. This parameter uses 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 |
customerId | N | 9 | Customer ID | 891011101 |
merchantToken | AN | 255 | SHA256 (Merchant ID + Customer ID + Merchant Key) | 141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b |
prefix | N | 7 | Virtual Account Prefix Number | 7015102 |
bankCd | AN | 4 | "CENA |
Following are the response parameters from the results of the request parameters for the NICEPAY to Merchant Inquiry Process.
Parameter | Type | Size | Description | Example / Notes |
billingNm | N | 100 | Customer Name | John Do |
goodsNm | AN | 100 | Goods/item name | Testing Buyin |
referenceNo | N | 40 | Reference number for payment | ordNo20221130101148 |
amt | AN | 12 | Total bill amount | 5000 Normal amount only |
resultCd | N | 4 | Result Code of inquiry status | 0000 |
resultMsg | AN | 255 | Result message for the Result Code | SUCCESS |
Payment Process NICEPAY to Merchant is the stage to continue the payment process made by the Customer. When the Bank makes a payment request to NICEPAY using a virtual account number, NICEPAY will call the merchant payment URL service to process the payment. The Merchant determines the Payment response to accept or reject payments from Customers.
API End Point | https:// < merchant URL for payment > |
Method | POST (Body Raw JSON) |
The following is a list of parameters for proceed the NICEPAY to Merchant Payment Process from transactions made on the virtual account's NICEPAY Inquiry Virtual Account type payment method. This parameter is used through the API testing platform as one of the stages so that the Merchant's system can be connected to services from NICEPAY.
Parameter | Type | Size | Description | Example / Notes |
customerId | N | 9 | Customer ID | 110000001 |
merchantToken | AN | 255 | SHA256 (Merchant ID + Customer ID + amt + Merchant Key) | 141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b |
referenceNo | AN | 40 | Reference Number From Inquiry | OrdNo202210102323223 |
prefix | N | 7 | Virtual Account Prefix Number | 7015102 |
bankCd | AN | 4 | CENA | |
amt | N | 12 | Total Bill Amount | 10000 |
tXid | AN | 30 | Transaction ID from NICEPAY | NORMALTEST02202211301010513135 |
Following are the response parameters from the results of the request parameters for the NICEPAY to Merchant Payment Process.
Parameter | Type | Size | Description | Example / Notes |
billingNm | N | 100 | Customer Name | John Doe |
goodsNm | AN | 255 | Goods/Item name | Testing Buying |
referenceNo | N | 7 | Reference Number for Payment | ordNo2022113010114 |
amt | AN | 4 | Total Bill Amount | Normal amount only |
resultCd | | 4 | Result Code of Inquiry Status | 0000 |
resultMsg | AN | 255 | Result message for the Result Code | SUCCESS |
Reversal Process NICEPAY to Merchant is a refund process that occurs caused of an issue happen from internal Bank system. In this process, NICEPAY will continue the information status receive from Bank to the Merchant.
API End Point | https:// < merchant URL for reversal> |
Method | POST (Body Raw JSON) |
![Proses Reversal VA Proses Reversal VA](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/Szs-r5qOWImlRGewe9dRb_nicepay-archbee-payment-va-reversaldrawio-4.png?format=webp)
The following is a list of parameters for performing the NICEPAY to Merchant Reversal Process from transactions made to the NICEPAY Inquiry Virtual Account type virtual account 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 |
customerId | N | 9 | Customer ID | 110000001 |
merchantToken | AN | 255 | SHA256 (Merchant ID + Customer ID + amt + Merchant Key) | 141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b |
referenceNo | AN | 40 | Reference number from inquiry | OrdNo202210102323223 |
prefix | N | 7 | Virtual account prefix number | 7015102 |
bankCd | AN | 4 | CENA | |
amt | N | 12 | Total bill amount | 10000 |
tXid | AN | 30 | Transaction ID from nicepay | NORMALTEST02202211301010513135 |
Following are the response parameters from the results of the request parameters for the NICEPAY to Merchant Reversal Process.
Parameter | Type | Size | Description | Example / Notes |
billingNm | N | 100 | Customer Name | John Doe Topup amount only |
goodsNm | AN | 100 | Goods/Item Name | Testing Reversal Transaction Topup amount only |
referenceNo | N | 40 | Reference Number for Payment | OrdNo202210102323223 |
amt | AN | 12 | Total Bill Amount | 50000 |
resultCd | | 34 | Result Code of Inquiry Status Result Code | 0000 |
resultMsg | | 255 | Result Message for the Result Code | SUCCESS |
Visit the Status Inquiry - API Checkout page to find out API to check status inquiry specific for Checkout.
Visit the Cancel - API Checkout page to find out API to cancel transaction specific for Checkout.
Visit the Status Inquiry - API Virtual Account page to find out the API Virtual Account to check status inquiry on API specific for Payment.
Visit the Cancel - API Virtual Account page to find out API Virtual Account to cancel the transaction on API specific for Payment.