NICEPAY API
...
API Versi 1
V1 Enterprise

Virtual Account - V1 Enterprise

9min

Virtual Account



NICEPAY menawarkan Virtual Account sebagai metode pembayaran. Dengan ini, Pembeli dapat melakukan pembayaran melalui ATM, SMS Banking, Internet Banking, atau Mobile Banking. Real Time Notification akan dikirimkan ketika Pembeli berhasil melakukan pembayaran.

Supported Bank by NICEPAY

  1. Bank Mandiri.
  2. Bank International Indonesia Maybank.
  3. Bank Permata.
  4. Bank Permata Syariah.
  5. Bank Central Asia (BCA).
  6. Bank Negara Indonesia 46 (BNI).
  7. Bank KEB Hana Indonesia.
  8. Bank Rakyat Indonesia (BRI).
  9. Bank CIMB Niaga.
  10. Bank DANAMON.

Kami juga mendukung pembayaran Virtual Account dari Bank lain melalui ATM BERSAMA, ALTO, LINK, dan PRIMA.

VA Flow V1

  1. Merchant melakukan Request untuk Registrasi VA.
  2. Merchant menampilkan rincian dan cara pembayaran.
  3. Pembeli melakukan pembayaran dengan channel yang diinginkan (m-Banking, ATM, dll).
  4. NICEPAY mengirimkan Notifikasi ke Merchant.
Virtual Account Flow V1 Enterprise
Virtual Account Flow V1 Enterprise


Alur transaksi:

  1. Pelanggan mengirimkan data checkout kepada Merchant.
  2. Merchant mengirimkan pengajuan pendaftaran menggunakan Regist API kepada NICEPAY.
  3. NICEPAY mengirimkan response nomor VA dan TXID kepada Merchant.
  4. Merchant menyimpan nomor VA.
  5. Merchant mengirim informasi VA kepada Pelanggan.
  6. Pelanggan memasukkan nomor VA kemudian mengirimkan data kepada Bank.
  7. Bank mengirimkan informasi Inquiry kepada Pelanggan.
  8. Pelanggan melakukan pembayaran menggunakan VA kepada Bank.
  9. Bank melakukan validasi pembayaran.
  10. Bank mengirimkan informasi hasil pembayaran kepada Pelanggan.
  11. Pelanggan mengirimkan Payment Notification/Payment Message kepada Merchant.
  12. NICEPAY memperbaharui status pembayaran.
  13. NICEPAY mengirimkan notifikasi dbProcessUrl kepada Merchant.
  14. Merchant menerima notifikasi.
  15. Merchant memeriksa Inquiry Status menggunakan Inquiry API kepada NICEPAY.
  16. NICEPAY mengirim response kepada Merchant.
  17. Merchant memperbaharui status.
  18. Merchant mengirimkan konfirmasi pesanan kepada Pelanggan.



VA Registration



API Specifications - VA Registration

API Endpoint

/nicepay/api/onePass.do

Request Method application/x-www-form-urlencoded

POST

Description

Request vacctNo for Virtual Account Payment

Merchant Token

SHA256(iMid+referenceNo+amt+merchantKey)

Payment Method

02 Virtual Account



Request Parameter - VA Registration

Sample API Request


Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

iMid

Required

AN

10

Merchant ID

IONPAYTEST

payMethod Required 

AN

2

02

currency Required 

N

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

30

Billing Name

John Doe

billingPhone Required 

N

15

Billing Phone Number

08123456789

billingEmail Required 

AN

40

Billing E-Mail

test@merchant.com

billingAddr

AN

100

Billing Address

Billing Address

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 URL

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

6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf8 6eba14c18944b74bcd

userIP Required

ANS

15

User IP (Customer)

127.0.0.1

cartData Required

JSON OBJECT

4000

Cart Data (JSON Format)

{}

bankCd Required

A

4

Bank Code

CENA

deliveryNm

A

30

Delivery Name

John Doe

deliveryPhone

N

15

Delivery Phone

08125912342

deliveryAddr

AN

100

Delivery Address

Jln Merak

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

merFixAcctId

AN

40

Merchant Reserved VA ID

9999000000000001



Only VA Fix Account

vacctValidDt

N

8

VA Expiry Date (YYYYMMDD)

20200303

vacctValidTm

N

6

VA Expiry Time (HH24MISS)

135959



Response Parameter - VA Registration

Sample API Response


Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

resultCd

N

4

Result Code

0000

resultMsg

AN

255

SUCCESS

tXid

AN

30

Transaction ID

TESTIDTEST02201803011047210789

referenceNo

ANS

40

Merchant Order Number

99997

payMethod

N

2

02

amount

N

12

Payment Amount

10000

transDt

N

8

Transaction Date (YYYYMMDD)

20180301

transTm

N

6

Transaction Time (HH24MISS)

104721

description

ANS

100

Transaction Description

Payment of Reference Number 99997, This Description

callbackUrl

ANS

100

Callback URL

http://www.merchant.com/callbackUrl

bankCd

A

4

Bank Code

BMRI

bankVacctNo

N

20

VA Number

1047210789

currency

A

3

Currency

IDR

goodsNm

AN

100

Goods Name

Test Transaction {{nic}}

billingNm

A

30

Buyer Name

Thomas Alfa Edison

vacctValidDt

N

8

VA Expired Date (YYYYMMDD)

20180308

vacctValidTm

N

6

VA Expired Time (HH24MISS)

235959