Dokumentasi › API V1

Info Merchant

Memastikan kunci API terpasang pada usaha dan mode yang benar.

GET/v1/merchant
Berlaku diSandbox (zp_test_)Live (zp_live_)

Menjawab "kunci ini milik siapa". Pakai sekali setelah memasang kunci untuk memastikan usaha dan modenya benar, terutama bila Anda punya lebih dari satu usaha. Tidak mengubah apa pun dan tidak memuat rahasia.

Contoh kode

cURL
curl https://api-sandbox.zevalpay.com/v1/merchant \
  -H "Authorization: Bearer zp_test_KUNCI_ANDA"
PHP
<?php
$result = zevalpay('GET', '/v1/merchant');

echo $result['data']['merchant']['name'] . ' (' . $result['data']['merchant']['code'] . ')';
var_dump($result['data']['livemode']);
Node.js
const result = await zevalpay('GET', '/v1/merchant');

console.log(result.data.merchant.name, result.data.merchant.code);
console.log('live?', result.data.livemode);

Contoh respons

Berhasil
HTTP 200
{
  "data": {
    "merchant": {
      "code": "MCH261010K7Q2XD",
      "name": "Toko Contoh",
      "status": "active"
    },
    "livemode": false,
    "key": {
      "prefix": "zp_test_a1b2c3",
      "mode": "test",
      "issued_at": "2026-10-27T09:15:00+07:00",
      "last_used_at": "2026-10-29T10:02:41+07:00",
      "ip_restricted": true
    }
  }
}

Isi data

ParameterTipeKeterangan
merchant.codestringKode usaha Anda, sama dengan yang tampil di dashboard.
merchant.namestringNama usaha.
merchant.statusstringactive atau pending (belum lolos verifikasi usaha, hanya bisa memakai kunci test).
livemodebooleantrue untuk kunci live, false untuk kunci test.
key.prefixstringAwalan kunci, sama dengan yang tampil di halaman Kunci API.
key.modestringtest atau live.
key.issued_atstringWaktu kunci dibuat atau terakhir dibuat ulang (ISO 8601).
key.last_used_atstringWaktu terakhir kunci dipakai. Dibulatkan sekitar satu menit.
key.ip_restrictedbooleantrue bila kunci dibatasi daftar IP. Isi daftarnya tidak ditampilkan.