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