Ikhtisar API
Base URL
KingsPay menyediakan dua lingkungan API untuk merchant:
| Lingkungan | Base URL |
|---|---|
| Production | https://merchant-api.kingspay.id |
| Sandbox | https://sandbox-merchant-api.kingspay.id/ |
Semua endpoint API mengikuti format: {baseUrl}/api/v1/{resource}/{action}
Autentikasi
Detail autentikasi API akan disediakan oleh KingsPay kepada merchant terdaftar. Umumnya request memerlukan header seperti Authorization (Bearer token atau API Key) dan Content-Type: application/json.
Format Request & Response
- Content-Type:
application/json - Response: Semua response mengembalikan JSON dengan struktur:
status(boolean): Status keberhasilan requestmessage(string): Pesan deskriptiflogId(string): ID unik untuk pelacakan/ debuggingdata(object, optional): Data response (hanya saat sukses)
Kode HTTP
| Kode | Keterangan |
|---|---|
| 200 | Request berhasil diproses |
| 400 | Bad Request — Validasi gagal atau parameter tidak valid |
| 401 | Unauthorized — Autentikasi gagal |
| 404 | Not Found — Resource tidak ditemukan |
| 500 | Internal Server Error — Kesalahan server |