Pelanggan

Pelanggan adalah pihak yang ditagih. Setiap invoice harus menunjuk satu pelanggan yang sudah ada.

GET/v1/customers

Mengambil daftar pelanggan organisasi Anda

Parameter query

Parameter	Tipe	Wajib	Keterangan
search	string	Tidak	Menyaring berdasarkan nama, maksimum 120 karakter.

curl -X GET "https://tagihandigital.com/api/v1/customers" \
  -H "Authorization: Bearer td_live_API_KEY_ANDA"

Contoh respons

200 — Daftar pelanggan

[
  {
    "id": "cus_123",
    "name": "PT Maju",
    "email": "finance@maju.test",
    "phone": "08123456789",
    "address": null,
    "npwp": null,
    "createdAt": "2026-09-09T02:11:00.000Z",
    "updatedAt": "2026-09-09T02:11:00.000Z"
  }
]

Kemungkinan error

UNAUTHORIZED (401) — Header Authorization hilang, API key salah, atau key sudah dicabut.

POST/v1/customers

Membuat pelanggan baru

Parameter body

Parameter	Tipe	Wajib	Keterangan
name	string	Ya	Nama pelanggan.
email	string	Tidak	Alamat email yang sah.
phone	string	Tidak	Nomor telepon.
address	string	Tidak	Alamat.
npwp	string	Tidak	NPWP.

curl -X POST "https://tagihandigital.com/api/v1/customers" \
  -H "Authorization: Bearer td_live_API_KEY_ANDA" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "PT Maju",
  "email": "finance@maju.test",
  "phone": "08123456789"
}'

Contoh respons

201 — Pelanggan dibuat

{
  "id": "cus_123",
  "name": "PT Maju",
  "email": "finance@maju.test",
  "phone": "08123456789",
  "address": null,
  "npwp": null,
  "createdAt": "2026-09-09T02:11:00.000Z",
  "updatedAt": "2026-09-09T02:11:00.000Z"
}

Kemungkinan error

VALIDATION_ERROR (400) — Payload tidak lolos validasi. Field yang bermasalah dirinci pada `issues`.
UNAUTHORIZED (401) — Header Authorization hilang, API key salah, atau key sudah dicabut.

GET/v1/customers/{id}

Mengambil satu pelanggan

curl -X GET "https://tagihandigital.com/api/v1/customers/{id}" \
  -H "Authorization: Bearer td_live_API_KEY_ANDA"

Contoh respons

200 — Pelanggan ditemukan

{
  "id": "cus_123",
  "name": "PT Maju",
  "email": "finance@maju.test",
  "phone": "08123456789",
  "address": null,
  "npwp": null,
  "createdAt": "2026-09-09T02:11:00.000Z",
  "updatedAt": "2026-09-09T02:11:00.000Z"
}

Kemungkinan error

CUSTOMER_NOT_FOUND (404) — Pelanggan tidak ada di organisasi pemilik key.
UNAUTHORIZED (401) — Header Authorization hilang, API key salah, atau key sudah dicabut.