Memulai

Integrasi dengan Paprika

Persyaratan dan langkah untuk menghubungkan sistem merchant Anda ke gateway SNAP Paprika.

1. Persyaratan Integrasi

Agar Merchant dapat terhubung dengan Paprika, terdapat beberapa persyaratan dan data yang wajib disiapkan. Seluruh proses integrasi harus mengikuti ketentuan keamanan yang ditetapkan oleh ASPI (Asosiasi Sistem Pembayaran Indonesia).

Data dan Kredensial yang Harus Disiapkan Merchant

Merchant wajib menyediakan informasi berikut:

  • MERCHANT_API_KEY (UUID)
  • MERCHANT_API_SECRET (UUID)
  • MERCHANT_PUBLIC_KEY (file berformat .pem)
  • IP Address Merchant (untuk keperluan whitelist)

2. Pembuatan Public Key dan Private Key

Proses pembuatan key dilakukan menggunakan OpenSSL dengan algoritma RSA 2048-bit.

Generate Private Key (RSA 2048-bit)

Jalankan perintah berikut pada terminal:

openssl genpkey -algorithm RSA -out private_key.pem -pkeyopt rsa_keygen_bits:2048

File yang dihasilkan adalah private_key.pem.

Generate Public Key dari Private Key

Jalankan perintah berikut:

openssl rsa -pubout -in private_key.pem -out public_key.pem

File yang dihasilkan adalah public_key.pem. Public key inilah yang akan didaftarkan ke sistem Paprika sebagai bagian dari proses integrasi.


3. Informasi Endpoint Callback Merchant

Selain kredensial di atas, Merchant juga wajib menyediakan informasi endpoint berikut:

  • URL Endpoint Generate Token Callback Merchant
  • URL Endpoint(s) untuk keperluan Callback (QR dan/atau VA)

Endpoint tersebut akan digunakan oleh sistem Paprika untuk mengirimkan notifikasi transaksi pembayaran ke sistem yang dimiliki oleh Merchant.


4. Mendapatkan B2B Access Token

Untuk dapat mengakses Servis Paprika, Merchant harus terlebih dahulu memperoleh B2B Access Token melalui endpoint yang telah disediakan. Lebih lanjut mengenai cara mendapatkan B2B Access Token dapat dibaca pada halaman Generate B2B Token dan Pengisian Signature.