Kart Sağlayıcı Satırları
- Taban yol
/api/v1/physical-pos- Kimlik
- Her istekte Ed25519 istek imzası —
X-Key-Id,X-Date,X-Nonce,X-Signature; gövdeli isteklerde ayrıcaDigest. Zaman penceresi ±5 dk, nonce tek kullanımlık. Bearer jetonu ya da panel oturumu bu uçlarda kabul edilmez. - Yetki
- Anahtarınız Fiziksel POS ürününü (
PHYSICAL_POS) ve bu sayfadaki uçların kapsamını taşımalıdır:physical_pos:view·physical_pos:manage. Ürünü olmayan anahtar403 PRODUCT_NOT_ENABLED, kapsamı olmayan anahtar403 API_INSUFFICIENT_SCOPEalır. Bkz. Kimlik Doğrulama ve Kapsamlar. - Çapraz yüzey
- Bu uçlar s2s yüzeyindedir; kendi sunucunuzdan imzalı istekle çağırırsınız. Aynı kayıtların panelde ekranları var, ama panel uçları API anahtarıyla çağrılamaz; bu uçlar da panel oturumuyla çağrılamaz.
Yemek kartı gibi kapalı devre kartlarla ödeme almak için mantıksal terminale, kart sağlayıcısının size verdiği üye işyeri ve terminal kodlarını bir sağlayıcı satırı olarak eklersiniz. Banka kartları için kullanılan banka satırlarının kapalı devre karşılığıdır. Satışta hangi satırın kullanılacağı: Yemek Kartıyla Satış.
| Yöntem | Yol | Kapsam |
|---|---|---|
GET | /api/v1/physical-pos/terminals/{terminalId}/providers | physical_pos:view |
POST | /api/v1/physical-pos/terminals/{terminalId}/providers | physical_pos:manage |
PATCH | /api/v1/physical-pos/terminal-providers/{terminalProviderId} | physical_pos:manage |
Satır, sağlayıcının üretici hesabına bağlanır (vendorAccountId). Sağlayıcı hesabını ve gizli kimlik bilgilerini panelde Entegrasyonlar ekranından eklersiniz; bu işlemin API ucu yoktur. Bugün desteklenen sağlayıcı: METROPOL.
- Test anahtarı satırları okur; yazma
403 physical_pos.environment.test_key_read_onlyalır. - Yazma istekleri terminal yazma oran sınırına tabidir: 60 saniyede API anahtarı başına 30 istek.
Sağlayıcı satırı nesnesi
| Alan | Tip | Açıklama |
|---|---|---|
id | string | Satırın kimliği. Ödemede terminalProviderId olarak gönderirsiniz. |
terminalId | string | Mantıksal terminal. |
environment | string | LIVE ya da TEST. |
providerCode | string | Kart sağlayıcısı, ör. METROPOL. Bağlı üretici hesabından gelir. |
vendorAccountId | string | Sağlayıcının üretici hesabı. |
merchantCode | string | Sağlayıcıdaki üye işyeri kodu. |
terminalCode | string | Sağlayıcıdaki terminal kodu. |
productCode | string | null | Sağlayıcıdaki ürün kodu. |
label | string | null | Kendi açıklamanız. |
providerStatus | string | ACTIVE ya da DISABLED. Ödeme yalnız ACTIVE satırla alınır. |
rowVersion | integer | Kaydın sürümü; güncellemede gönderirsiniz. |
createdAt, updatedAt | string | Oluşturma ve son değişiklik zamanı. |
Listeleme
GET /api/v1/physical-pos/terminals/{terminalId}/providers · physical_pos:view
limit (1–100, varsayılan 25), cursor ve includeTotal alır. Yanıt { "items": [ … ], "pageInfo": { … } }; öğe sağlayıcı satırıdır.
source lunixi-sign.sh
REQ_PATH="/api/v1/physical-pos/terminals/00000000-0000-0000-0000-000000000301/providers"
lunixi_sign GET "$REQ_PATH"
curl "https://api-gateway.lunixi.com$REQ_PATH" \
-H "X-Key-Id: $LUNIXI_KEY_ID" \
-H "X-Date: $DATE" \
-H "X-Nonce: $NONCE" \
-H "X-Signature: $SIGNATURE"Ekleme
POST /api/v1/physical-pos/terminals/{terminalId}/providers · physical_pos:manage
Idempotency-Key başlığı zorunludur. Yeni satır 201, aynı anahtar ve aynı gövdeyle tekrar 200 ve replayed: true döner.
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
vendorAccountId | string (UUID) | Evet | Sağlayıcının aynı ortamdaki üretici hesabı. |
merchantCode | string | Evet | Üye işyeri kodu. METROPOL: 10 rakam. |
terminalCode | string | Evet | Terminal kodu. METROPOL: 10 rakam. |
productCode | string | Sağlayıcıya göre | Ürün kodu. METROPOL'de zorunlu: 1–5 rakam, sıfırla başlamaz. |
label | string | Hayır | En çok 64 karakter. |
Biçime uymayan kod 400 physical_pos.input.code_invalid (details.field) alır; değer yanıtta yer almaz.
source lunixi-sign.sh
REQ_PATH="/api/v1/physical-pos/terminals/00000000-0000-0000-0000-000000000301/providers"
BODY='{"vendorAccountId":"00000000-0000-0000-0000-000000000601","merchantCode":"1234567890","terminalCode":"0987654321","productCode":"1","label":"Kasa 1 yemek kartı"}'
lunixi_sign POST "$REQ_PATH" "$BODY"
curl -X POST "https://api-gateway.lunixi.com$REQ_PATH" \
-H "Content-Type: application/json" \
-H "X-Key-Id: $LUNIXI_KEY_ID" \
-H "X-Date: $DATE" \
-H "X-Nonce: $NONCE" \
-H "Digest: $DIGEST" \
-H "X-Signature: $SIGNATURE" \
-H "Idempotency-Key: 5f2a7c9e-1b4d-4a8e-9c3f-6d0b8e2a4c71" \
--data-raw "$BODY"Örnekte data alanı gösterilmiştir.
{
"provider": {
"id": "00000000-0000-0000-0000-000000000351",
"terminalId": "00000000-0000-0000-0000-000000000301",
"environment": "LIVE",
"providerCode": "METROPOL",
"vendorAccountId": "00000000-0000-0000-0000-000000000601",
"merchantCode": "1234567890",
"terminalCode": "0987654321",
"productCode": "1",
"label": "Kasa 1 yemek kartı",
"providerStatus": "ACTIVE",
"rowVersion": 1,
"createdAt": "2026-01-02T09:00:00.000Z",
"updatedAt": "2026-01-02T09:00:00.000Z"
},
"replayed": false
}- Terminalde aynı sağlayıcının etkin bir satırı varsa ya da aynı üye işyeri ve terminal kodu çifti hesabınızda başka bir terminalde etkinse
409 physical_pos.terminal_provider.duplicate. - Üretici hesabı ödeme sağlayıcısı hesabı değilse
400 physical_pos.vendor_account.vendor_not_supported; hesap yoksa404 physical_pos.vendor_account.not_found.
Güncelleme
PATCH /api/v1/physical-pos/terminal-providers/{terminalProviderId} · physical_pos:manage
Satırın açıklamasını değiştirir ya da satırı devre dışı bırakır. Kodlar değiştirilemez; yanlış kodlu satırı devre dışı bırakıp yenisini ekleyin.
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
rowVersion | integer | Evet | Satırın okuduğunuz rowVersion değeri. |
label | string | null | Hayır | Yeni açıklama; null ya da "" kaldırır. |
status | string | Hayır | ACTIVE ya da DISABLED. |
label ya da status'tan en az biri gönderilmelidir; ikisi de yoksa 400 physical_pos.input.empty_patch. Yanıt { "provider": { … } }.
source lunixi-sign.sh
REQ_PATH="/api/v1/physical-pos/terminal-providers/00000000-0000-0000-0000-000000000351"
BODY='{"rowVersion":1,"status":"DISABLED"}'
lunixi_sign PATCH "$REQ_PATH" "$BODY"
curl -X PATCH "https://api-gateway.lunixi.com$REQ_PATH" \
-H "Content-Type: application/json" \
-H "X-Key-Id: $LUNIXI_KEY_ID" \
-H "X-Date: $DATE" \
-H "X-Nonce: $NONCE" \
-H "Digest: $DIGEST" \
-H "X-Signature: $SIGNATURE" \
--data-raw "$BODY"Hatalar
| HTTP | code | Ne zaman |
|---|---|---|
400 | physical_pos.idempotency.key_required · .key_invalid | Eklemede Idempotency-Key yok ya da biçim dışı. |
400 | physical_pos.input.code_invalid | Kod ya da status biçim dışı (details.field). |
400 | physical_pos.input.empty_patch | Güncellemede değişecek alan yok. |
400 | physical_pos.vendor_account.vendor_not_supported | Üretici hesabı kapalı devre kart sağlayıcısı değil. |
403 | physical_pos.environment.test_key_read_only | Yazma test anahtarıyla yapıldı. |
404 | physical_pos.terminal.not_found | Terminal yok, size ait değil ya da diğer ortamda. |
404 | physical_pos.terminal_provider.not_found | Sağlayıcı satırı bulunamadı. |
404 | physical_pos.vendor_account.not_found | Üretici hesabı bulunamadı. |
409 | physical_pos.terminal_provider.duplicate | Aynı sağlayıcının etkin satırı ya da aynı kod çifti zaten var. |
409 | physical_pos.terminal.closed | Terminal kapatılmış. |
409 | physical_pos.version_conflict | rowVersion güncel değil. |
409 | physical_pos.idempotency_mismatch | Anahtar başka bir gövdeyle kullanılmış. |
429 | RATE_LIMITED | Oran sınırı aşıldı. |
Bütün kodlar: Hata Kodları.