Ana içeriğe atla
POST

Ne yapar?

Kayıtlı işyeri bilgileriyle sağlayıcı bağlantısını doğrular. Yeni ödeme oluşturmaz. Başarılı kontrol revision değerini artırır ve connectionCheck.status=passed döndürür; hesabı kendiliğinden etkinleştirmez.

Ön koşullar ve izin

Gereken izin: muhasip:epos:write. Açık izin her durumda zorunludur; genel erişim veya yönetici yetkisi bunun yerine geçmez. write tek başına read sağlamaz. Firma kimlik bilgilerinden belirlenir; ilişkili kayıtlar aynı firmaya ait olmalıdır. Firma paketi ücretli ve süresi aktif olmalıdır. Kimlik ve izinler · E-Pos entegrasyonu

İstek örnekleri

Örnekler temsilîdir. Kimlikleri, sürümleri ve işyeri bilgilerini kendi kayıtlarınızla değiştirin. Oranlar yüzde, amountMinor değerleri kuruştur. Gereken işlem anahtarını çağrıdan önce kalıcı saklayın; otomatik tekrar yapmayın. Gerçek işyeri anahtarını güvenli sunucu ortamından sağlayın. Node.js örneği Node.js 20 veya üzeri, PHP örneği cURL uzantısı gerektirir.

Cevabı değerlendirin

Aşağıdaki cevap temsilîdir; varsa url alanı örnekte yer tutucudur. Uygulamada dönen adresi doğrudan kullanın ve günlüklemeyin. Bu çağrı genel operation makbuzu üretmez. Hesap/tercih yazmalarında güncel revision kullanın; yanıt kaybında kaydı okuyup son sürümü kontrol edin.

Hata durumunda

Hata yönetimi · İşlem takibi

Sonraki adım

E-Pos entegrasyon akışını izleyin. Hesap değişikliğinde dönen revision değerini saklayın; ödemede bağlantı oluşturmayı, müşterinin 3D işlemini ve doğrulanmış mali sonucu ayrı değerlendirin.

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.

Yol Parametreleri

accountId
string
gerekli

Aynı firmaya ait 24 haneli kayıt kimliği.

Pattern: ^[a-fA-F0-9]{24}$

Gövde

application/json
revision
integer
gerekli

Güncel hesap sürümü. Hesap değişikliği sonrasında dönen yeni değeri kullanın.

Gerekli aralık: 1 <= x <= 9007199254740990

Yanıt

İşlem cevabı; örnek temsilîdir.

status
enum<boolean>
gerekli
Mevcut seçenekler:
true
result
object
gerekli