Sitemi API sanal POS'a nasıl entegre ederim?
Son güncelleme: 23 October 2026
Ödeme oluşturma, webhook ve dönüş adımları.
Entegrasyon üç adımdan oluşur. Kod örnekleri (cURL, PHP, Node.js) Geliştirici API dokümantasyonu'nda yer alır.
1. Ödeme oluşturun
Alıcı "Öde" dediğinde sunucunuz POST /api/v1/payments isteği gönderir: tutar, sizin sipariş numaranız (order_id), açıklama, başarılı ve başarısız ödeme dönüş adresleri. Yanıttaki payment_url adresine alıcıyı yönlendirin.
2. Ödeme sonucunu alın
Ödeme tamamlandığında Shopidi, webhook adresinize payment.succeeded bildirimi gönderir. Bildirimin imzasını webhook imza anahtarınızla doğrulayın ve siparişi burada onaylayın.
3. Alıcıyı karşılayın
Alıcı success_url (veya fail_url) adresinize payment_id, order_id ve status parametreleriyle döner. Bu sayfada teşekkür mesajı gösterin; ödeme durumundan emin olmak için GET /api/v1/payments/{id} ile sorgulayın.
Canlıya almadan önce: küçük bir tutarla gerçek bir ödeme yapıp panelden iade ederek akışı uçtan uca deneyin.
Hazır bir e-ticaret yazılımı kullanıyorsanız yazılımcınıza bu makaleyi ve dokümantasyon bağlantısını iletmeniz yeterlidir.