NICEPAY API
...
Checkout API
Payment - API Checkout

E-Wallet - API Checkout

20min

Tentang E-Wallet - API Checkout



 ini digunakan oleh  untuk melakukan pengajuan  kepada  untuk   menggunakan  .



Alur Proses



General

Alur E-Wallet Umum
Alur E-Wallet Umum


Deskripsi alur setelah melakukan  pesanan:

  1.  mengajukan checkout kepada .
  2.  mengirimkan pengajuan checkout menggunakan  Registration kepada .
  3.  mengirimkan response  regist kepada .
  4.  mengirimkan   kepada .
  5.  mengajukan  kepada  .
  6.   melakukan generate pesanan.
  7.  menyimpan  .
  8. Pada saat :
    • Jika  menggunakan  OVO, maka   akan mengimkan  kepada aplikasi terkait untuk melakukan .
    • Jika  menggunakan  lain (selain OVO dan AstraPay), maka   akan mengalihkan  menuju   . Kemudian,  harus melakukan login dengan akun  terkait sebelum melakukan  .
  9.  mengirimkan  kepada  .
  10.   menerima .
  11.   mengirimkan  kepada .
  12.  menerima .
  13.  mengirimkan  kepada .
  14.  menerima .
  15.  mengajukan pemeriksaan  kepada .
  16.  mengirimkan response dari pemeriksaan  kepada .
  17.  menerima  akhir.
  18.  mengirimkan konfirmasi pesanan kepada .



AstraPay

Alur E-Wallet AstraPay
Alur E-Wallet AstraPay


Deskripsi alur saat melakukan :

  1. Jika  belum memiliki akun AstraPay:
    •  request checkout kepada .
    •  mengirimkan  Registration (nicepay/api/linkEnable.do) kepada .
    •  mengirimkan account link request kepada AstraPay.
    • AstraPay menerima request  dikirim oleh .
    • AstraPay mengirimkan response pengalihan URL menuju   kepada .
    •  mengirimkan response pengalihan URL  kepada .
    •  menampilkan  pendaftaran kepada .
    •  melakukan  pendaftaran akun.
    •  mengirimkan pendaftaran akun kepada AstraPay.
    • AstraPay melakukan validasi akun.
    • AstraPay mengirimkan  kepada .
    •  mengirimkan  kepada .
    •  mengirimkan  bahwa akun sudah didaftarkan kepada .
  2.  request checkout kepada .
  3.  mengajukan  (nicepay/api/linkInitiate.do) kepada .
  4.  mengajukan  kepada AstraPay.
  5. AstraPay melakukan generate .
  6. AstraPay mengirimkan response redirect URL kepada .
  7.  mengirimkan response redirect URL   kepada .
  8.  mengalihkan  kepada   AstraPay.
  9.  melakukan verifikasi .
  10.  melakukan  kepada AstraPay.
  11. AstraPay melakukan verifikasi .
  12. AstraPay mengirimkan callback kepada .
    •  mengirimkan response kepada .
    •  menampilkan response callback kepada .
  13. AstraPay mengirimkan  kepada .
    •  menerima .
    •  mengirimkan  kepada .
    •  menerima .
  14.  request pemeriksaan   kepada .
  15.  mengirimkan response kepada .
  16.  menerima  akhir.
  17.  memperbarui   kepada .



Perbedaan Alur Proses Checkout (Redirect)

Proses checkout memiliki dua perbedaan alur, yaitu asynchronous dan synchronous. Pada alur  asynchronous,  perlu memasukkan kredensial untuk masuk ke dalam aplikasi  sebelum melakukan . Sementara untuk  synchronous,  tidak perlu memasukkan kredensial aplikasi terlebih dahulu dan dapat langsung melakukan  melalui    dikirimkan pada aplikasi .

Perbedaan alur tersebut dapat dilihat pada dua alur   di bawah ini.

Alur Proses Asynchronous

Alur Proses Asynchronouse Pada E-Wallet
Alur Proses Asynchronouse Pada E-Wallet


