NICEPAY API
...
Payment API
API E-Wallet

Registration - API E-Wallet

13min

Tentang API for E-Wallet Registration



Saat ini

 sudah bekerja sama dengan 5 channel


memudahkan


pada


, yaitu:

  1. OVO.
  2. LinkAja.
  3. DANA.
  4. ShopeePay.
  5. AstraPay.

Tahap-tahap

 pada

OVO, LinkAja, DANA, dan ShopeePay pada umumnya adalah sama. Namun, terdapat perbedaan

signifikan pada


AstraPay. Khusus Registrasi dan Payment AstraPay, silakan kunjungi AstraPay Registration - API E-Wallet dan AstraPay Payment - API E-Wallet.



API for E-Wallet Registration







Registration digunakan supaya

dapat terhubung dengan





dengan

dari

. Sehingga



sudah disediakan dan di-host dari sisi

dapat ter

dengan

dari

.

berikut dapat digunakan untuk

OVO, LinkAja, DANA, dan ShopeePay.

API Endpoint

/nicepay/direct/v2/registration

Request Method

POST

Description

Performs Transaction Regist to



Merchant Token

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

Request Format

application/json



Request Parameter for E-Wallet 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)

20210315112359

iMid

Required

AN

10



 ID



IONPAYTEST

payMethod

Required

N

2

05

currency

Required

A

3

Currency



IDR

amt

Required

N

12

Amount



1000

referenceNo

Required

ANS

40



's Reference Number

ORD54321

goodsNm 

Required

AN

100

Goods Name



Test Transaction



billingNm

Required

A

100

Buyer Name



John Doe

billingPhone

Required

N

15

Buyer Phone Number

08123456789

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

OVOE

userIP

Required

AN

15

User IP



127.0.0.1

dbProcessUrl

Required

ANS

255

Notification URL



https://merchant.com/dbProcessUrl

merchantToken

Required

AN

255



 Token



a45e163042746131307bad89ef6cc0c517c136895a6cfe6cb77c4a62ce1ee5b3

deliveryNm

A

30

Delivery Name

John Doe

deliveryPhone

N

15

Delivery Phone

8124125931

deliveryAddr

AN

100

Delviery Address

Jln Merdeka Riau 161

deliveryCity

A

50

Delivery City

Riau

deliveryState

A

50

Delivery State

Riau

deliveryPostCd

N

10

Delivery Post Code

14350

deliveryCountry

A

10

Delivery Country





vat

N

12





0

fee

N

12

Service Fee

0

description

AN

100

Transaction Description

Test Transaction

reqDomain

ANS

100

Request Domain

merchant.com

reqServerIP

ANS

15

Request Server IP

127.0.0.1

userIP

Required

AN

15

User IP Address

127.0.0.1

reqClientVer

ANS

50

Client Version

1.0

userSessionID

AN

100

User Session ID

userSessionID

userAgent

ANS

100

User Agent

Mozilla

userLanguage

A

2

User Language

en-US

userAgent

Required

ANS

100

User Agent Information

Mozilla

NotaxAmt

N

12

Tax-Free Amount



reqDt

N

8

Request Date (YYYYMMDD)



reqTm

N

6

Request Time (HH24MISS)





 kunjungi E-Wallet untuk mempelajari

umum mengenai


.



Response Parameter for E-Wallet Registration



Berikut adalah response parameter dari hasil request parameter untuk melakukan pendaftaran



.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

resultCd

N

4

0000

resultMsg

AN

255

Result Message: Error Code

SUCCESS

tXid

AN

30

Transaction ID

IONPAYTEST05202103151123583200

referenceNo

ANS

40



 Reference Number

ORD54321

payMethod

N

2

05

amt

N

12



 Amount

1000

transDt

N

8

Transaction Date (YYYYMMDD)

20210315

transTm

N

6

Transction Time (HH24MISS)

112358

description

AN

100

Transaction Description

null

bankCd

A

4

Bank Code

null

vacctNo

N

20



 Number

null

mitraCd

A

4

Mitra Code

OVOE

payNo

N

12

CVS

 Number

null

currency

A

3

Currency

IDR

goodsNm

AN

100

Goods Name

Test Transaction



billingNm

A

100

Buyer Name

John Doe

payValidDt

N

8

CVS Expiry Date (YYYYMMDD) (CVS)

null

payValidTm

N

6

CVS Expiry Time (HH24MISS) (CVS)

null

vacctValidDt

N

8

Expiry Date (YYYYMMDD)

null

vacctValidTm

N

6

Expiry Time (HH24MISS)

null

requestURL

ANS

360

Request URL

null

paymentExpDt

N

6

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 E-Wallet Registration


JSON Request
JSON Response
Java Request




Cart Data E-Wallet Registration



CartData pada Registrasi

 berisi daftar item

akan melalui checkout berserta detail item dan harga per item-nya.

Parameter

Deskripsi

Contoh

Count

Total jumlah dari keseluruhan card data

2

Item

Terbagi menjadi 4 macam

, yaitu img_url, goods_name, goods_detail, dan goods_amt

-



Penjelasan detail pada

 Item.

Parameter

Deskripsi

Contoh

img_url

URL Gambar Barang (Ukuran 50px x 50px)

htttps://www.merchant.com/image_goods1.jpg

goods_name

Nama Barang

Nama Item-1

goods_detail

Deskripsi Detail Barang

Detail Item-1

goods_amt

Harga Barang

1000

goods_quantity

Jumlah barang

1


cartData E-Wallet Registration