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:
  1. Güvenlik sayfasından iki adımlı doğrulamayı kurun; sahibi kaybetmek pahalıdır.
  2. POS Bağlantıları’ndan ilk hesabı ekleyin — gerçek banka kimlikleriniz hazır değilse MockBank ile başlayın.
  3. 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.