Ana içeriğe atla
POST

Ne yapar?

Taslak hesap oluşturur; ortam firma hesabından belirlenir. Idempotency-Key gerekir. Aynı anahtar ve farklı normalize hesap bilgisi 409 BANKPOS_IDEMPOTENCY_CONFLICT üretir; silinen hesabın anahtarı yeniden kullanılamaz. Hesap oluşturmak karttan çekim yapmaz.

Ö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. Hesap oluşturma tekrarı replayed:true ile aynı hesabı döndürür; bu çağrı genel operation makbuzu üretmez.

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.

Başlıklar

Idempotency-Key
string
gerekli

İş niyetine ait kalıcı anahtar. Farklı işlerde yeniden kullanmayın. Aynı anahtar ve farklı içerik 409 döndürür.

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

Gövde

application/json
name
string
gerekli
Required string length: 1 - 120
providerCode
string
gerekli

Sağlayıcı kataloğundan alınır; Hoppa için esnekpos.

installmentRates
object[]
gerekli

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

Required array length: 1 - 99 elements
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
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

Yanıt

Aynı hesap oluşturma anahtarının tekrarı; yeni hesap açılmaz.

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