NICEPAY API
...
API Version 1 (V1)
V1 Enterprise

Convenience Store (CVS) - V1 Enterprise

8min

Convenience Store



 offers (CVS) as . This method allows to make at their nearest s, such as Alfamart and Indomaret. Real-Time Notification will be sent when has completed .

Supported CVS by NICEPAY

  1. Alfamart.
  2. Indomaret.
  3. Lawson.
  4. Alfamidi.
  5. Dan+Dan Store.
CVS Flow V1 Enterprise
CVS Flow V1 Enterprise


CVS Flow:

  1. The does .
  2. The sends data to .
  3.  registers using Regist to .
  4.  validates and generates Number.
  5.  sends Number to .
  6.  sends Number to .
  7. The gives CVS number to CVS.
  8. The sends data CVS number to CVS.
  9. CVS sends inquiry data to .
  10.  processes inquiry.
  11.  sends about inquiry to CVS.
  12. The completes .
  13. The sends processing to CVS.
  14. CVS makes evidence.
  15. CVS sends evidence to .
  16. CVS sends to .
  17.  updates .
  18.  sends to .
  19.  requests check using to .
  20.  receives request.
  21.  sends response to .
  22.  receives final .
  23.  sends result to .



CVS Registration



API Specifications - CVS Registration

API Endpoint

/nicepay/api/onePass.do

Request Method application/x-www-form-urlencoded

POST

Description

Request payNo to Perform CVS on 

Merchant Token

SHA256(iMid+referenceNo+amt+merchantKey)

Payment Method

03 

Request Parameter - CVS Registration

Convenience Store Registrasi - Request Parameter


Parameter

Type

Size

Description

Example Value

iMid

Required

AN

10

 ID

IONPAYTEST

payMethod Required 

N

2

03

currency Required 

A

3

Currency

IDR

amt Required 

N

12

Goods Amount

1000

referenceNo Required

ANS

40

 Order Number

MerchantReferenceNumber001

goodsNm Required 

AN

100

Goods Name

 Goods 1

billingNm Required 

A

A

Billing Name

John Doe

billingPhone Required 

N

15

Billing Phone Number

081234567890

billingEmail Required 

ANS

40

Billing E-Mail

billingCity Required

A

50

Billing City

Jakarta

billingState Required 

A

50

Billing State

DKI Jakarta

billingPostCd Required 

N

10

Billing Post Number

12345

billingCountry Required 

A

10

Billing Country



callBackUrl Required 

ANS

255

 Result URL

https://merchant.com/callBackUrl

dbProcessUrl Required 

ANS

255

 Notif URL

https://merchant.com/dbProcessUrl

description Required 

AN

100

Description

test item

merchantToken Required 

AN

255

 Token

6cfccfc0046773c1b589d8e 98f8b596c284f3c70a4ecf8 6eba14c18944b74bcd

userIP Required

ANS

15

User IP ()

127.0.0.1

cartData Required

JSON OBJECT

4000

Cart Data (JSON Format)

{}

mitraCd Required

A

4

Mitra Code

ALMA

billingAddr

AN

255

Billing Address

Jln Cendrawasih

deliveryNm

A

30

Delivery Name

John Doe

deliveryPhone

N

15

Delivery Phone

08125912342

deliveryAddr

AN

100

Delivery Address

Jln Merak

deliveryEmail

ANS

100

Delivery E-Mail

deliveryCity

A

50

Delivery City

Jakarta

deliveryState

A

50

Delivery State

DKI Jakarta

deliveryPostCd

A

10

Delivery Post Code

14350

deliveryCountry

A

10

Delivery Country



vat

N

12



0

fee

N

12

Service Tax

0

notaxAmt

N

12

Tax Free Amount

0

reqDt

N

8

Request Date (YYYYMMDD)

20160301

reqTm

N

6

Request Time (HH24MISS)

135959

reqDomain

ANS

100

Request Domain

merchant.com

reqServerIP

ANS

15

Request Server IP

127.0.0.1

reqClientVer

ANS

50

Request Client Version

1.0

userSessionID

AN

100

User Session ID

userSessionID

userAgent

ANS

100

User Agent

Mozilla

userLanguage

ANS



User Language

en-US

payValidDt

N

8

CVS Expired Date (YYYYMMDD)

20160303

payValidTm

N

6

CVS Expired Time (HH24MISS)

135959



Response Parameter - CVS Registration

JSON


Parameter

Type

Size

Description

Example / Notes

resultCd

N

4

Result Code

0000

resultMsg

AN

255

10000

goodsNm

AN

100

Goods Name

Test Transaction

tXid

AN

30

Transaction ID

TESTIDTEST03201803011108471311

referenceNo

ANS

40

 Order Number

99997

payMethod

N

2

03

amount

N

12

 Amount

10000

transDt

N

8

Transaction Date (YYYYMMDD)

20180301

transTm

N

6

Transaction Time (HH24MISS)

110847

mitraCd

A

4

Mitra Code

ALMA

payNo

N

12

CVS Number

011108471311