Fiziksel POS
Ödeme İşlemleri
Başlamadan İptal

Başlamadan İptal

Bu uçları kim çağırır?Dış API (s2s)
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ıca Digest. 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:payments. Ürünü olmayan anahtar 403 PRODUCT_NOT_ENABLED, kapsamı olmayan anahtar 403 API_INSUFFICIENT_SCOPE alı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.

Ödeme isteği henüz cihaza ulaşmadıysa ödemeyi durdurursunuz; müşterinin kartından para çekilmez. Kartı okutulmuş, onaylanmış bir satışı geri almak bu uçla değil, İptal (Void) ya da İade ile yapılır.

İptal

POST /api/v1/physical-pos/payments/{paymentId}/cancel · Idempotency-Key isteğe bağlı · gövde {}

Komutu henüz cihaza ulaşmamış ödemeyi iptal eder. Onaylanmış ödemeyi geri almak için ters işlem kullanın. Gövde boş nesnedir ({}); başka alan 400 VALIDATION_ERROR alır.

source lunixi-sign.sh
REQ_PATH="/api/v1/physical-pos/payments/01900000-0000-7000-8000-000000000501/cancel"
BODY='{}'
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" \
  --data-raw "$BODY"
Ödemenin durumuSonuç
NOT_STARTED ve komut cihaza gönderilmemişÖdeme iptal edilir: paymentStatus: "EXPIRED", statusReason: "MERCHANT_CANCELLED_BEFORE_DISPATCH", replayed: false. physical_pos.payment.expired webhook'u gönderilir.
Son durumda (APPROVED dahil)Ödeme değişmez; güncel hâli replayed: true ile döner.
Komut cihaza gönderilmiş ya da IN_PROGRESSCihaz ya da üreticisi başlamamış işlemi bırakmayı destekliyorsa bırakma istenir ve ödemenin güncel hâli replayed: false ile döner; ödemenin durumu bu yanıtta değişmez. Ödeme sonuç geldiğinde kapanır (bırakıldıysa CANCELLED). Desteklenmiyorsa 409 physical_pos.payment.not_cancellable (details.reason: command_dispatched).
UNKNOWN ya da MANUAL_REVIEW409 physical_pos.payment.not_cancellable (details.reason: outcome_unknown). Para çekilmiş olabilir.
⚠️

İptal yanıtı 200 döndüğünde paymentStatus'u okuyun. Yanıt EXPIRED ve MERCHANT_CANCELLED_BEFORE_DISPATCH değilse iptal gerçekleşmemiştir: ödeme ya zaten son durumundadır ya da cihazda sürmektedir. Sonucu webhook'tan ya da ödemeyi sorgulayarak izleyin.

Yanıt (200): { "payment": { … }, "replayed": false }. İptali tekrarlamak güvenlidir. Diğer hatalar: 404 physical_pos.payment.not_found, 403 physical_pos.environment.test_key_read_only, 400 physical_pos.idempotency.key_invalid (anahtar gönderildi ama biçim dışı), 409 physical_pos.idempotency_mismatch (anahtar başka bir ödemede ya da işlemde kullanılmış), 503 physical_pos.service.busy.