Fiziksel POS
Ödeme İşlemleri
İptal (Void)

İptal (Void)

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.

Onaylanmış bir satışın tamamını, gün sonundan önce iptal edersiniz. Gün sonu alınmış satış void edilemez; onu iade ile geri alırsınız.

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

Ne zaman void, ne zaman iade?

İptal mi, iade mi?Onaylanmış satış gün sonundan önce ve tamamıyla geri alınacaksa void yapılır; değilse tutarın tamamı iade edilir, ürün satırlarına göre kalem bazlı iade ya da tutara göre kısmi iade yapılır; cihaza ulaşmamış ödeme başlamadan iptal edilir.EVETEVETEVETHAYIRHAYIRHAYIROnaylanmış satışı geri alGün sonundan önceve tamamı mı?Tamamı mı?Ürün satırlarınagöre mi?İptal (Void)operation: VOIDİadeREFUND · tam tutarKalem bazlı iadeREFUND + itemsKısmi iadeREFUND + amountMinorCihaza ulaşmadıysaBaşlamadan iptalLEJANTSORUVOIDİADEBAŞLAMADI
Gün sonu alındıysa (settledAt dolu) void yapılamaz. Kısmi ve kalem bazlı iade cihaz modelinin desteğini ister.
DurumYapılacak
Satış onaylandı, gün sonu alınmadı (settledAt: null), hiç ters işlem yokVoid (bu sayfa)
Gün sonu alındı (settledAt dolu)İade
Tutarın bir kısmını geri vermek istiyorsunuzKısmi İade
Ödeme cihaza henüz ulaşmadıBaşlamadan İptal

İstek

AlanTipZorunluAçıklama
operationstringEvetVOID.
currencystringEvetSatışın para birimi.
merchantReferencestring | nullHayırKendi referansınız.
startTimeoutSecondsintegerHayırCihazda başlaması için süre, 5–30 saniye.

amountMinor göndermeyin: void her zaman onaylanan tutarın tamamıdır. Gönderirseniz 400 physical_pos.payment.amount_invalid (details.reason: full_amount_operation).

source lunixi-sign.sh
REQ_PATH="/api/v1/physical-pos/payments/01900000-0000-7000-8000-000000000501/reversals"
BODY='{"operation":"VOID","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: 3d2a9f10-6b1e-4c7a-8e55-0f1d2c3b4a59" \
  --data-raw "$BODY"

Sonuç

Ters işlem yeni bir çocuk ödeme açar ve 202 döner (paymentStatus: "NOT_STARTED"). Sonucunu çocuk ödemenin webhook'uyla alırsınız (data.operation, data.rootPaymentId). Asıl ödeme için ayrı webhook gönderilmez; asıl ödemenin güncel reversalStatus değerini sorgulayarak okuyun. Void onaylanınca asıl ödemede reversalStatus: "VOIDED" olur ve bu ödemeye başka ters işlem yapılmaz.

Kurallar

  • Void yalnız satışın cihazında ve terminalinde yapılır. Başka cihaz hedeflerseniz 400 physical_pos.payment.target_invalid (details.reason: original_device_required); cihaz o arada başka terminale bağlandıysa 409 physical_pos.payment.terminal_not_payable (terminal_changed_since_original).
  • Cihaz ödemeye hazır olmalıdır; değilse 409 physical_pos.payment.device_offline.
  • Doğrudan cihazda yapılan satışta (origin: "DEVICE_DIRECT") void yapılmaz; iade yapın.
  • Ön provizyon kapamasının iptali de VOID ile yapılır: Ön Provizyon.

Hatalar

HTTPcodeNe zaman
409physical_pos.payment.void_after_settlementGün sonu alınmış; details.allowedOperation: REFUND. Aynı ödemeye yeni bir Idempotency-Key ile iade yapın.
409physical_pos.payment.not_reversiblevoid_after_reversal (önce ters işlem yapılmış), root_not_approved (satış onaylanmamış ya da sonucu belirsiz), void_preauth_not_closed.
409physical_pos.payment.reversal_in_progressSatışta sonuçlanmamış bir ters işlem var (pendingReversalId).
400physical_pos.payment.amount_invalidfull_amount_operation: void'de tutar gönderildi.
400physical_pos.payment.target_invalidoriginal_device_required.
404physical_pos.payment.not_foundSatış yok.
422physical_pos.payment.operation_unsupporteddevice_direct_refund_only ya da cihaz modeli void'i desteklemiyor.

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