Deskripsi alur setelah melakukan checkout pesanan:

  1.  requests checkout kepada .
  2.  mengirimkan request checkout menggunakan  Registration kepada .
  3.  mengirimkan response  Registration kepada .
  4.  request   kepada .
  5.  mengajukan  kepada   dan menyimpan  .
  6.   melakukan generate pesanan.
  7.  menyimpan  .
  8. Jika  menggunakan  lain (selain OVO dan AstraPay), maka   akan mengalihkan  menuju   .
  9.  melakukan login dengan akun  terkait sebelum melakukan  .
  10.  mengirimkan  kepada  .
  11.   menerima .
  12.   mengirimkan  kepada .
  13.  menerima .
  14.  mengirimkan  kepada .
  15.  menerima .
  16.  request pemeriksaan  kepada .
  17.  mengirimkan response dari request pemeriksaan  kepada .
  18.  menerima  terakhir.
  19.  mengirimkan konfirmasi pesanan kepada .



Alur Proses Synchronous

Alur Proses Synchronouse pada e-Wallet
Alur Proses Synchronouse pada e-Wallet


Deskripsi alur setelah melakukan checkout pesanan:

  1.  request checkout kepada .
  2.  mengirimkan request checkout menggunakan  Registration kepada .
  3.  mengirimkan response  regist kepada .
  4.  mengirimkan   kepada .
  5.  mengajukan  kepada  .
  6.   melakukan generate pesanan.
  7.  menyimpan  .
  8.   (OVO) akan mengimkan  kepada aplikasi terkait untuk melakukan .
  9.  mengirimkan  kepada  .
  10.   menerima .
  11.   mengirimkan  kepada .
  12.  menerima .
  13.  mengirimkan  kepada .
  14.  menerima .
  15.  request pemeriksaan  kepada .
  16.  mengirimkan response dari request pemeriksaan  kepada .
  17.  menerima  akhir.
  18.  mengirimkan konfirmasi pesanan kepada .



NICEPAY Secure Payment Page E-Wallet


Secure Payment Page
Secure Payment Page


Gambar di atas adalah contoh  Checkout dengan metode  menggunakan  Secure  Page.

E-Wallet  - Secure Payment Page
E-Wallet - Secure Payment Page


Setelah  pengajuan registrasi  telah selesai,  dapat melanjutkan   sampai dengan penyelesaian dengan mengikuti Panduan Bayar E-Wallet.

Catatan untuk  ShopeePay dan OVO, silakan berikan pesan peringatan kepada  untuk membuka melalui perangkat ponsel demi memberikan pengalaman lebih baik kepada .

Success  - Secure Payment Page
Success - Secure Payment Page




API Checkout Transaction Payment



API URL

/nicepay/redirect/v2/payment

Request Method

Redirect-GET

Header

Content-Type: application/Form-UrlEncoded



Request Parameters for Payment



Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

paymentURL

Required

ANS

14

 URL



https://dev.nicepay.co.id/nicepay/redirect/v2/payment

tXid

Required

AN

30

Transaction ID



TNICEEW05100202212201020014087

Catatan untuk  ShopeePay dan OVO, silakan berikan pesan peringatan kepada  untuk membuka melalui perangkat ponsel demi memberikan pengalaman lebih baik kepada .



Response Parameters (CallbackUrl) - Payment



Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

resultCd

N

4

0000

resultMsg

AN

255

Result Message: Error Code

SUCCESS

tXid

AN

30

Transaction ID

IONPAYTEST00202212201351474222



When Success

referenceNo

ANS

40

Order Number

ordNo20221220131215



When Success

payMethod

E-Wallet, Payloan

N

2

05



When Success

amt

N

12

Transaction Amount

5000



When Success

transDt



N

8

Transaction Date (YYYYMMDD)

20221220



When Success

transTm



N

6

Transaction Time (HH24MISS)

135201



When Success

mitraCd

Direct Debit, E-Wallet, Payloan

A

4

Mitra Code

DANA



When Success

callBackUrl

ANS

255

 Result URL

https://webhook.site/7bef799f-ebe2-4328-a7b3-6d53deedca27



When Success

Catatan: Response  akan dikirimkan melalui callbackUrl dengan Content-type: application/json dan metode: POST Parameter.

Sample Parameter for CallbackUrl API Checkout Payment



Pada  saat Checkout, response dari request  melalui hit adalah Callback URL.

URL Request
Response Callback




CallBack Handling API Checkout Payment



Saat Callback diterima callbackUrl  , kami merekomendasikan  untuk melakukan verifikasi Status dengan menggunakan Status Inquiry - API Checkout.

CallBack Handling sangat penting untuk membantu meminimalisir tindakan Fraud. Kami sangat merekomendasikan  untuk melakukan verifikasi menggunakan CallBack parameter.

Alur Callback Handling
Alur Callback Handling

URL CallBack
Response CallBack