NICEPAY API
API Version 1 (V1)

V1 Professional

23min

❕ This  contains reference of previous   Version.  recommend  to use  newest .



NICEPAY Professional



 Professional Steps:

  1. The  registers  .
  2.  redirects   to  Secure  Page.
  3. Finish   in  Secure  Page.
  4.  will redirect   to  callbackUrl to give   .
Guide Flow v1 Professional


Steps Description:

  1. The  sends a  request.
  2. The  sends Card Data to   to create an .
  3.  sends  card data to .
  4.  will make  Page and tXid.
  5.  sends   Page and tXid to  .
  6. The  receives   Page and tXid and then save tXid into  database.
  7. The  will redirect to   Page.
  8. The  visits   Page and inputs   detail.
  9.  sends  detail to .
  10. The  sends  result.
  11.  receives  result.
    • The  will view   Result Page.
    •  sends a  to .
  12. The  receives   and checks   .
  13.  receives and sends   response to  .
  14. The  receives  response  from .
  15. The  updates   into database.
  16. The  sends  confirmation to  .



Transaction Registration



Registration API Specifications

API End Point

/nicepay/api/orderRegist.do

Request Method

application/x-www-form-urlencoded

POST

Description

Perform Transaction Registration

Merchant Token

SHA256 (iMid+referenceNo+amt+merchantKey)

Payment Methods

01 

02 

03 

04 

05 

08 

09  Card



Registration API Parameters

Sample API Request
Sample API Response


Parameter

Type

Size

Description

Example Value

iMid

Required

AN

10

 ID

IONPAYTEST

merchantToken

Required

AN

255

 Token

6cfccfc0046773c1b589d8e98f...

payMethod

Required

N

2

01

currency

Required

A

3

Currency

IDR

amt

Required

N

12

Transaction Amount

10000

cartData

Required

JSON String

4000

Transaction Cart Data



JSON

referenceNo

Required

ANS

40

 Order Number

MerchantReferenceNumber1

goodsNm

Required

AN

100

Goods Name

 Goods 1

callBackUrl

Required

ANS

255

 Result Page URL

https://merchant.com/callBackUrl

dbProcessUrl

Required

ANS

255

Push Notification URL

https://merchant.com/dbProcessUrl

userIP

Required

AN

15

User IP address

127.0.0.1

description

Required

AN

100

Transaction Description

this is test order

billingNm

Required

A

30

Billing Name

Buyer Name

billingPhone

Required

N

15

Billing Phone Number

2123456789

billingEmail

Required

ANS

40

Billing E-mail

buyer@merchant.com

billingCity

Required

A

50

Billing City

Jakarta Utara

billingState

Required

A

50

Billing State

DKI Jakarta

billingPostCd

Required

A

10

Billing Postcode

10160

billingCountry

Required

A

10

Billing Country



billingAddr

AN

100

Billing Address

Billing Address

merFixAcctId

Required for Fix-Type VA

N

40

 Fix VA Number

14015824

instmntType

Required for CC

N

2

1

instmntMon

Required for CC

N

2

Installment Month

1

deliveryNm

A

30

Delivery Name

Delivery Name

deliveryPhone

N

15

Delivery Phone Number

2123456789

deliveryAddr

AN

100

Delivery Address

Delivery Address

deliveryCity

A

50

Delivery City

Jakarta Utara

deliveryState

A

50

Delivery State

DKI Jakarta

deliveryPostCd

N

10

Delivery Postcode

10160

deliveryCountry

A

10

Delivery Country



vat

N

12

Vat Number

0

fee

N

12

Service Fee

0

notaxAmt

N

12

Tax Free Amount

0

reqDt

N

8

Request Date

20180303

reqTm

N

6

Request Time

135959

reqDomain

ANS

100

Request Domain

merchant.com

reqServerIP

ANS

15

Request Server IP Address

127.0.0.1

reqClientVer

AN

50

Request Client Version

1

userSessionID

AN

100

User Session ID

userSessionID

userAgent

Required for CC

ANS

100

User Agent Information

Mozilla

userLanguage

ANS

2

User Language

en-US

worker

AN

10

Worker

worker

vacctValidDt

N

8

 Valid Date (YYYYMMDD)

20180404

vacctValidTm

N

6

 Valid Time (HH24MISS)

235959

paymentExpDt

N

8

 Expired Date (YYYYMMDD)

20180404

paymentExpTm

