Başlarken
Macellan SuperApp API entegrasyonu için kimlik doğrulama, dil seçimi ve genel kurallar.
Bu doküman, Macellan SuperApp API'sine entegre olmanızı kolaylaştırmak için hazırlanmıştır. Entegrasyon sırasında ihtiyacınız olacak terimsel ve teknik ifadelerin tanımları, parametrelerin alabilecekleri değerler ve akış şemaları bu dokümanda yer almaktadır.
Kimlik Doğrulama
API entegrasyonu için verilen tokenin sadece size ait olduğunu ve başkasıyla paylaşmamanız gerektiğini lütfen unutmayın.
Token ve dil seçimi için API isteklerinde aşağıdaki header'lar kullanılmalıdır:
** Tag-QR için Authorization header'ına ihtiyaç yoktur.
| Header Key | Header Value | Açıklama |
|---|---|---|
Authorization | Bearer {token} | API kimlik doğrulaması için kullanılır. |
X-Localization | tr, en, az, ru | API yanıtlarının dilini belirler. Gönderilmezse varsayılan olarak tr kullanılır. |
Hızlı Başlangıç
Token alın
Macellan ekibinden sandbox erişim token'ınızı isteyin. Bu token, tüm API isteklerinizde Authorization: Bearer {token} header'ında gönderilir.
İlk isteği atın
Ödeme modülünden bir test isteği göndererek entegrasyonun çalıştığını doğrulayın.
Webhook dinleyin
Ödeme/iade/cüzdan olaylarını yakalamak için Webhook modülünü yapılandırın.
Production'a geçin
Test senaryoları tamamlandıktan sonra Macellan ekibi ile production token için iletişime geçin.
Katkı ve önerileriniz için [email protected] adresinden bize ulaşabilirsiniz.