---
title: Integrasi & Testing GPN
slug: integrasi-and-testing-gpn
description: Informasi tentang cara integrasi dan testing pada metode pembayaran GPN dengan sistem NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/XegL0n7cR6IUZD_9ukYu4_rdrx9d8diazpgm07xfz2test-1.png
icon: {"faIcon":"fa-solid fa-book"}
docTags: 
createdAt: 2022-11-11T03:01:53.000Z
---

# Langkah Integrasi & API yang digunakan

***

1. Lakukan integrasi API Order Registration.
   - Direct: [Registration - API GPN](docId\:eO11RylC9Mj5bFM2oMWfM).
   - Redirect: [GPN - API Checkout](docId:8_77Hv9V9v1Wi9njED2a4).
2. Lakukan integrasi API Payment Charge.&#x20;
   - Direct: [Payment - API GPN](docId\:bdPMTihmuf7P9W6KhQDoJ).
   - Redirect: [Payment - API Checkout](docId\:YnNFZr9aonpJ7ZIKAFYSx).
3. Menerima *callback&#x20;*&#x64;an *push notification&#x20;*&#x64;ari NICEPAY.
4. Lakukan integrasi API Status Inquiry.
   - Direct: [Status Inquiry - API GPN](docId\:XF3Gyd2RzjUw2VPCiT0L9).
   - Redirect: [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3).
5. Opsional: lakukan integrasi API Cancel untuk membatalkan transaksi.
   - Direct: [Cancel - API GPN](docId\:yif3ys7qvm1sjxvw9TfmH).
   - Redirect: [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn).



# Cara Uji Coba GPN

***

| **Langkah Tes**                                                                                                                                                                                                                                                                                                                                                     | **Aturan dan Kondisi**                                                                                                                                                          |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1. Menggunakan kartu asli atau kartu *dummy&#x20;*&#x6D;ulai `45xxxx` atau `54xxxxx`.
2.  Masukkan informasi kartu Anda kepada sisi Merchant di bawah pilihan "*Credit Card/Debit Card*".
   - Masukkan 16 digit nomor kartu.
   - Masukkan *expiry date&#x20;*(`MM/YY`).
   - Masukkan CVV.
3. Kumpulkan informasi dan lanjutkan transaksi dan transaksi berhasil. | Kode metode pembayaran GPN: `09`<br /><br />Tipe pembayaran:<br />* *Full Payment*: pembayaran sekali jalan.
* *Recurring Payment*: pembayaran berkala dengan pembayaran token. |



# Alasan Peluang Transaksi Gagal

***

1. Kartu GPN tidak aktif atau sudah kedaluwarsa.
2. Nomor kartu GPN tidak berlaku.
3. Masa kedaluwarsa kartu GPN tidak berlaku.&#x20;
4. CVV pada kartu tidak berlaku.
5. Tidak didukung oleh jaringan *Issuer.&#x20;*
6. Sudah mencapai batas transaksi kartu GPN harian.&#x20;



# Integration Checklist & Test Case

***

- [ ] Implementasi status inquiry setelah mendapatkan *callback.*
- [ ] Implementasi status inquiry setelah mendapatkan notifikasi di dalam `dbProcessUrl`.
- [ ] Meninjau *log* pembayaran.
- [ ] Meninjau pengaturan firewall (eg. *Cloudflare* untuk pengaturan `dbprocessUrl`).
- [ ] Memeriksa implementasi `merchantToken`.
- [ ] Menjalankan tes skenario pada *Development Environment.*
- [ ] Menjalankan tes skenario pada *Production Environment.*
  [Get Sample Scenario](https://docs.google.com/spreadsheets/d/e/2PACX-1vQIaIMCM0vZ3L1cA-JkW3YxyIpjsB966fg1wTeT8qpFDowEvulIEWOoY6I4uJPL3A/pub?output=xlsx)
- [ ] Meninjau *Error Handling* (*Timeout, Failed, Negative Case*).



# Best Practice

***

- Untuk uji coba Merchant dapat memasang parameter `recurrOpt` *automatic* pada API Cancel ([Recurring Type Code](docId:7huicmz14lpUcQs_mVmFs)).
- API Cancel pada Kartu Kredit mendukung untuk membatalkan penuh dan sebagian ([Cancel Type Code](docId\:Mq9xE7wdOPR8OkZ3v-pVc)).
- Ketika notifikasi diterima pada `dbProcessUrl` Anda, NICEPAY sangat merekomendasikan Merchant untuk melakukan verifikasi notifikasi menggunakan Inquiry API.
- `Notification Handling` berguna untuk meminimalisir aksi *Fraud*, NICEPAY sangat merekomendasikan Merchant untuk melakukan verifikasi `Notification Handling`.



# See also

::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
Kunjungi halaman [Alur Pembayaran GPN](docId\:ghiIyFFMv_ABDqf4cCF5Q) untuk mengetahui proses pada sistem saat melakukan pembayaran dengan GPN.
:::

:::VerticalSplitItem
Kunjungi halaman [Tipe Metode Pembayaran GPN](docId\:kEYekPeYstONiu2iJQVM0) untuk mengetahui jenis pembayaran saat menggunakan kartu GPN.
:::
::::

::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
Kunjungi halaman [Daftar Istilah GPN](docId\:QrpRszpmgc7DERhBS8nWQ) untuk mengetahui istilah khusus yang digunakan GPN.
:::

:::VerticalSplitItem
Kunjungi halaman [FAQ GPN](docId:38L5TBCuVolwnrv_C65Ft) jika ingin mengetahui pertanyaan yang sering diajukan terkait GPN.
:::
::::

