Memulai•Environment & Credentials
Kredensial & Lingkungan Integrasi
Qoin menyediakan dua lingkungan terpisah untuk pengujian dan operasional produksi: **Sandbox (Staging)** untuk proses pengembangan dan uji sertifikasi, serta **Production** untuk transaksi riil pengguna.
Daftar Base URL Lingkungan
| Lingkungan | Komponen | Base URL |
|---|---|---|
| Sandbox | Webview Linkage (Mobile) | https://seamless-sandbox.qoin.id |
| Sandbox | API Gateway (Backend) | https://saas-api-sandbox.qoin.id |
| Production | Webview Linkage (Mobile) | https://seamless.qoincash.idAlias: https://seamless.qoin.id |
| Production | API Gateway (Backend) | https://saas-api.qoin.id |
Kredensial yang Diberikan Tim Integrasi Qoin
Setelah proses pendaftaran mitra/merchant disetujui, tim Qoin akan menyerahkan paket kredensial berikut:
1. Client ID & Client Secret
Digunakan saat memanggil POST /api/init-linkage untuk menghasilkan Signature.
2. Gateway RSA Public Key
Kunci publik (format PEM X.509) yang digunakan oleh server backend merchant untuk memverifikasi keaslian webhook callback transaksi.
Keamanan Kredensial: Jangan Simpan di Client APK/IPA
PENTING: Nilai
clientSecret tidak boleh di-hardcode ke dalam kode aplikasi mobile APK/IPA (karena rentan diekstrak melalui reverse engineering). Panggilan /api/init-linkage sangat disarankan dilakukan secara Server-to-Server (S2S) oleh backend client, lalu string signature diserahkan ke native app.Format Gateway RSA Public Key
Kunci publik gateway disediakan dalam format standar SPKI PEM 2048-bit:
gateway_public_key.pem
-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAy3W8r17Qp1L9P2qX5V6Z
AB8yC12D3E4F5G6H7I8J9K0L1M2N3O4P5Q6R7S8T9U0V1W2X3Y4Z5A6B7C8D9E0F
1G2H3I4J5K6L7M8N9O0P1Q2R3S4T5U6V7W8X9Y0Z1A2B3C4D5E6F7G8H9I0J1K2L
3M4N5O6P7Q8R9S0T1U2V3W4X5Y6Z7A8B9C0D1E2F3G4H5I6J7K8L9M0N1O2P3Q4R
5S6T7U8V9W0X1Y2Z3A4B5C6D7E8F9G0H1I2J3K4L5M6N7O8P9Q0R1S2T3U4V5W6X
7Y8Z9A==
-----END PUBLIC KEY-----