GPN - API Checkout
API ini digunakan oleh Merchant untuk melakukan pengajuan pembayaran kepada NICEPAY untuk metode pembayaran GPN menggunakan Checkout API.
![Alur Proses GPN Alur Proses GPN](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/blfWNLifmcX_5PECmbMvh_nicepay-archbee-payment-gpn-redirect.png?format=webp)
Deskripsi langkah:
- Pelanggan melakukan checkout.
- Pelanggan mengirimkan data checkout kepada Merchant.
- Merchant mengirim pengajuan checkout menggunakan API Registration kepada NICEPAY.
- NICEPAY melakukan proses pendaftaran checkout.
- NICEPAY mengalihkan Merchant menuju halaman pembayaran NICEPAY.
- Merchant menampilkan halaman NICEPAY kepada Pelanggan.
- Pelanggan memilih metode pembayaran.
- Pelanggan memasukkan data kartu.
- Pelanggan mengirimkan data kartu menggunakan Payment API kepada NICEPAY.
- NICEPAY mengajukan token kepada Bank/GPN Issuing.
- Bank/GPN Issuing menerima pengajuan.
- Bank/GPN Issuing mengirimkan token kepada NICEPAY.
- NICEPAY menerima response verifikasi.
- Pada waktu yang bersamaan:
- NICEPAY mengalihkan Pelanggan menuju halaman DAS authentication.
- NICEPAY mengajukan OTP kepada Bank/GPN Issuing.
- Bank/GPN Issuing mengirim OTP kepada Pelanggan.
- Pelanggan menerima OTP.
- Pelanggan memasukkan OTP dan mengirimkan kepada Bank/GPN Issuing.
- Bank/GPN Issuing melakukan validasi OTP.
- Bank/GPN Issuing mengirim response validasi kepada NICEPAY.
- NICEPAY mengajukan charge kepada Bank/GPN Issuing.
- Bank/GPN Issuing melakukan charge amount.
- Bank/GPN Issuing mengirimkan notifikasi pembayaran kepada NICEPAY.
- NICEPAY mengalihkan Merchant menuju callbackUrl.
- Merchant menampilkan callbackUrl kepada Pelanggan.
- NICEPAY mengirim notifikasi pembayaran kepada Merchant.
- Merchant menerima notifikasi.
- Merchant mengajukan status inquiry kepada NICEPAY.
- NICEPAY menerima pengajuan.
- NICEPAY mengirim response status inquiry kepada Merchant.
- Merchant menerima status akhir.
- Merchant mengirimkan halaman hasil transaksi kepada Pelanggan.
Sebelum melakukan pemanggilan API untuk Transaction Payment, lakukan Transaction Registration terlebih dahulu.
![Secure Payment Page Secure Payment Page](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/ht4_JU7NuZ_HpXokoi-Sl_id-new-secure-payment-page-gpn.png?format=webp)
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 URL | /nicepay/redirect/v2/payment |
Request Method | Redirect-GET |
Header | Content-Type: application/Form-UrlEncoded |
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.
Pada pembayaran saat Checkout, response dari request yang di-hit adalah Callback URL.
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](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/OUMptNJjJPMmefkBqRpQS_nicepay-api-checkout-api-callback-handling-flow-1.png?format=webp)