Başlamadan İptal
- 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.
Ödeme isteği henüz cihaza ulaşmadıysa ödemeyi durdurursunuz; müşterinin kartından para çekilmez. Kartı okutulmuş, onaylanmış bir satışı geri almak bu uçla değil, İptal (Void) ya da İade ile yapılır.
İptal
POST /api/v1/physical-pos/payments/{paymentId}/cancel · Idempotency-Key isteğe bağlı · gövde {}
Komutu henüz cihaza ulaşmamış ödemeyi iptal eder. Onaylanmış ödemeyi geri almak için ters işlem kullanın. Gövde boş nesnedir ({}); başka alan 400 VALIDATION_ERROR alır.
source lunixi-sign.sh
REQ_PATH="/api/v1/physical-pos/payments/01900000-0000-7000-8000-000000000501/cancel"
BODY='{}'
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" \
--data-raw "$BODY"| Ödemenin durumu | Sonuç |
|---|---|
NOT_STARTED ve komut cihaza gönderilmemiş | Ödeme iptal edilir: paymentStatus: "EXPIRED", statusReason: "MERCHANT_CANCELLED_BEFORE_DISPATCH", replayed: false. physical_pos.payment.expired webhook'u gönderilir. |
Son durumda (APPROVED dahil) | Ödeme değişmez; güncel hâli replayed: true ile döner. |
Komut cihaza gönderilmiş ya da IN_PROGRESS | Cihaz ya da üreticisi başlamamış işlemi bırakmayı destekliyorsa bırakma istenir ve ödemenin güncel hâli replayed: false ile döner; ödemenin durumu bu yanıtta değişmez. Ödeme sonuç geldiğinde kapanır (bırakıldıysa CANCELLED). Desteklenmiyorsa 409 physical_pos.payment.not_cancellable (details.reason: command_dispatched). |
UNKNOWN ya da MANUAL_REVIEW | 409 physical_pos.payment.not_cancellable (details.reason: outcome_unknown). Para çekilmiş olabilir. |
İptal yanıtı 200 döndüğünde paymentStatus'u okuyun. Yanıt EXPIRED ve MERCHANT_CANCELLED_BEFORE_DISPATCH değilse iptal gerçekleşmemiştir: ödeme ya zaten son durumundadır ya da cihazda sürmektedir. Sonucu webhook'tan ya da ödemeyi sorgulayarak izleyin.
Yanıt (200): { "payment": { … }, "replayed": false }. İptali tekrarlamak güvenlidir. Diğer hatalar: 404 physical_pos.payment.not_found, 403 physical_pos.environment.test_key_read_only, 400 physical_pos.idempotency.key_invalid (anahtar gönderildi ama biçim dışı), 409 physical_pos.idempotency_mismatch (anahtar başka bir ödemede ya da işlemde kullanılmış), 503 physical_pos.service.busy.