NICEPAY API
...
API Versi 1
V1 Enterprise

Direct Debit - V1 Enterprise

8min

Tentang Direct Debit



NICEPAY menawarkan Direct Debit sebagai metode pembayaran. Notifikasi akan dikirimkan secara real-time setelah transaksi berhasil.

Direct Debit yang Didukung NICEPAY:

  1. CIMB Clicks
  2. Jenius Pay
Alur Direct Debit V1 Enterprise
Alur Direct Debit V1 Enterprise


Deskripsi langkah:

  1. Pelanggan melakukan checkout.
  2. Pelanggan mengajukan checkout kepada Merchant.
  3. Merchant mengajukan pendaftaran checkout kepada NICEPAY.
  4. NICEPAY mendaftarkan data checkout.
  5. NICEPAY mengirim response kepada Merchant.
  6. Merchant menampilkan halaman pembayaran kepada Pelanggan.
  7. Pelanggan memasukkan ID atau Cashing.
  8. Pelanggan mengirimkan data kepada Merchant .
  9. Merchant mengirimkan data kepada NICEPAY.
  10. NICEPAY mengajukan pembayaran kepada Bank.
  11. Bank melakukan proses autentikasi.
  12. Bank mengirimkan notifikasi kepada Pelanggan.
  13. Pelanggan melakukan autentikasi.
  14. Pelanggan mengajukan charge kepada Bank.
  15. Bank melakukan generate pesanan.
  16. Bank mengirimkan notifikasi kepada Pelanggan.
  17. Bank mengirimkan notifikasi kepada NICEPAY.
  18. NICEPAY memperbaharui status.
  19. NICEPAY mengirimkan notifikasi kepada Merchant.
  20. Merchant mengirimkan notifikasi kepada Pelanggan.



Direct Debit Registration



API Specifications - Direct Debit Registration

API Endpoint

/nicepay/api/onePass.do

Request Method 

application/x-www-form-urlencoded

POST

Description

Request Direct Debit Transaction on Bank Page

Merchant Token

SHA256(iMid+referenceNo+amt+merchantKey)

Payment Method

04 Direct Debit



Request Parameter - Direct Debit Registration

Click Pay Registrasi - Request Parameter


Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

iMid

Required

AN

10

Merchant ID

IONPAYTEST

payMethod Required 

N

2

04

currency Required 

A

3

Currency

IDR

amt Required 

N

12

Goods Amount

15000

referenceNo Required

ANS

40

Merchant Order Number

ordNo123124

goodsNm Required 

AN

100

Goods Name

Test Goods

billingNm Required 

A

A

Billing Name

John Doe

billingPhone Required 

N

15

Billing Phone Number

081249195

billingEmail Required 

ANS

40

Billing E-mail

test@merchant.com

billingCity Required

A

50

Billing City

Jakarta

billingState Required 

A

50

Billing State

DKI Jakarta

billingPostCd Required 

N

10

Billing Post Number

14350

billingCountry Required 

A

10

Billing Country

Indonesia

callBackUrl Required 

ANS

255

Payment Result Page

https://merchant.com/callBackUrl

dbProcessUrl Required 

ANS

255

Payment Notif URL

https://merchant.com/dbProcessUrl

description Required 

AN

100

Description

test item

merchantToken Required 

AN

255

Merchant Token

6cfccfc0046773c1b589d8e 98f8b596c284f3c70a4ecf8 6eba14c18944b74bcd

userIP Required

ANS

15

User IP (Customer)

127.0.0.1

cartData Required

JSON OBJECT

4000

Cart Data (JSON Format)

{}

mitraCd Required

A

4

Mitra Code

JENC

clickPayNo Required

N

16

ClickPay Card Number



dataField3 Required

N

16

Token 3 for ClickPay



clickPayToken Required

N

6

Response Token



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

test@merchant.com

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

Indonesia

vat

N

12

VAT

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

2

User Language

en-US

cashtag Required for Jenius

AN

100

Cashtag ID (with $)

$johndoe

Catatan untuk Jenius, silakan gunakan iMid : TNICECP041 dan PayMethod: 04 lalu request Staging untuk tujuan pengembangan.



Response Parameter - Direct Debit Registration

Direct Debit Registrasi - Response Parameter


Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

resultCd

N

4

Result Code

0000

resultMsg

AN

255

SUCCESS

tXid

AN

30

Transaction ID

TESTIDTEST04201803011131521855

referenceNo

ANS

40

Merchant Order Number

99997

payMethod

N

2

04

amount

N

12

Payment Amount

10000

transDt

N

8

Transaction Date (YYYYMMDD)

20180301

transTm

N

6

Transaction Time (HH24MISS)

113152

description

ANS

100

Transaction Description

Payment of referenceNo 99997

callbackUrl

ANS

100

Callback URL

http://www.merchant.com/callbackUrl

currency

A

3

Currency

IDR

goodsNm

AN

100

Goods Name

Test Transaction NICEPAY

billingNm

N

30

Buyer Name

Customer Name

mitraCd

A

4

Mitra Code

MDRC