Lewati ke konten utama

Ikhtisar API

Base URL

KingsPay menyediakan dua lingkungan API untuk merchant:

LingkunganBase URL
Productionhttps://merchant-api.kingspay.id
Sandboxhttps://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 request
    • message (string): Pesan deskriptif
    • logId (string): ID unik untuk pelacakan/ debugging
    • data (object, optional): Data response (hanya saat sukses)

Kode HTTP

KodeKeterangan
200Request berhasil diproses
400Bad Request — Validasi gagal atau parameter tidak valid
401Unauthorized — Autentikasi gagal
404Not Found — Resource tidak ditemukan
500Internal Server Error — Kesalahan server