Kurulum ayakta; şimdi ilk işyerini açalım ve paranın uçtan uca aktığını
kanıtlayalım.
1. Açılışı doğrulayın
{"status":"ready"} görmelisiniz. Uygulama açılırken sırları ve veritabanı
rolünü zaten doğruladı; docker compose logs api içinde uyarı olmamalı.
2. İlk kiracıyı açın
Kiracı oluşturma bir platform işlemidir ve X-Platform-Key ister
(.env’deki POYRA_PLATFORM_ADMIN_KEY):
Tek istekte atomik olarak şunlar oluşur: organizasyon, kiracı, varsayılan iş
profili, sahip rolünde kullanıcı ve ilk API anahtarı.
Yanıttaki apiKey değeri (sk_test_…) bir daha gösterilmez. Terminali
kapatmadan güvenli bir yere alın. İlk anahtar test öneklidir; canlı anahtarı
panelden Sahip rolüyle üretirsiniz.
3. Panele girin
https://panel.ornek.com/giris — e-posta ve parolayla girin. İlk işleriniz:
- Güvenlik sayfasından iki adımlı doğrulamayı kurun;
sahibi kaybetmek pahalıdır.
- POS Bağlantıları’ndan ilk hesabı ekleyin — gerçek banka kimlikleriniz
hazır değilse MockBank ile başlayın.
- Ayarlar’dan checkout markanızı (ad, renk, logo, destek bilgisi) girin.
4. Uçtan uca duman testi
Dönen url’i tarayıcıda açın — checkout sayfanız marka
ayarlarınızla gelmeli. MockBank hesabıyla ödemeyi tamamlayın; ardından:
- Panelde Ödemeler’de kaydı ve zaman çizelgesini görün,
GET /v1/payments/{id}/timeline ile aynı zinciri API’den okuyun,
- Webhook kaydettiyseniz
payment.succeeded teslimatını
Webhook’lar sayfasından doğrulayın.
Bu üçü çalışıyorsa boru hattının tamamı — checkout, rota, banka dönüşü, defter,
webhook — ayaktadır.
5. Canlıya geçmeden
İşletim sayfasındaki listeyle ilerleyin: TLS, yedekler,
banka sertifikasyonları ve PCI sınırı. Gerçek banka hesaplarını eklerken taksit
çalışacaksa komisyon anlaşmalarını ve
taksit şemalarını tanımlamayı unutmayın — anlaşma yoksa
defter beklenti üretmez, şema yoksa taksit teklif edilmez.