Ek POS hesabı kaydedin
Ek banka veya POS hesabı oluşturur.
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
takibiNe yapar?
Ek banka veya POS hesabı oluşturur. Sağlayıcı bağlantısını doğrulamaz. Hesap status=true ile kaydedilir; varsayılan taksit haritası {“1”:true}, komisyon haritası {“1”:0} değerindedir. Cevap yeni hesap kimliğini içermez; ek hesapları GET /apps/pos?isDefault=false ile listeleyin.Ön koşullar ve izin
Etkin API anahtarı vemuhasip:pos:write izni gerekir.
İlişkili kayıtlar aynı firmaya ait olmalıdır. Erişim ayarları için kimlik ve izinler rehberini inceleyin.
İ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ğınstatus 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
İlgili liste veya detay çağrısıyla kaydı ve bağlı iş sonucunu doğrulayın. Fiziksel silme, arşiv ve mali iptali ayrı değerlendirin. Kaynak akışı · İşlem takibi · Kapsam ve sınırlamalarYetkilendirmeler
Kullanıcı adı apiUserId, parola secretKey. Aktif ve süresi geçmemiş API kullanıcısı ve uygun firma gerekir.
Gövde
application/json
Hesap adı.
Banka kodu; güncelleme işleminde kullanılmaz.
Hesaba özgü yapılandırma; ortak zorunlu alt alan listesi yoktur.
Taksit adedi anahtarı ve komisyon oranı.
Taksit adedi anahtarı ve kullanım izni.
Yalnız PUT /apps/pos/{id} tarafından kullanılır.
Yanıt
İşlem sonucu.