Postman ile Test
PF Gateway API'yi Postman kullanarak hızlıca test edin. Hazır collection ile dakikalar içinde ilk isteğinizi gönderin.
Postman, API'leri test etmek ve keşfetmek için en popüler araçlardan biridir. PF Gateway API için hazır bir Postman Collection hazırladık — indirip import edin, dakikalar içinde ilk API çağrınızı yapın.
Hazır Collection İndirin
Tüm PF Gateway API endpoint'lerini, otomatik imza oluşturma script'lerini ve örnek istekleri içeren hazır collection:
Kurulum
1. Postman'i İndirin
Henüz yüklemediyseniz postman.com adresinden uygun sürümü indirip kurun.
Postman'da hesap oluşturarak koleksiyonlarınızı ve ortam değişkenlerinizi bulut'ta saklayabilirsiniz.
2. Collection'ı Import Edin
- Postman'i açın
- Sol menüdeki Collections sekmesine tıklayın
- Import butonuna tıklayın
- İndirdiğiniz
PF-Gateway-API.postman_collection.jsondosyasını sürükleyip bırakın
Import tamamlandığında sol panelde "PF Merchant API's" koleksiyonu görünecektir.
3. İlk İsteğinizi Gönderin
Collection'da "Generate Test Signature" isteğini seçin. Bu istek otomatik olarak:
- Test imzası oluşturur
- Dönen
signature,nonce,publicKey,conversationIddeğerlerini collection variable olarak kaydeder - Sonraki isteklerde bu değerler otomatik kullanılır
Send butonuna tıklayın — yanıtı alt panelde göreceksiniz.
4. Diğer Endpoint'leri Test Edin
Signature oluşturulduktan sonra sırasıyla diğer endpoint'leri test edebilirsiniz:
- Tokens — Kart tokenize edin
- ThreeDS/getthreedsession — 3D Secure oturumu başlatın
- ThreeDS/init3ds — 3DS doğrulamayı başlatın
- Payments/provision — Ödeme alın
Her yeni işlem öncesi Generate Test Signature isteğini tekrar çalıştırın. Aynı imza birden fazla kullanılamaz.
Collection İçeriği
Collection'da bulunan endpoint'ler:
| Endpoint | Açıklama |
|---|---|
| Generate Test Signature | Test imzası oluşturur ve değişkenlere kaydeder |
| Tokens | Kart bilgilerini tokenize eder |
| Installment | Taksit seçeneklerini sorgular |
| ThreeDS/getthreedsession | 3D Secure oturumu oluşturur |
| ThreeDS/init3ds | 3D Secure doğrulamayı başlatır |
| ThreeDS/getthreedsessionresult | 3DS sonucunu sorgular |
| Payments/provision | Ödeme (provizyon) işlemi yapar |
| Payments/reverse | İptal işlemi yapar |
| Payments/return | İade işlemi yapar |
| Payments/inquire | İşlem sorgulama yapar |
Otomatik Değişkenler
Collection'daki "Generate Test Signature" isteği çalıştırıldığında, aşağıdaki değişkenler otomatik olarak doldurulur ve diğer isteklerde {{variable}} formatıyla kullanılır:
| Değişken | Açıklama |
|---|---|
{{signature}} | Oluşturulan HMAC imzası |
{{nonce}} | Benzersiz zaman damgası |
{{publicKey}} | Açık anahtar |
{{conversationId}} | İstek takip numarası |
Bu sayede her endpoint'e parametreleri elle girmenize gerek kalmaz.
Collection variable'larını görmek için koleksiyon adına sağ tıklayıp Edit → Variables sekmesine gidin.