Ana içeriğe atla
PATCH

Ne yapar?

Güncel revision ile ad, oran, kimlik veya durum değiştirir. Pasifleştirme status=disabled, arşivleme status=archived ile yapılır. Arşivli hesap düzenlenemez. Etkinleştirme geçerli bağlantı ve sağlayıcı desteği ister. Başarılı değişiklik yeni revision döndürür; önceki sürümdeki açık ödeme bağlantıları etkilenebilir.

Ö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 dışında en az bir alan gönderin. providerCode/ortam değişmez. Arşivli hesap düzenlenemez; bağlantılı işyeri kimliği değiştirilemez.

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
name
string
Required string length: 1 - 120
identity
object

Sağlayıcının gizli olmayan işyeri kimliği. Hoppa için merchant.

currencies
string[]
Required array length: 1 - 30 elements
Pattern: ^[A-Z]{3}$
installments
integer[]

Gönderilirse oran satırlarının aktif taksitleriyle birebir eşleşmelidir.

Required array length: 1 - 99 elements

1 tek çekimdir. Yeni Hoppa talebinde 1–12 arasında ve hesapta aktif olmalıdır.

Gerekli aralık: 1 <= x <= 99
installmentRates
object[]

Benzersiz taksitler; en az bir aktif satır. Aktif satırın genel satış oranı zorunludur.

Required array length: 1 - 99 elements
familySaleRates
object[]

En fazla 32 farklı aile; aile+taksit benzersizdir. Taksit hesap oranlarında tanımlı olmalıdır. Boş dizi aile tarifelerini kaldırır.

Maximum array length: 384
status
enum<string>
Mevcut seçenekler:
draft,
active,
disabled,
archived

Yanıt

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

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