Environment TEST
Bangun dan uji integrasi Anda di TEST. Environment ini dipakai untuk memeriksa request, checkout, perubahan status, dan webhook tanpa menganggap hasilnya sebagai transaksi produksi.
Produksi belum tersedia
Pemrosesan pembayaran produksi dinonaktifkan saat ini. Adanya istilah PRODUCTION atau field livemode dalam kontrak tidak berarti Anda
bisa menjalankan transaksi live. Jangan menghubungkan alur TEST dengan pemenuhan pesanan nyata.
Apa yang menentukan environment?
API key terikat pada project dan environment. Request memakai konteks key tersebut, bukan parameter environment yang dikirim browser.
| Bagian integrasi | Yang harus Anda cocokkan |
|---|---|
| API key | Key aktif untuk project TEST yang sedang diuji. |
| Payment | ID dibuat pada project dan environment yang sama dengan key. |
| Endpoint webhook | Endpoint aktif untuk project dan environment pembayaran. |
| Webhook secret | Secret dari endpoint tersebut, bukan secret project lain. |
| Database aplikasi Anda | Data pesanan uji terpisah dari pesanan nyata. |
Pembayaran dari project lain tidak bisa diambil hanya dengan mengetahui ID-nya. HTTP 404 dapat berarti pembayaran tidak ada dalam konteks key yang Anda gunakan.
Kenali data TEST pada respons
Payment dan event TEST memiliki livemode: false. Pada receiver webhook, cocokkan nilai ini dengan environment aplikasi Anda setelah signature diverifikasi. Jangan menandai pesanan nyata sebagai lunas berdasarkan event TEST.
Gunakan referensi seperti order-book-1001 untuk fixture uji dan data pelanggan sintetis. Jangan menyalin credential produksi, data pribadi, atau payload provider ke sandbox.
Pilih alamat layanan yang benar
Alamat dashboard, API, dan checkout memiliki fungsi berbeda. Contoh dokumentasi memakai VALCENTRA_API_URL untuk origin API yang dikonfigurasi pada layanan Anda. Endpoint relatif seperti /v1/payments ditambahkan ke origin itu.
Jangan menebak hostname sandbox dari nama environment. Gunakan alamat yang diberikan untuk deployment Anda, dan gunakan checkout_url dari respons API untuk halaman pembayaran.
Apa yang belum dibuktikan pengujian TEST?
- Kredensial atau koneksi ke provider live.
- Settlement uang nyata dan pencairan dana.
- Kesiapan operasional transaksi produksi.
Ketika akses produksi tersedia di masa depan, credential, konfigurasi endpoint, dan pemantauan harus diverifikasi kembali. Jangan sekadar mengganti flag TEST pada aplikasi.
Lanjutkan ke: pengujian sandbox untuk daftar skenario yang perlu Anda periksa.