Macellan SuperApp
API Dokümantasyonu

Ödeme, cüzdan ve entegrasyon servislerine hızlıca başlayın. Tüm modüller, akış şemaları ve örneklerle birlikte tek bir yerde.

Postman Collection

Canlı Örnek

İlk İsteğinizi Dakikalar İçinde Atın

Harcama işlemini başlatan Collect endpoint'ine örnek bir istek. Token'ınızı alın, kendi referans kodunuzla deneyin.

bash

$

Endpoint detayları

Temel Modüller

Ana Servisler

Entegrasyonların çoğunun başladığı temel modüller.

Ödeme

QR, doğrudan ve OTP ile ödeme ve iade işlemleri.

Detayları incele

Cüzdan

Cüzdan detayı, bakiye ve puan geçmişi sorgulama.

Nakit Yükleme

QR ile cüzdana nakit bakiye yükleme akışları.

WaaS

Uçtan uca Wallet-as-a-Service entegrasyonu.

Webhook

Ödeme, iade ve yükleme olaylarını callback ile yakalayın.

Eklentiler

Diğer Modüller

İhtiyaca göre eklenebilecek yardımcı servisler.

Tag QR

Tag QR callback ve fiyat servisi entegrasyonu.

QR

Ödeme QR durum sorgulama.

Tap Card

NFC kart ile bakiye sorgulama ve ödeme.

Box Office

Gişe bakiye sorgulama ve yükleme işlemleri.

Kullanıcı

Bireysel ve yetkili kullanıcı yönetimi.

Şirket

Şirket bilgilerini görüntüleme.

Şube

Şube oluşturma ve güncelleme.

OTP

OTP gönderme ve doğrulama.

Event Log

Özel olay kaydı oluşturma.

Kılavuz

Önemli Kavramlar

Entegrasyona başlamadan önce bilmeniz gereken temel konular.

Kimlik Doğrulama

Her istek Authorization: Bearer <token> header'ı ile gönderilir.

Ödeme Akışı

Collect → Status → Complete üçlüsüyle harcama tamamlanır.

Webhook Olayları

Ödeme, iade ve cüzdan olayları tanımladığınız callback URL’ye anlık iletilir.

Ortamlar

Sandbox api.altpay.dev üzerindedir; production erişimi için Macellan ekibiyle iletişime geçin.

Kurulum

Hızlı Başlangıç

İki adımda entegrasyonu ayağa kaldırın. Tüm detaylar için başlarken sayfasına göz atın.

01
Token alın
Macellan ekibinden sandbox erişim token’ınızı isteyin ve tüm isteklerinizde `Authorization: Bearer {token}` header’ı ile gönderin.
02
İlk isteği atın
Ödeme modülünden örnek bir istek göndererek entegrasyonunuzun çalıştığını doğrulayın.

Yardıma mı ihtiyacınız var?

Entegrasyon sırasında takıldığınız noktalarda ekibimiz yanınızda.

[email protected]