NICEPAY API
...
Advance API
Virtual Account - Advance API

NICEPAY Inquiry Virtual Account

23min

About API NICEPAY Inquiry Virtual Account



Bulk

 uses for

NICEPAY Inquiry Virtual Account type

. In this

,

s maintain

data. So, every

from a

,

requires

data inquiry to


. Also included for

confirmation,

makes a

request to


.



NICEPAY Inquiry Virtual Account Flow





Flow NICEPAY Inquiry Virtual Account
Flow NICEPAY Inquiry Virtual Account




Inquiry Process NICEPAY to Merchant



This

 aims to find out

details of

bill. After

gets an inquiry request from


.

will call



to get detailed

data

. Then,

data will be stored in

internal history of



and sent to


using

inquiry

response format.

API URL

https:// < merchant URL for inquiry >

Request Method

POST (Body Raw JSON)

Merchant Token

-

Request Format

-



Inquiry Request Parameter



The following is a list of

s to



Inquiry

to


from

executed

on

's NICEPAY Inquiry Virtual Account type

. This

uses through



platform as one of

stages so that


's

can connect with

s from

.

Parameter

Type

Size

Description

Example / Notes

customerId

N

9



 ID

891011101

merchantToken

AN

255

SHA256 (Merchant ID + Customer ID + Merchant Key)

141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b

prefix

N

7



 Prefix Number

7015102

bankCd

AN

4

Bank Code

"CENA



Inquiry Response Parameter



Following are

 response

s from

results of

request

s for


to

Inquiry Process.

Parameter

Type

Size

Description

Example / Notes

billingNm

N

100



 Name

John Doe

goodsNm

AN

100

Goods/Item name

Testing Buying

referenceNo

N

40

Reference Number for



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

 Result Code

SUCCESS



Sample JSON Inquiry Process Nicepay to Merchant


JSON Request
JSON Response
Java Request




Payment Process NICEPAY to Merchant



Payment Process NICEPAY to Merchant is

 stage to continue



made by


. When


makes a

request to

using a

number,

will call



URL

to



. The

determines


response to accept or reject

s from

s.

API End Point

https:// <

 URL for

>

Method

POST (Body Raw JSON)



Payment Request Parameter



The following is a list of

s for


NICEPAY to Merchant Payment Process from

s made on


's NICEPAY Inquiry Virtual Account type

. This

is used through



platform as one of

stages so that


's

can be connected to

s from

.

Parameter

Type

Size

Description

Example / Notes

customerId

N

9



 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



 Prefix Number

7015102

bankCd

AN

4

Bank Code

CENA

amt

N

12

Total Bill Amount

10000

tXid

AN

30

Transaction ID from



NORMALTEST02202211301010513135



Payment Response Parameter



Following are

 response

s from

results of

request

s for

NICEPAY to Merchant Payment Process.

Parameter

Type

Size

Description

Example / Notes

billingNm

N

100



 Name

John Doe

goodsNm

AN

255

Goods/Item name

Testing Buying

referenceNo

N

7

Reference Number for



ordNo2022113010114

amt

AN

4

Total Bill Amount

Normal amount only

resultCd



4

Result Code of Inquiry Status

0000

resultMsg

AN

255

Result Message for

 Result Code

SUCCESS



Sample JSON Payment Process NICEPAY to Merchant


JSON Request
JSON Response
Java Request




Reversal Process NICEPAY to Merchant



Reversal Process NICEPAY to Merchant is a refund

 that occurs caused of an issue happen from internal


. In this

,

will continue



receive from

to


.

API End Point

https:// <

 URL for reversal>

Method

POST (Body Raw JSON)



Process Flow

Proses Reversal VA
Proses Reversal VA




Reversal Request Parameter



The following is a list of

s for performing

NICEPAY to Merchant Reversal Process from

s made to

NICEPAY Inquiry Virtual Account type


. This

is used through



platform as one of

stages so that


's

can connect with

s from

.

Parameter

Type

Size

Description

Example / Notes

customerId

N

9



 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



 Prefix Number

7015102

bankCd

AN

4

Bank Code

CENA

amt

N

12

Total Bill Amount

10000

tXid

AN

30

Transaction ID from



NORMALTEST02202211301010513135



Reversal Response Parameter



Following are

 response

s from

results of

request

s for

NICEPAY to Merchant Reversal Process.

Parameter

Type

Size

Description

Example / Notes

billingNm

N

100



 Name

John Doe



Topup mount only

goodsNm

AN

100

Goods/Item Name

Testing Reversal Transaction



Topup amount only

referenceNo

N

40

Reference Number for



OrdNo202210102323223

amt

AN

12

Total Bill Amount

50000

resultCd



34

Result Code of Inquiry Status Result Code

0000

resultMsg



255

Result Message for

 Result Code

SUCCESS



Sample JSON Reversal Process NICEPAY to Merchant


JSON Request
JSON Response
Java Request




See also





Status Inquiry - API Checkout

to find out

to check

inquiry specific for

.





Cancel - API Checkout

to find out

to cancel

specific for

.





Status Inquiry - API Virtual Account

to find out



to check

inquiry on

specific for

.





Cancel - API Virtual Account

to find out


to cancel


on

specific for

.