API Referansına Dön MüşterilerMüşteri Oluştur

Müşteri Oluştur

POST/v1/customersRecommended

Bir müşteri kaydı oluşturur. externalId, üye işyeri başına benzersizdir.

Kimlik Doğrulama

İmza Deseni

HMAC-SHA256(secretKey, "{timestamp}\nPOST\n/v1/customers\n{sha256(body)}")

Başlık	Değer	Açıklama
`X-Api-Key`	pk_live_a1b2c3d4e5f6g7h8	Merchant public API key
`X-Signature`	{hmac_sha256_hex}	Hex HMAC-SHA256 request signature
`X-Timestamp`	2026-04-13T10:00:00Z	ISO 8601 UTC request time (±5 min)

İstek Parametreleri

Ad	Tür	Zorunlu	Açıklama
`externalId`	string	Zorunlu	Your own unique id for this customer
`email`	string	İsteğe Bağlı	Customer email (unique per merchant when set)
`phone`	string	İsteğe Bağlı	Customer phone (+90…)
`name`	string	İsteğe Bağlı	Customer name
`extraData`	object	İsteğe Bağlı	Arbitrary merchant metadata

İstek Örneği

JSONİstek Gövdesi

{
  "externalId": "CUST-4821",
  "email": "buyer@example.com",
  "phone": "+905551112233",
  "name": "Ayşe Yılmaz"
}

Yanıt Parametreleri

Alan	Tür	Örnek
`id`	string	"cus_a1b2c3d4e5f6"
`merchantId`	string	"mrc_8a1b2c3d4e5f"
`externalId`	string	"CUST-4821"
`email`	string	"buyer@example.com"
`phone`	string	"+905551112233"
`name`	string	"Ayşe Yılmaz"
`extraData`	object	{…}
`createdAt`	string	"2026-04-13T10:00:00Z"
`updatedAt`	string	"2026-04-13T10:00:00Z"

Yanıt Örneği

JSONYanıt

{
  "id": "cus_a1b2c3d4e5f6",
  "merchantId": "mrc_8a1b2c3d4e5f",
  "externalId": "CUST-4821",
  "email": "buyer@example.com",
  "phone": "+905551112233",
  "name": "Ayşe Yılmaz",
  "extraData": {},
  "createdAt": "2026-04-13T10:00:00Z",
  "updatedAt": "2026-04-13T10:00:00Z"
}

Durum Kodları

200Success

201Created

400Bad Request

401Unauthorized

404Not Found

429Rate Limited

DeneSahte

POSThttps://api.pay.sandbox.kvell.group

Müşteriyi Getir→