NICEPAY API
...
Payment API
API Convenience Store

Registration - API Convenience Store

10min

About API Convenience Store Registration





 provides department stores (Indomaret and Alfamart Group) as a

so

s can

with

s through Department Store Partners outlets throughout

. Real-time

s will send directly when


is successful.



 Department Store

s:

  1. Alfamart
  2. Indomaret
  3. Lawson
  4. Alfamidi
  5. Dan+Dan Store



API Convenience Store Registration



This

 uses to activate



s for

s, so


can

with


s using


with

s. This stage uses to integrate



with



.

API Endpoint

/nicepay/direct/v2/registration

Request Method

POST

Description

Performs Transaction Regist to



Merchant Token

SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)

Request Format

application/json



 visit NICEPAY Code

to find out a list of code terms related to



.



Request Parameter for Convenience Store Registration



The following is a list of

s for requesting registration of



. This

uses in



platform as one of

stages so that


's

can connect with


s.

Parameter

Type

Size

Description

Example / Notes

timeStamp

Required

N

14

Request Timestamp (YYYYMMDDHH24MISS)

20221202152801

iMid

Required

AN

10



 ID



IONPAYTEST

payMethod

Required

N

2

03

currency

Required

A

3

Currency



IDR

amt

Required

N

12

Amount



5000

referenceNo

Required

ANS

40



's Reference Number



Order12345

goodsNm 

Required

AN

100

Goods Name

Test Transaction



billingNm

Required

A

100

Buyer Name



John Doe

billingPhone

Required

N

15

Buyer Phone Number



081214714045

billingEmail

Required

ANS

40

Buyer E-Mail



billingAddr

Required

AN

100

Buyer Address



Jalan Bukit Berbunga 22

billingCity

Required

A

50

Buyer City



Jakarta

billingState

Required

A

50

Billing State



DKI Jakarta

billingPostCd

Required

N

10

Billing Post Number



12345

billingCountry

Required

A

10

Billing Country







cartData

JSONstring

4000

Cart Data



mitraCd

Required 

A

4

Mitra Code



ALMA

userIP

AN

15

User IP

127.0.0.1

dbProcessUrl

Required

ANS

255

Notification URL

https://ptsv2.com/t/test-nicepay-v2

merchantToken

Required

AN

255



 Token



fa79a58a73bf9f6d07ce84daaabb8f23da6ca61d478d4e917d2e259d5c7e1106

deliveryNm

A

30

Delivery Name



@merchant.com

deliveryPhone

N

15

Delivery Phone

12345678

deliveryAddr

AN

100

Delviery Address

Jalan Bukit Berbunga 22

deliveryCity

A

50

Delivery City

Jakarta

deliveryState

A

50

Delivery State

DKI Jakarta

deliveryPostCd

N

10

Delivery Post Code

12345

deliveryCountry

A

10

Delivery Country





description

AN

100

Transaction Description

-

reqDomain

ANS

100

Request Domain

merchant.com

reqServerIP

ANS

15

Request Server IP

127.0.0.1

reqClientVer

ANS

50

Client Version

-

userSessionID

AN

100

User Session ID

697D6922C961070967D3BA1BA5699C2C



 visit Convenience Store (CVS)

to learn general

about


s.



Additional Information Request for Convenience Store Registration



The

s below contain additional

regarding

Registration

.

Parameter

Type

Size

Description

Example / Notes

payMethod

Required

N

2







03

mitraCd

Required

A

4



 ID



IONPAYTEST

payValidDt

Required

N

8

CVS Expiry Date (YYYYMMDD)

20221212

payValidTm

Required

N

6

CVS Expiry Time (HH24MISS)

201012



Response Parameter for Convenience Store Registration



The following is a list of responses to requests for

 inquiry in




.

Parameter

Type

Size

Description

Example / Notes

resultCd

N

14

0000

resultMsg



AN

255

Result Message: Error Code

SUCCESS

tXid

AN

30

Transaction ID

IONPAYTEST03202212021529034686

referenceNo

ANS

40



 Reference Number

Order12345

payMethod

N

2

03

amt

N

12



 Amount

5000

transDt 

N

8

Transaction Date (YYYYMMDD)

20221202

transTm

N

6

Transaction Time (HH24MISS)

152903

description

AN

100

Description

null

bankCd

AN

4

Bank Code

null

vacctNo

N

20

VA Number

null

mitraCd

AN

4

Mitra Code

ALMA

payNo

N

12



 Number

9041021529034686

currency

AN

3

Currency

null

goodsNm

AN

100

Goods Name

null

billingNm

A

100

Buyer Name

null

vacctValidDt

N

8

VA Expiry Date (YYYYMMDD)

null

vacctValidTm

N

6

VA Expiry Time (HH24MISS)

null

payValidDt

N

8

Expiry Date (YYYYMMDD)

null

payValidTm

N

6

Expiry Time (HH24MISS)

null

requestURL

ANS

360

Request URL

null

paymentExpDt

N

8

QR

 Expiry Date (YYYYMMDD)

null

paymentExpTm

N

6

QR

 Expiry Time (HH24MISS)

null

qrContent

ANS

360

QR String in Plain Text

null

qrUrl

ANS

360

URL for QR Image, Valid for 5 minutes

null



Sample JSON for Convenience Store Registration


JSON Request
JSON Response
Java Request