Ana içeriğe atla
POST

Ne yapar?

Aktif ve bağlantısı doğrulanmış Hoppa hesabı, güncel accountRevision ve aynı firmaya ait cariyle 30 dakikalık ödeme talebi oluşturur. Karttan çekim başlatmaz. Tutar eksik/null ise müşteri girer; iletişim/adresin yalnız eksikleri ödeme sayfasında alınır. Çoklu aktif taksit seçilebilir; genel ve aile satışları eksikse hesaptan sabitlenir. 0 komisyonsuzdur. Talepte değişen oran hesabı değiştirmez. operation.state=succeeded talebin kaydedildiğini gösterir; ödendi anlamına gelmez.

Ö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. operation.state=succeeded, ödeme veya iadenin mali olarak tamamlandığı anlamına gelmez. Ödeme kaydının status, verification ve iade geçmişini okuyun. Tamamlanmış tekrar cevabı ilk gövde yerine güvenli kimlikler döndürebilir.

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
accountId
string
gerekli

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

Pattern: ^[a-fA-F0-9]{24}$
accountRevision
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
contactsId
string
gerekli

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

Pattern: ^[a-fA-F0-9]{24}$
installmentOptions
object[]
gerekli
Required array length: 1 - 12 elements
amountMinor
integer | null

Kuruş; eksik/null ise müşteri ödeme sayfasında girer. Sabit verilirse müşteri değiştiremez.

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

Yanıt

Tamamlanmış tekrar. Ayrıntı yerine güvenli kimlikler ve makbuz döner.

status
boolean
gerekli
replayed
enum<boolean>
gerekli
Mevcut seçenekler:
true
operation
object
gerekli
operations
object[]
gerekli
resultId
string
transactionId
string
uuid
string
id
string
providerId
string
documentId
string
paymentId
string
orderId
string
uuids
string[]
sourcePaymentId
string

24 karakterli kayıt kimliği.

Pattern: ^[a-f0-9A-F]{24}$
destinationPaymentId
string

24 karakterli kayıt kimliği.

Pattern: ^[a-f0-9A-F]{24}$