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ı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.
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 − reversedMinordeğeri. Aşan istek400 physical_pos.payment.refund_exceeds_remainingalır (details.remainingMinor). - Sonuçlanmamış iadenin tutarı asıl ödemede ayrılır (
reversalReservedMinor). İadeAPPROVEDolunca kesinleşir;DECLINED,CANCELLED,EXPIREDya daFAILEDolunca 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
| Durum | reversalStatus | reversedMinor |
|---|---|---|
| İlk kısmi iade onaylandı | PARTIALLY_REFUNDED | Onaylanan iadelerin toplamı |
| Sonraki iadelerle tutarın tamamı iade edildi | REFUNDED | Onaylanan 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ı.