Signature Oluşturma Adımları

Bu sayfada, API güvenliği için gerekli olan imza (signature) değerinin nasıl oluşturulacağı adım adım açıklanmaktadır.

RoofVPos API – x_signature Oluşturma Rehberi

Bu doküman, RoofVPos API entegrasyonu sırasında kullanılan x_signature değerinin güvenli, doğru ve tekrarlanabilir şekilde oluşturulması için gerekli teknik adımları açıklamaktadır.

Amaç:

x_signature, gönderilen isteğin bütünlüğünü ve güvenilirliğini garanti altına almak için kullanılmaktadır. Her istekte belirlenen parametrelerin belirli bir algoritma ile işlenmesi sonucu üretilen bu değer, API tarafında doğrulanarak işlemin geçerliliği sağlanır.

---

Dokümanın İçeriği

1. Parametre Tanımları

   • clientToken, secretKey , Timestamp gibi imza hesaplamasında kullanılacak alanların detaylı açıklamaları.

2. Üretim Yöntemi

   • Hangi parametrelerin hangi sırayla birleştirileceği,

   • Kullanılacak hash algoritması (örn. SHA256),

   • Hex/Base64 encoding adımları.

3. Örnek Veriler

   • İmza üretiminde kullanılacak örnek değerler,

   • Bu veriler yalnızca gösterim amaçlıdır ve gerçek işlemlerde kullanılmamalıdır.

4. Kod Örnekleri (Java / C#)

   • Hem Java hem de C# için imza üretiminde izlenmesi gereken adımlar örnek kodlarla desteklenmiştir.

   • Kodlar, parametrelerin sıralanması, birleştirilmesi ve hash işleminin uygulanmasını göstermektedir.

---

⚠️ Önemli Notlar

• Entegratörler, kendi entegrasyon süreçlerinde:

  • Örnek adımları birebir uygulayarak,

  • Aynı x_signature çıktısını üretip üretemediklerini test etmelidir.

• Bu sayede gerçek sistemde herhangi bir uyumsuzluk veya doğrulama hatası yaşanmasının önüne geçilmiş olur.