← Back to poyrazpay.com← poyrazpay.com'a dön

Developer documentationGeliştirici dokümantasyonu

API v1 · REST · JSON · no breaking changes since launchlansmandan beri kırıcı değişiklik yok

Everything is idempotent, every response is JSON, and every error tells you what to do next rather than what you did wrong. The sandbox mirrors production, including the failure modes.Her şey idempotent, her yanıt JSON ve her hata size ne yaptığınızı değil, sırada ne yapmanız gerektiğini söyler. Sandbox, hata senaryoları dahil üretim ortamını birebir yansıtır.

Sandbox keysSandbox anahtarları pk_sandbox_b6ff2e_0057 · sk_sandbox_p0yraz_8842
These work only against the sandbox, which is to say they work against nothing, because this is a parody site. Copy them anyway; they look convincing in a screenshot.Bunlar yalnızca sandbox'ta çalışır; yani hiçbir yerde çalışmaz, çünkü burası bir parodi sitesi. Yine de kopyalayın, ekran görüntüsünde ikna edici duruyorlar.

AuthenticationKimlik doğrulama

Bearer token in the Authorization header. Secret keys start with sk_, publishable keys with pk_. Send an Idempotency-Key on every write; we store the result for 24 hours and replay it rather than charging anyone twice.Authorization başlığında Bearer token. Gizli anahtarlar sk_, yayımlanabilir anahtarlar pk_ ile başlar. Her yazma isteğinde Idempotency-Key gönderin; sonucu 24 saat saklar ve kimseyi iki kez borçlandırmak yerine tekrar oynatırız.

curl https://api.poyrazpay.com/v1/accounts \
  -H "Authorization: Bearer sk_live_…" \
  -H "Idempotency-Key: $(uuidgen)"

EndpointsUç noktalar

EndpointUç nokta	DescriptionAçıklama
GET /v1/accounts	List accounts and balances across all held currencies.Tutulan tüm dövizlerdeki hesapları ve bakiyeleri listeler.
POST /v1/payouts	Create a payout on SEPA, SEPA Instant, FPS or SWIFT.SEPA, SEPA Instant, FPS veya SWIFT üzerinden ödeme oluşturur.
GET /v1/payouts/:id	Retrieve a payout, including settlement timing in milliseconds.Bir ödemeyi, milisaniye cinsinden mutabakat süresi dahil getirir.
POST /v1/fx/quotes	Lock an FX rate for 30 seconds.Bir döviz kurunu 30 saniyeliğine kilitler.
POST /v1/cards	Issue a virtual or physical card.Sanal veya fiziksel kart ihraç eder.
GET /v1/counterparties/:id/score	Return the counterparty's Poyraz Score™ and promise history.Karşı tarafın Poyraz Skoru™ ve söz verme geçmişini döndürür.

WebhooksWebhook'lar

EventOlay	Fires whenNe zaman tetiklenir
payout.settled	Funds have left us and arrived. Median 412ms.Fonlar bizden çıktı ve ulaştı. Medyan 412 ms.
payout.failed	The payment did not go through. The reason is in the payload, not in a phone call.Ödeme geçmedi. Nedeni bir telefon görüşmesinde değil, yanıtın içinde.
card.authorised	A card transaction was approved or declined.Bir kart işlemi onaylandı veya reddedildi.
kyc.review.completed	Identity verification finished. A human looked at it.Kimlik doğrulama tamamlandı. Bir insan baktı.
counterparty.promised	A counterparty said they would send it tomorrow. Retained for evidentiary purposes.Bir karşı taraf yarın göndereceğini söyledi. Delil amacıyla saklanır.

ErrorsHatalar

CodeKod	MeaningAnlamı
400 invalid_iban	The IBAN failed checksum validation. Check the last two digits.IBAN sağlama toplamını geçemedi. Son iki haneyi kontrol edin.
402 insufficient_funds	Not enough balance in that currency. Convert first.O dövizde yeterli bakiye yok. Önce çevirin.
409 idempotency_conflict	Same Idempotency-Key, different body. We refused to guess.Aynı Idempotency-Key, farklı gövde. Tahmin etmeyi reddettik.
422 sanctions_hit	Screening hit. The payment is held and a human is already looking.Tarama eşleşmesi. Ödeme beklemede ve bir insan zaten bakıyor.
429 rate_limited	Slow down. 1,000 requests per minute, per key.Yavaşlayın. Anahtar başına dakikada 1.000 istek.
451 poyraz_score_too_low	Legally available in all jurisdictions, morally available in none.Tüm ülkelerde hukuken mevcut, hiçbirinde ahlaken mevcut değil.

SDKsSDK'lar

npm i poyrazpay — Node 18+
pip install poyrazpay — Python 3.9+
go get poyrazpay/go — Go 1.21+
Or just use curl. It has never had a breaking change either.Ya da doğrudan curl kullanın. Onun da hiç kırıcı değişikliği olmadı.

SupportDestek

Engineering support answers in under an hour during European working hours, and eventually outside them.Mühendislik desteği Avrupa mesai saatlerinde bir saatin altında, dışında ise eninde sonunda yanıt verir. Contact usBize ulaşın