Ana içeriğe atla
POST
Mali işlem sonucunu ve varsa operationId değerini saklayın. Zaman aşımında veya review_required durumunda otomatik tekrar yapmayın. Tamamlanmış tekrar cevabı ilk cevabın bütün gövdesini yeniden sunmaz. İşlem takibi

Ne yapar?

Aktif/onaylı varsayılan POS için tahsilat kaydı oluşturur; karttan çekim yapmaz. Idempotency-Key zorunludur. Cari verilirse firma sahipliği doğrulanır; komisyon hesapları geçerli olmalıdır. Cevap orderId,paymentId ve işlem makbuzudur; URL dönmez. Tekrarda güvenli resultId makbuzu kullanılır. İşlem takibi: yanıttaki operation makbuzunu saklayın; replayed=true cevabı ilk yanıtın bütün içeriğini tekrar etmez.

Ön koşullar ve izin

Etkin API anahtarı ve muhasip:pos:write izni gerekir. İlişkili kayıtlar aynı firmaya ait olmalıdır. Erişim ayarları için kimlik ve izinler rehberini inceleyin. İşlem anahtarı: Idempotency-Key zorunludur. Aynı işlem için aynı anahtarı kullanın; örnekler MUHASIP_IDEMPOTENCY_KEY ortam değişkenini kullanır. İstek ve cevap şemalarını indirin.

İstek örnekleri

Örnekler temsilîdir. Kimlikleri, belge tarihlerini ve iş verisini kendi yetkili kayıtlarınızla değiştirin. Node.js örnekleri Node.js 20 veya üzeri içindir; PHP örnekleri cURL uzantısını kullanır. Hiçbiri otomatik tekrar yapmaz.

Cevabı değerlendirin

Önce HTTP durumunu, ardından bu kaynağın status ve sonuç alanlarını değerlendirin. Bütün uçlar aynı sonuç zarfını veya oluşturma için 201 kodunu kullanmaz. Temsilî başarılı cevap; gerçek hizmet çağrısından alınmamıştır:
replayed:true varsa cevap güvenli makbuz ve sonuç kimlikleriyle sınırlı olabilir. İlk HTML/PDF veya mali gövdeyi tekrar beklemeyin. reviewRequired:true veya retryable:false yeni bir mali çağrı izni değildir.

Hata durumunda

Ağ kesintisi, zaman aşımı veya JSON olmayan cevap mali etkinin oluşmadığını kanıtlamaz. Ham istek/cevapları genel loglara yazmayın. Hata yönetimi

Sonraki adım

İşlem makbuzunu saklayın; durum adresinden kontrol edin ve sonuç kimliklerini ilgili belge/tahsilat/siparişle eşleştirin. reviewRequired=true ise yeniden göndermeden manuel inceleyin. Kaynak akışı · İşlem takibi · Kapsam ve sınırlamalar

Yetkilendirmeler

Authorization
string
header
gerekli

Kullanıcı adı apiUserId, parola secretKey. Aktif ve süresi geçmemiş API kullanıcısı ve uygun firma gerekir.

Başlıklar

Idempotency-Key
string
gerekli

Bu yeni mali işlem için zorunludur.

Required string length: 1 - 128
Pattern: ^[!-~]+$

Gövde

application/json
description
string
gerekli

Ödeme açıklaması.

amount
number
gerekli

Pozitif ve sonlu JSON sayısı; sayısal metin kabul edilmez.

Gerekli aralık: x > 0
contactsId
string | null

İlişkili cari kimliği.

changeable
boolean
varsayılan:false

Ödeme sayfasında tutar düzenleme.

installments
object

Taksit adedi anahtarı ve kullanım izni.

commissions
object

Taksit adedi anahtarı ve komisyon oranı.

Yanıt

İşlem sonucu.

İlk çağrı kaynağa özgü yanıtı ve işlem makbuzunu; tamamlanmış tekrar yalnız güvenli makbuzu ve uygun sonuç kimliklerini döndürür.

status
boolean
gerekli
orderId
string
gerekli

Kayıt kimliği.

paymentId
string
gerekli

Kayıt kimliği.

operation
object
operations
object[]
replayed
boolean