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

Result Code

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

Payment Method Code

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




Updated 23 Aug 2024
Did this page help you?
PREVIOUS
Direct Debit - API Checkout
NEXT
Payloan - API Checkout
Docs powered by Archbee