Fiziksel POS
Ödeme İşlemleri
Kısmi İade

Kısmi İ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.

Satış tutarının bir kısmını iade edersiniz; kalan tutar için sonra yeni iadeler yapabilirsiniz.

POST /api/v1/physical-pos/payments/{paymentId}/reversals · physical_pos:payments · Idempotency-Key zorunlu

İstek iade ile aynıdır; amountMinor kalan iade edilebilir tutardan küçüktür:

source lunixi-sign.sh
REQ_PATH="/api/v1/physical-pos/payments/01900000-0000-7000-8000-000000000501/reversals"
BODY='{"operation":"REFUND","amountMinor":"1500","currency":"TRY"}'
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: a6f0c3d2-1b8e-4e57-8c90-3d4e5f6a7b8c" \
  --data-raw "$BODY"

Kurallar

  • Cihaz modeli kısmi iadeyi desteklemelidir. Tutarın tamamından az iade ve daha önce iade yapılmış satışta yeni iade kısmi sayılır. Desteklenmiyorsa 422 physical_pos.payment.operation_unsupported (details.reason: partial_amount_unsupported); tutarın tamamını tek seferde iade edin.
  • Birden çok kısmi iade yapabilirsiniz; ama aynı anda tek bir sonuçlanmamış iade olabilir (409 physical_pos.payment.reversal_in_progress). Öncekinin sonucunu bekleyin.
  • Kalan iade edilebilir tutar: asıl ödemenin approvedAmountMinor − reversedMinor değeri. Aşan istek 400 physical_pos.payment.refund_exceeds_remaining alır (details.remainingMinor).
  • Sonuçlanmamış iadenin tutarı asıl ödemede ayrılır (reversalReservedMinor). İade APPROVED olunca kesinleşir; DECLINED, CANCELLED, EXPIRED ya da FAILED olunca serbest kalır; sonucu belirsizken ayrılmış kalır. Bu, aynı tutarın iki kez iade edilmesini önler.

Asıl ödemede ne görürsünüz

DurumreversalStatusreversedMinor
İlk kısmi iade onaylandıPARTIALLY_REFUNDEDOnaylanan iadelerin toplamı
Sonraki iadelerle tutarın tamamı iade edildiREFUNDEDOnaylanan tutarın tamamı

Bütün ters işlem kuralları, cihaz ve banka seçimi ve hata sebepleri: Ters İşlem Kuralları. Bütün kodlar: Hata Kodları.