Müşteriler - Piyodo

Mağaza müşterilerini oku; e-posta adresine göre ekle ya da güncelle. Aynı isteği tekrar göndermek kayıt çoğaltmaz, bu yüzden dış sistemden eşitleme için uygundur.

Uçlar

Yöntem ve adres	Kapsam	Ne yapar
`GET /customers`	`customers.read`	Listeler
`GET /customers/{id}`	`customers.read`	Tek müşteri
`PUT /customers`	`customers.write`	E-postaya göre ekler ya da günceller

Liste süzgeçleri: email (tam eşleşme), group_id, updated_since.

Ekleme ve güncelleme

bash

curl -X PUT "https://piyodo.com/api/store/v1/customers" \
  -H "Authorization: Bearer psk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "name": "Mehmet Yılmaz",
    "phone": "+905551112233",
    "note": "Toptan müşteri",
    "tags": ["toptan", "istanbul"]
  }'

Alan	Not
`email`	Zorunlu. Küçük harfe çevrilir, müşteriyi bu belirler
`name`	En çok 120 karakter
`phone`	En çok 32 karakter
`note`	En çok 2000 karakter, yalnız panelde görünür
`group_id`	Mağazadaki müşteri grubunun kimliği
`tags`	En çok 10 etiket, her biri en çok 30 karakter. Gönderilirse eski etiketlerin yerine geçer

Yalnız gönderilen alanlar değişir. Yeni kayıt 201, güncelleme 200 döner. API'den eklenen müşterinin hesabı yoktur (has_account: false); mağazadan aynı e-postayla üye olabilir.

Yanıt

json

{
  "data": {
    "id": "01J...",
    "email": "[email protected]",
    "name": "Mehmet Yılmaz",
    "phone": "+905551112233",
    "address": null,
    "district": null,
    "city": null,
    "country": null,
    "group_id": null,
    "tags": ["toptan", "istanbul"],
    "note": "Toptan müşteri",
    "has_account": false,
    "marketing_opt_in": false,
    "credit_balance": "0.00",
    "created_at": "2026-11-05T10:00:00+00:00",
    "updated_at": "2026-11-05T10:00:00+00:00"
  }
}

Mağaza kredisi

credit_balance yalnız okunur. Kredi para değerindedir: API'den değiştirilemez, panelde mağaza sahibi ve yönetici yapar.

Yeni müşteri eklenince customer.created webhook'u gider.