Postman
Lunixi Postman koleksiyonları API'yi kod yazmadan denemeniz içindir. Koleksiyon token'ı kendisi alır ve her isteği imzalar; isteği gönderip ham yanıtı Postman'de görürsünüz. Üretim entegrasyonu için SDK'ları kullanın.
Dosyaları indirme
Tüm koleksiyonlar, ortam şablonları ve yerel imzalayıcı tek pakettedir: ZIP olarak indirin (opens in a new tab) ya da GitHub deposunu (opens in a new tab) açın. Aşağıdaki dosya yolları bu paketin içindedir.
Dosyaları indirmeden, Postman'de Import → Link ile şu adreslerden de içe aktarabilirsiniz:
| Profil | Dosya | Adres |
|---|---|---|
| Ödeme, bağımsız | koleksiyon | https://raw.githubusercontent.com/Lunixi-Payment/postman/main/standalone/Lunixi-Payment-Gateway.standalone.postman_collection.json |
| Ödeme, bağımsız | ortam | https://raw.githubusercontent.com/Lunixi-Payment/postman/main/standalone/environments/lunixi.standalone.template.postman_environment.json |
| Ödeme, yerel imzalayıcı | koleksiyon | https://raw.githubusercontent.com/Lunixi-Payment/postman/main/local-signer/Lunixi-Payment-Gateway.local-signer.postman_collection.json |
| Ödeme, yerel imzalayıcı | ortam | https://raw.githubusercontent.com/Lunixi-Payment/postman/main/local-signer/environments/lunixi.local-signer.template.postman_environment.json |
| Fraud, bağımsız | koleksiyon | https://raw.githubusercontent.com/Lunixi-Payment/postman/main/fraud/standalone/Lunixi-Fraud.standalone.postman_collection.json |
| Fraud, bağımsız | ortam | https://raw.githubusercontent.com/Lunixi-Payment/postman/main/fraud/standalone/environments/lunixi-fraud.standalone.template.postman_environment.json |
| Fraud, yerel imzalayıcı | koleksiyon | https://raw.githubusercontent.com/Lunixi-Payment/postman/main/fraud/local-signer/Lunixi-Fraud.local-signer.postman_collection.json |
| Fraud, yerel imzalayıcı | ortam | https://raw.githubusercontent.com/Lunixi-Payment/postman/main/fraud/local-signer/environments/lunixi-fraud.local-signer.template.postman_environment.json |
İki profil
| Profil | Ne zaman | Özel anahtar nerede |
|---|---|---|
| Yerel imzalayıcı (önerilen) | Bilgisayarınızda küçük bir Node.js yardımcısı çalıştırabiliyorsanız | Yalnız yardımcı süreçte; koleksiyona girmez |
| Bağımsız | Terminal kullanamıyorsanız | Postman ortamında private_key_pem değişkeni |
Her iki profilde de token, süresi dolana kadar Postman ortamında tutulur.
Yerel imzalayıcı
Dosyalar:
local-signer/Lunixi-Payment-Gateway.local-signer.postman_collection.jsonlocal-signer/environments/lunixi.local-signer.template.postman_environment.jsontools/signer-server.js
Paketi açtığınız klasörde imzalayıcıyı özel anahtarınızın tam yoluyla başlatın; anahtar verilmezse imzalayıcı başlamaz:
LUNIXI_PRIVATE_KEY_PATH=/mutlak/yol/private.pem node tools/signer-server.jsİmzalayıcı http://127.0.0.1:8787 adresinde dinler (POSTMAN_SIGNER_PORT ile değiştirebilirsiniz). Ardından koleksiyonu ve ortamı Postman'e içe aktarın. İmzalayıcı her isteği imzaladığı için koleksiyonu kullandığınız sürece çalışır durumda kalmalıdır.
Bağımsız
Dosyalar:
standalone/Lunixi-Payment-Gateway.standalone.postman_collection.jsonstandalone/environments/lunixi.standalone.template.postman_environment.json
Özel anahtarı ortamdaki private_key_pem değişkenine girersiniz; koleksiyonun ön istek betiği token'ı alır ve her isteği Postman içinde imzalar. Ek paket gerektirmez.
Bağımsız profilde özel anahtar Postman ortamında durur. Ortamı paylaşmayın, dışa aktarmayın; mümkünse yerel imzalayıcı profilini kullanın.
Ortam değişkenleri
| Değişken | Açıklama |
|---|---|
base_url | https://api-gateway.lunixi.com |
key_id | API anahtarınızın kimliği (mk_live_sk_… ya da mk_test_sk_…) |
private_key_pem | Yalnız bağımsız profilde: özel anahtar |
signer_url | Yalnız yerel imzalayıcı profilinde: http://127.0.0.1:8787 |
callback_url | Ödeme sonrası alıcının döneceği adres |
currency | Varsayılan para birimi (TRY) |
Ortamı anahtar belirler: TEST anahtarıyla gönderilen istekler test ortamına gider. Diğer değişkenler (ödeme kimliği, token vb.) istekler çalıştıkça koleksiyon tarafından doldurulur.
İstek imzası
Koleksiyon her isteği Bearer token'a ek olarak X-Key-Id, X-Date, X-Nonce, X-Signature ve gövde varsa Digest başlıklarıyla imzalar. İmzadan önce {{değişkenler}} çözülür ve JSON gövde boşluksuz gönderilir; böylece imza, ağ geçidine giden içeriği birebir kapsar. Her gönderim yeni bir X-Nonce ve X-Date alır, aynı isteği yeniden göndermek sorun değildir.
Her istekte bir request is authenticated testi vardır. 401, token'ın ya da istek imzasının reddedildiği anlamına gelir; imzalı başlıkları Postman Console'da görebilirsiniz. → Kimlik Doğrulama
Ödeme koleksiyonunun içeriği
Auth · Payments / Checkout · Payments / Actions · Payment Methods · Split Payments · Promissory Notes · Reference · Payment Links · BIN / Installments · Stored Cards · Analytics · Webhooks · Wallet · Bank Accounts · Bank Transfers · Insurance · Sanction
Fraud koleksiyonu
Fraud yüzeyinin her profil için ayrı koleksiyonu vardır:
fraud/local-signer/Lunixi-Fraud.local-signer.postman_collection.jsonfraud/standalone/Lunixi-Fraud.standalone.postman_collection.json
Klasörler: Auth, Decision, Event Ingest, Decision Logs. Olay alımı uçları istek başına imza ister; yerel imzalayıcı profilinde önce Prepare Signed Event, ardından Record Transaction Event isteğini çalıştırın (toplu gönderim için de aynı çift). Fraud ortam şablonları varsayılan olarak TEST anahtarına göre hazırlanmıştır.
İlgili
- SDK'sız REST — imzalama akışı
- Kimlik Doğrulama — kanonik dize ve imza başlıkları
- Test Ortamı — TEST anahtarıyla çalışma