Test modu ve MockBank

Poyra’da test/canlı ayrımı API anahtarında değil POS hesabındadır: test modundaki hesap MockBank adaptörüne bağlanır ve hiçbir gerçek bankaya istek atmaz. sk_test_ öneki yalnızca bir etikettir.

MockBank’ı kurmak

MockBank katalogdaki diğer adaptörler gibi eklenir:

curl -X POST https://api.ornek.com/v1/connector-accounts \
  -H "X-Api-Key: sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "connectorKey": "mockbank",
    "label": "Mock Banka",
    "testMode": true,
    "credentials": { "secret": "test-imza-sirri" }
  }'

“Banka sayfası” yoktur: hosted akışta MockBank, form adresi olarak doğrudan Poyra’nın geri dönüş ucunu verir — formu POST’lamak, bankanın 3DS dönüşünü simüle eder. Dönüş imzası gerçek adaptörler gibi HMAC ile doğrulanır.

Senaryolar tutarla seçilir

Test kartı listesi yerine tutarın son iki hanesi senaryoyu belirler — 10099 gönderin, reddedilin:

Kuruş hanesi	Hosted akış	Direct akış
`…99`	Kart reddi (`poyra.card_declined`, ham kod `05`)	Kart reddi — yük devretme durur
`…98`	3DS başarısız (`poyra.three_ds_failed`)	—
`…97`	—	Banka erişilemez (`poyra.issuer_unavailable`) — devretme sürer
diğer	Onay: `MOCK01`, maskeli kart `540667******1234`	Onay

Direct akışta Luhn’u geçmeyen kart numarası poyra.invalid_card döner. İptal ve iade her zaman başarılıdır. İki kimlik alanı da senaryo anahtarıdır:

fail_initiate: true — hesap, form üretirken “erişilemez” hatası fırlatır: yük devretme testinin düğmesi. Sağlık yoklaması da down döner, canary’yi sınar.
no_3ds_direct: true — 3DS’li direct akışta “adaptör desteklemiyor” cevabı verir; aday atlama davranışını sınar.

Uçtan uca test örneği

# 1) Reddedilecek ödeme: 100,99 ₺
curl -X POST https://api.ornek.com/v1/payments \
  -H "X-Api-Key: sk_test_..." -H "Content-Type: application/json" \
  -d '{ "amountMinor": 10099, "confirm": true, "returnUrl": "https://ornek.com/donus" }'

# 2) Yanıttaki next_action.url'e next_action.fields ile POST edin (bankanın dönüşü)
# 3) Ödemeyi okuyun: status=failed, lastError.code=poyra.card_declined
curl https://api.ornek.com/v1/payments/pay_… -H "X-Api-Key: sk_test_..."

İki MockBank hesabı (biri fail_initiate ile) + bir rota kuralıyla devretme zincirini, …97 tutarlarla direct devretmeyi, …98 ile 3DS başarısızlığını sınayabilirsiniz. Webhook’larınızı da bu akış tetikler — imza doğrulamanızı üretime çıkmadan MockBank teslimatlarıyla test edin.

MockBank kasıtlı olarak üretim kataloğunda da kayıtlıdır: canlı sistemde de test modunda bir hesap açıp uçtan uca duman testi koşabilirsiniz. Canlıya çıkarken MockBank hesabınızı devre dışı bırakmayı unutmayın — rota kurallarınız onu aday listesine almasın.

Başlangıç

Ödeme akışları

Ödeme muhasebesi

Operasyon

Panel

Entegrasyon

Kendi sunucunda

Test modu ve MockBank

MockBank’ı kurmak

Senaryolar tutarla seçilir

Uçtan uca test örneği

​MockBank’ı kurmak

​Senaryolar tutarla seçilir

​Uçtan uca test örneği

MockBank’ı kurmak

Senaryolar tutarla seçilir

Uçtan uca test örneği