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ı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:payments. Ü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.
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_allowedalı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_refundya dadaily,details.limitMinordize). - 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.