Fiziksel POS
Ödeme İşlemleri
Eşleşmesiz İade

Eşleşmesiz İade

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.

Bir satışa bağlı olmayan iadeyi, satış ile aynı uçtan operation: "REFUND_UNMATCHED" ile başlatırsınız. Müşteri kartını cihaza okutur; iade karta yapılır.

source lunixi-sign.sh
REQ_PATH="/api/v1/physical-pos/payments"
BODY='{"operation":"REFUND_UNMATCHED","target":{"deviceId":"00000000-0000-0000-0000-000000000401"},"amountMinor":"2500","currency":"TRY","merchantReference":"RET-2026-000012"}'
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: 9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d" \
  --data-raw "$BODY"

Kurallar

Eşleşmesiz iade (REFUND_UNMATCHED), bir satışa bağlı olmayan iadedir: müşterinin kartına, Lunixi'de kaydı bulunmayan bir satış için para iade edilir. Ödeme başlatma ucuyla yapılır.

  • Hesap ayarlarınızda varsayılan olarak kapalıdır; kapalıyken istek 422 physical_pos.payment.operation_unsupported (details.reason: disabled_by_setting) alır. Ayar panelden yönetilir.
  • Ayar "yalnız panelden" olarak açıksa API anahtarıyla yapılan istek 403 physical_pos.auth.api_key_not_allowed alır.
  • Para birimi ayardaki para birimi olmalıdır; aksi 400 physical_pos.payment.currency_unsupported (details.reason: unmatched_refund_currency).
  • İşlem başına ve günlük tavan uygulanır: aşılırsa 422 physical_pos.payment.unmatched_refund_limit_exceeded (details.reason: per_refund ya da daily, details.limitMinor dize).
  • Her eşleşmesiz iade için hesap sahibine e-posta ve panel bildirimi gönderilir.

Sonucu webhook ile alırsınız: physical_pos.payment.approved, …partially_approved, …declined, …cancelled, …expired, …failed, …unknown ya da …manual_review. Webhook beklemek istemezseniz ödemeyi sorgulayın.