NICEPAY API
...
Payment API
API Convenience Store

Registration - API Convenience Store

10min

Tentang API Convenience Store Registration



 menyediakan Toserba (Indomaret dan Alfamart Group) sebagai

sehingga

dapat melakukan

melalui gerai-gerai

Toserba di Seluruh

. Notifikasi real-time secara langsung akan dikirimkan ketika

berhasil.



 Toserba

:

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



API Convenience Store Registration





 ini digunakan untuk mengaktifkan


pada

, sehingga

dapat melakukan


menggunakan

dengan

. Tahapan ini digunakan untuk mengintegrasikan

dari

dengan

dari

.

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



 kunjungi

NICEPAY Code untuk mengetahui daftar istilah kode

berhubungan dengan


.



Request Parameter for Convenience Store Registration



Berikut ini adalah daftar

 untuk melakukan request registrasi


. Parameter ini digunakan melalui platform pengujian

sebagai salah satu tahapan supaya

milik

dapat terhubung dengan

dari

.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

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

Delivery 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



 kunjungi

Convenience Store (CVS) untuk mempelajari

umum mengenai


.



Additional Information Request for Convenience Store Registration



Parameter di bawah berisi

 tambahan mengenai

Registrasi

.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

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



Berikut ini adalah daftar response dari request

 inquiry pada



.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

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