NICEPAY API
...
Checkout API
Registration - 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