N

6

 Expired Time (HH24MISS)

235959

payValidDt

N

8

CVS Valid Date (YYYYMMDD)

20180404

payValidTm

N

6

CVS Valid Time (HH24MISS)

235959

mRefNo

N

18

 Reference Number

bankcd123456789

timeStamp

N

14

Timestamp (YYYYMMDDHH24MISS)

20180404165639

mitraCd

A

4

ESHP

version

AN



Version

 Lite

shopId

Required for QRIS

AN

32

Shop ID



Note for Jenius

 use iMid: TNICECP041 and payMethod: 04 then request to Staging for developmental purposes.

Cart Data API V1

JSON


Parameter

Description

count

Total Cart Data Count

item



item -> img_url

Good's Image URL (50x50 size)

item -> goods_name

Good's Name

item -> goods_detail

Good's Description

item -> goods_amt

Good's Amount

After   registers successfully, don't forget to redirect your Client to   .



NICEPAY Secure Payment Page


Payment Page




Payment Method Selection

Payment Method Selection Page


When   click  Change , they can see   above and change their preferred .

Note for ShopeePay :

In order to better user experience to  , please request give a warning message to   so they will open their mobile device.



Payment Method QRIS Option

QRIS Payment Option


Confirm   after   open   application and scan  QR code. Then click Process.  will redirect end-user to  callbackUrl to give   .

QRIS Payment Process




Payment Method Jenius Option

QRIS Payment - Jenius


After   choose Jenius and click Process , then input Cashtag ID. After that confirmation,  can be done via Jenius application.



Transaction Payment



Payment API Specifications

API Endpoint

/nicepay/api/orderInquiry.do

Request Method application/x-www-form-urlencoded

POST

Description

URL Redirect to   Page



Payment Parameters

Sample API Request


Parameter

Type

Size

Description

Example Value

tXid

Required

AN

30

Transaction ID

IONPAYTEST02201607291027025291

optDisplayCB

N

2

Display change 

show = 0 hide = 1

optDisplayBL

N

2

Display Back Link

show = 0 hide = 1

To prevent your Client changing  , set optDisplayCB = 1.



Payment Response Parameters

Sample Response to callbackUrl with parameter


Note:  Response Parameter will be sent through callBackurl using URL String Query.

Parameter

Type

Size

Description

Example / Notes

resultCd

N

4

Result Code

0000

resultMsg

AN

255

Success

tXid

AN

30

 Trans ID

IONPAYTEST 02201607291027025291



When success

referenceNo

ANS

40

 Order No.

OrdNo20160525000



When success

authNo

N

10

 Auth No.

123456



When success (CC)

amount

N

12

Amount

1000



When success

transDt

N

8

Transaction Date

20200303



When success

transTm

N

6

Transaction Time

135959



When success

description

AN

100

Transaction Description

{{paym}} of OrdNo20160525000



When success

bankVacctNo

N

20

 Number

123457891011



When success (VA)

bankCd

A

4

VA Bank Code

BMRI



When success (VA)



Reccuring Token



When   signs contract as a Recurring ,  give a recurringToken to    response.

API Endpoint

/nicepay/api/recurringToken.do

Request Method application/x-www-form-urlencoded

POST

Description

Request  One Time Use Transaction Token recurringToken.do is almost same onePassToken.do The difference is whether using card info or using recurringToken

Merchant Token

SHA256 (Merchant ID + Reference Number + Amount + Merchant Key)

Request Parameter For Token

Parameter

Type

Size

Description

Remark

amt

N

12

Amount

10000

referenceNo

AN

40

 Order No.

20220623095906

merchantToken

AN

255

 Amount

141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b

iMid

AN

10

 ID

BMRITEST01

recurringToken

AN

100

Recurring Token

d4ef98b26f917a697691807cf737251cc15ef570a01457d15211a4f06e38ae64

instmntType

AN

2



instmntMon

N

2

Installment Month

1

Response Parameter For Token

Parameter

Type

Size

Description

Remark

resultCd

N

4

Result Code

0000

resultMsg

AN

255

SUCCESS

cardToken

AN

64

One time use  token

c954f03ef83a363f94fa26bef6ec4d08fa7693590a735386fcce6e2ef1caae8a

paymentType

AN

1

1 : 3Ds

2 : KeyIn



When Callback to your callbackurl is received, we strongly recommend s to verify  Status by using Inquiry .