NICEPAY API
...
Checkout API
Registration - API Checkout

GPN - API Checkout

13min

Tentang GPN - API Checkout



API ini digunakan oleh Merchant untuk melakukan pengajuan pembayaran kepada NICEPAY untuk metode pembayaran GPN menggunakan Checkout API.



Alur Proses


Alur Proses GPN
Alur Proses GPN


Deskripsi langkah:

  1. Pelanggan melakukan checkout.
  2. Pelanggan mengirimkan data checkout kepada Merchant.
  3. Merchant mengirim pengajuan checkout menggunakan API Registration kepada NICEPAY.
  4. NICEPAY melakukan proses pendaftaran checkout.
  5. NICEPAY mengalihkan Merchant menuju halaman pembayaran pembayaran.
  6. Merchant menampilkan halaman NICEPAY kepada Pelanggan.
  7. Pelanggan memilih metode pembayaran.
  8. Pelanggan memasukkan data kartu.
  9. Pelanggan mengirimkan data kartu menggunakan Payment API kepada NICEPAY.
  10. NICEPAY mengajukan token kepada Bank/GPN Issuing.
  11. Bank/GPN Issuing menerima pengajuan.
  12. Bank/GPN Issuing mengirimkan token kepada NICEPAY.
  13. NICEPAY menerima response verifikasi.
  14. Pada waktu yang bersamaan:
    • NICEPAY mengalihkan Pelanggan menuju halaman DAS authentication.
    • NICEPAY mengajukan OTP kepada Bank/GPN Issuing.
  15. Bank/GPN Issuing mengirim OTP kepada Pelanggan.
  16. Pelanggan menerima OTP.
  17. Pelanggan memasukkan OTP dan mengirimkan kepada Bank/GPN Issuing.
  18. Bank/GPN Issuing melakukan validasi OTP.
  19. Bank/GPN Issuing mengirim response validasi kepada NICEPAY.
  20. NICEPAY mengajukan charge kepada Bank/GPN Issuing.
  21. Bank/GPN Issuing melakukan charge amount.
  22. Bank/GPN Issuing mengirimkan notifikasi pembayaran kepada NICEPAY.
  23. NICEPAY mengalihkan Merchant menuju callbackUrl.
  24. Merchant menampilkan callbackUrl kepada Pelanggan.
  25. NICEPAY mengirim notifikasi pembayaran kepada Merchant.
  26. Merchant menerima notifikasi.
  27. Merchant mengajukan status inquiry kepada NICEPAY.
  28. NICEPAY menerima pengajuan.
  29. NICEPAY mengirim response status inquiry kepada Merchant .
  30. Merchant menerima status akhir.
  31. Merchant mengirimkan halaman hasil transaksi kepada Pelanggan.

Sebelum melakukan pemanggilan API untuk Transaction Payment, lakukan Transaction Registration terlebih dahulu.



NICEPAY Secure Payment Page


Secure Payment Page
Secure Payment Page


Gambar di atas adalah contoh tata cara checkout pembayaran dengan metode GPN menggunakan NICEPAY Secure Payment Page.

Setelah pilih metode dengan transfer Bank, Anda akan disediakan daftar Bank yang dapat dipilih untuk melanjutkan proses pembayaran.

Proses pengajuan pendaftaran pembayaran telah selesai, Anda dapat melanjutkan proses transaksi sampai dengan penyelesaian dengan mengikuti panduan Panduan Bayar GPN.



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



ANS

14

Payment URL

Required

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

tXid

Required

AN

30

Transaction ID



IONPAYTEST00202212201342456336

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



Sample Parameter for CallbackUrl API Checkout Payment



Pada pembayaran saat Checkout, response dari request yang di-hit adalah Callback URL.

Url Request




CallBack Handling API Checkout Payment



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

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

Alur CallBack Handling
Alur CallBack Handling

Response CallBack
Url Callback