Hızlı başlangıç

Bu sayfa sizi API anahtarından ilk payment.succeeded olayına götürür. Gerekenler: çalışan bir Poyra kurulumu ve işyerinizin API anahtarı (İlk açılış).

Yalnız denemek istiyorsanız kurulumun en kısa yolu geliştirme ortamıdır: dotnet run --project src/Poyra.AppHost tek komutla veritabanını ve üç host’u ayağa kaldırır. Üretim kurulumu için Docker ile kurulum.

export API=https://api.ornek.com
export KEY=sk_test_...

Test POS hesabı ekleyin

Gerçek banka kimliği gerekmez; MockBank tam davranışlı bir test bankasıdır:

curl -X POST $API/v1/connector-accounts \
  -H "X-Api-Key: $KEY" -H "Content-Type: application/json" \
  -d '{ "connectorKey": "mockbank", "label": "Mock Banka",
        "testMode": true, "credentials": { "secret": "test-sirri" } }'

Ödemeyi oluşturun ve confirm edin

curl -X POST $API/v1/payments \
  -H "X-Api-Key: $KEY" \
  -H "Idempotency-Key: ilk-odeme-1" \
  -H "Content-Type: application/json" \
  -d '{ "amountMinor": 14990, "currency": "TRY",
        "description": "İlk test ödemesi", "confirm": true,
        "returnUrl": "https://ornek.com/donus" }'

Yanıt status: "requires_action" ve bir nextAction içerir: bankaya gönderilecek adres ve imzalı form alanları. Gerçek entegrasyonda bu formu müşterinin tarayıcısında otomatik gönderirsiniz; MockBank’ta adres doğrudan Poyra’nın geri dönüş ucudur.

Banka dönüşünü simüle edin

nextAction.url değerine nextAction.fields alanlarını form olarak POST edin:

curl -X POST "<nextAction.url>" \
  -d "order=<fields.order>&amount=<fields.amount>&outcome=approved&sig=<fields.sig>"

Bu, bankanın 3DS dönüşüdür: imza doğrulanır, ödeme succeeded olur ve webhook kuyruğa girer.

Sonucu okuyun

curl $API/v1/payments/<pay_id>/timeline -H "X-Api-Key: $KEY"

Zincirin tamamını görürsünüz: payment.created → risk kararı → payment.confirm.started → attempt.initiated → payment.succeeded — ve “neden bu POS” sorusunun cevabı olan yönlendirme kaydı.

Kod yazmadan aynı akış

Aynı yolculuğun kodsuz hâli ödeme bağlantısıdır:

curl -X POST $API/v1/payment-links \
  -H "X-Api-Key: $KEY" -H "Content-Type: application/json" \
  -d '{ "description": "Test tahsilatı", "amountMinor": 14990, "maxInstallments": 6 }'

Dönen adresi tarayıcıda açın — markanızla gelen checkout sayfası taksit seçeneklerini gösterir ve müşteriyi bankaya taşır.

Sonraki adımlar

Red senaryolarını deneyin

10099 gönderin: kart reddi. 10098: 3DS başarısız. Devretme için ikinci hesap.

Webhook kaydedin

Sonucu yoklamak yerine imzalı olayla öğrenin.

Taksit şeması tanımlayın

BIN kataloğu + şema olmadan taksit teklif edilmez.

Rota kuralı yazın

İkinci POS’u ekleyince trafiği kurala bağlayın.

Başlangıç

Ödeme akışları

Ödeme muhasebesi

Operasyon

Panel

Entegrasyon

Kendi sunucunda

Hızlı başlangıç

Kod yazmadan aynı akış

Sonraki adımlar

Red senaryolarını deneyin

Webhook kaydedin

Taksit şeması tanımlayın

Rota kuralı yazın

​Kod yazmadan aynı akış

​Sonraki adımlar

Red senaryolarını deneyin

Webhook kaydedin

Taksit şeması tanımlayın

Rota kuralı yazın

Kod yazmadan aynı akış

Sonraki adımlar