# Macellan SuperApp

> Macellan SuperApp dijital cüzdan altyapısı sunan bir platformdur. Entegratör firmalar bu API'yi kullanarak ödeme, nakit yükleme, kullanıcı yönetimi ve diğer cüzdan işlemlerini gerçekleştirebilir.

## Docs

- [Başlarken](https://docs.altpay.dev/): API entegrasyon rehberi, kimlik doğrulama ve hızlı başlangıç
- [Tüm Dokümantasyon](https://docs.altpay.dev/llms-full.txt): Tüm API dokümantasyonu tek dosyada
- [Tag-QR](https://docs.altpay.dev/tag-qr): Macellan SuperApp Tag-QR Entegrasyon Dokümanı
- [Ödeme](https://docs.altpay.dev/payment): Macellan SuperApp Ödeme Entegrasyon Dokümanı
- [Nakit Yükleme](https://docs.altpay.dev/cash-deposit): Macellan SuperApp Nakit Yükleme Entegrasyon Dokümanı
- [Wallet As A Service](https://docs.altpay.dev/waas): WaaS Entegrasyon Dokümanı
- [Webhook](https://docs.altpay.dev/webhooks): Macellan SuperApp Webhook Dokümanı

## Tag QR

- [Dönüş İşlemleri](https://docs.altpay.dev/tag-qr/ping-callback): Tag-QR Ping Callback entegrasyonu
- [Fiyat Servisi](https://docs.altpay.dev/tag-qr/price-service): Dinamik Tutarlı Tag-QR fiyat servisi entegrasyonu

## Ödeme

- [Ödeme İade Servisi](https://docs.altpay.dev/payment/refund): Macellan SuperApp Ödeme İade Entegrasyon Dokümanı
- [Read QR - Status](https://docs.altpay.dev/payment/(read-qr)/payment-status): Status servisi, harcama işleminin durumunu sorgulamak için kullanılır.
- [Read QR - Send Again Approval (Optional)](https://docs.altpay.dev/payment/(read-qr)/payment-send-again-approval): Send Again Approval servisi, eğer kullanıcı özet ve onay ekranına yönlendirilmezse, bu ekrana tekrar yönlendirmek için kullanılır.
- [Read QR - Cancel](https://docs.altpay.dev/payment/(read-qr)/payment-cancel): Cancel servisi, harcama işleminin iptal edilmesini sağlar.
- [Read QR - Complete](https://docs.altpay.dev/payment/(read-qr)/payment-complete): Complete servisi, harcama işleminin son adımıdır ve işlemi tamamlamak için kullanılır.
- [Read QR - Collect](https://docs.altpay.dev/payment/(read-qr)/payment-collect): Collect servisi, harcama işlemi tutarının belirlenmesi için kullanılır.
- [İade - Refund Close](https://docs.altpay.dev/payment/(iade)/payment-refund-close): Refund Close servisi iade isteğini iptal etmek için kullanılır.
- [İade - Details](https://docs.altpay.dev/payment/(iade)/payment-refund-request-details): Refund Request Details servisi, iade işleminin detaylarını görüntülemek için kullanılır.
- [İade - Refund Make](https://docs.altpay.dev/payment/(iade)/payment-refund-make): Refund Make servisi harcama işleminin iadesini gerçekleştirmek için kullanılır.
- [İade - Direct Refund](https://docs.altpay.dev/payment/(iade)/payment-direct-refund): Direct Refund servisi, entegratör firmanın kullanıcı tarafından oluşturulan iade isteği
olmaksızın harcama işlemini iade etmek için kullanılır.
- [İade - Payment Refund Request List](https://docs.altpay.dev/payment/(iade)/payment-refund-request-list): Payment Refund Request List servisi entegratör firmanın bağlı olduğu şirkete ve kullanıcıya ait bütün iade isteklerinin listelediği servistir.
- [OTP İle Ödeme - Doğrulama](https://docs.altpay.dev/payment/(otp-ile-odeme)/payment-with-otp-complete): OTP ödeme tamamlama servisi ile müşteriden alınan OTP kodu ve harcama id ile ödeme işlemini tamamlamak için kullanılır.
- [OTP İle Ödeme - Gönderim](https://docs.altpay.dev/payment/(otp-ile-odeme)/payment-with-otp-send): OTP ile ödeme başlatma servisi, müşterinin telefon ve ödeme detayları ile ödeme işlemi başlatılması için kullanılır.
- [Payment - Payment List](https://docs.altpay.dev/payment/(payment)/payment-list): Payment List servisi entegratör firmanın bağlı olduğu şirkete ve kullanıcıya ait bütün harcama işlemlerinin listelediği servistir.
- [Payment - Ödeme Detay Güncelleme](https://docs.altpay.dev/payment/(payment)/payment-update-detail): Ödeme işlemi tamamlandıktan sonra ödeme detaylarını güncellemek için kullanılır.
- [Payment - Direct Charge](https://docs.altpay.dev/payment/(payment)/payment-direct-charge): Direct Charge servisi Macellan SuperApp kullanıcısı onayı, QR veya referans kodu olmadan harcama işlemi
yapmak için kullanılır.
- [Generate QR - Payment Create](https://docs.altpay.dev/payment/(generate-qr)/payment-create): Create Servisi, harcama işlemlerini oluşturmak amacıyla kullanılır.

## Nakit Yükleme

- [Read QR - Read QR](https://docs.altpay.dev/cash-deposit/(read-qr)/cash-deposit-read-qr): Read QR servisi, yükleme işlemi tutarının belirlenmesi için kullanılır.
- [Read QR - Send Again Approval(Opsiyonel)](https://docs.altpay.dev/cash-deposit/(read-qr)/cash-deposit-send-again-approval): Send Again Approval servisi, eğer kullanıcı özet ve onay ekranına yönlendirilmezse, bu ekrana tekrar yönlendirmek için kullanılır.
- [Read QR - Status](https://docs.altpay.dev/cash-deposit/(read-qr)/cash-deposit-status): Status servisi, yükleme işleminin durumunu sorgulamak için kullanılır.
- [Direct](https://docs.altpay.dev/cash-deposit/cash-deposit-direct): Direct servisi, entegratör firmanın, kullanıcıdan herhangi bir onay almadan kullanıcının cüzdanına nakit yükleme yapmasını sağlar.
- [Generate QR - Generate Qr](https://docs.altpay.dev/cash-deposit/(generate-qr)/cash-deposit-generate-qr): Generate Qr Servisi, yükleme işlemlerini oluşturmak amacıyla kullanılır.

## QR

- [Status](https://docs.altpay.dev/qr/qr-status): GET /integration/qr/status

## Cüzdan

- [Liste](https://docs.altpay.dev/wallet/wallet-list): GET /integration/wallet/list
- [Puan Geçmişi Listesi](https://docs.altpay.dev/wallet/point-history-list): GET /integration/wallet/point-history/list
- [Detay](https://docs.altpay.dev/wallet/wallet-details): GET /integration/wallet/{walletId}/details
- [Bakiye Geçmişi Listesi](https://docs.altpay.dev/wallet/balance-history-list): GET /integration/wallet/balance-history/list
- [Telefon Numarasına Göre](https://docs.altpay.dev/wallet/get-by-phone): İlgili telefon numarasına ait cüzdan bilgisi verilir.

## Kullanıcı

- [Yetkili Kullanıcı - Güncelle](https://docs.altpay.dev/user/(yetkili-kullanici)/user-update): Önceden oluşturulan kullanıcıları güncellemek için kullanılır.
- [Yetkili Kullanıcı - Yetkili Kullanıcı Oluştur](https://docs.altpay.dev/user/(yetkili-kullanici)/user-create): Kasiyer ve Şube yetkilisi rolünde kullanıcı oluşturmak için kullanılır.
- [Yetkili Kullanıcı - Detay](https://docs.altpay.dev/user/(yetkili-kullanici)/user-me): Token'ın bağlı olduğu kullanıcıya ait detaylar görüntülenir.
- [Oluştur](https://docs.altpay.dev/user/personal-user-register): Bu servis, OTP işleminden sonra kullanıcıyı oluşturup cüzdan hesabının açılması için kullanılır.

## Şirket

- [Şirket Detayları](https://docs.altpay.dev/company/company-details): GET /integration/company/details

## Şube

- [Güncelle](https://docs.altpay.dev/branch/branch-update): Önceden oluşturulan şubeleri güncellemek için kullanılır.
- [Oluştur](https://docs.altpay.dev/branch/branch-create): Şube oluşturmak için kullanılır.

## Temassız Kart

- [Kart ile Ödeme](https://docs.altpay.dev/tap-card/pay): POST /integration/tap-card/pay
- [Bakiye Sorgulama](https://docs.altpay.dev/tap-card/balance-inquiry): POST /integration/tap-card/balance-inquiry

## Box Office

- [Bakiye Yükleme](https://docs.altpay.dev/box-office/top-up): POST /integration/box-office/top-up
- [Kart Kaydı ve Bakiye Yükleme](https://docs.altpay.dev/box-office/verified-top-up): POST /integration/box-office/verified-top-up
- [Bakiye Sorgulama](https://docs.altpay.dev/box-office/balance-inquiry): POST /integration/box-office/balance-inquiry

## OTP

- [Doğrulama](https://docs.altpay.dev/otp/otp-verify): Gönderim yapılan OTP yi doğrulama işlemi için kullanılmaktadır.
- [Gönderim](https://docs.altpay.dev/otp/otp-send): Belirtilen telefon numarasına, OTP gönderimini sağlar.

## Waas

- [Temassız Kart - Temassız Kart](https://docs.altpay.dev/waas/(tap-card)/tap-card): WaaS temassız kart tanımlama, listeleme ve iptal servisleri
- [Müşteri Grupları - Müşteri Grupları](https://docs.altpay.dev/waas/(musteri-gruplari)/user-groups): WaaS müşteri grubu listeleme ve üye yönetimi servisleri
- [iFramesiz Kullanım](https://docs.altpay.dev/waas/open-without-iframe): Mobil uygulamanızda belirttiğiniz kullanıcı bilgileri ile cüzdan uygulamasını açmak için kullanılır.
- [Kullanıcı Kayıt - Kullanıcı Kayıt İşlemleri](https://docs.altpay.dev/waas/(kullanici)/(kayit)/register-intro): WaaS kullanıcı kayıt işlemleri entegrasyonu
- [Kullanıcı - Kullanıcı](https://docs.altpay.dev/waas/(kullanici)/user): WaaS kullanıcı yönetimi servisleri
- [Direct Payment - Direct Payment](https://docs.altpay.dev/waas/(direct-payment)/direct-payment): WaaS Direct Payment entegrasyonu
- [Temassız Kart - Kart Listesi](https://docs.altpay.dev/waas/(tap-card)/waas-tap-card-list): Bu servis ile bir cüzdan kullanıcısına tanımlı aktif kartları listeleyebilirsiniz.
- [Temassız Kart - Kart İptali](https://docs.altpay.dev/waas/(tap-card)/waas-tap-card-bulk-reset): Bu servis ile cüzdan kullanıcılarınıza tanımlı temassız kartları iptal edebilirsiniz.
- [Temassız Kart - Kart Tanımlama](https://docs.altpay.dev/waas/(tap-card)/waas-tap-card-bulk-create): Bu servis ile cüzdan kullanıcılarınıza temassız kart tanımlayabilirsiniz.
- [Müşteri Grupları - Gruptan Üye Çıkarma](https://docs.altpay.dev/waas/(musteri-gruplari)/waas-user-group-remove-members): Bu servis ile bir müşteri grubundan temassız kart veya telefon numarası çıkarabilirsiniz.
- [Müşteri Grupları - Müşteri Grubu Listesi](https://docs.altpay.dev/waas/(musteri-gruplari)/waas-user-group-list): Bu servis ile şirketinize ait müşteri gruplarını listeleyebilirsiniz.
- [Müşteri Grupları - Gruba Üye Ekleme](https://docs.altpay.dev/waas/(musteri-gruplari)/waas-user-group-add-members): Bu servis ile bir müşteri grubuna temassız kart veya telefon numarası ekleyebilirsiniz.
- [Cüzdan - Puan Geçmişi](https://docs.altpay.dev/waas/(cuzdan)/waas-wallet-point-histories): Bu servis ile cüzdan kullanıcınıza ait puan geçmişini listeleyebilirsiniz.
- [Cüzdan - Sözleşme](https://docs.altpay.dev/waas/(cuzdan)/waas-agreement): Bu servis ile Macellan SuperApp panelinden hazırlanan cüzdan sözleşme bilgilerini alabilirsiniz.
- [Cüzdan - Puan Özeti](https://docs.altpay.dev/waas/(cuzdan)/waas-point-summary): Bu servis ile cüzdan kullanıcılarınızın toplam puan değerlerini görüntüleyebilirsiniz.
- [Cüzdan - Zamanlanmış Puanlar](https://docs.altpay.dev/waas/(cuzdan)/waas-wallet-scheduled-points): Bu servis ile cüzdan kullanıcılarınıza ait zamanlanmış puan tanımlamalarını listeleyebilirsiniz.
- [Cüzdan - Detay](https://docs.altpay.dev/waas/(cuzdan)/waas-wallet-detail): Bu servis ile cüzdan uygulaması eşlemesi yapılan kullanıcılarınızın cüzdan bilgilerini görüntüleyebilirsiniz.
- [Cüzdan - Detay (Toplu)](https://docs.altpay.dev/waas/(cuzdan)/waas-wallet-bulk-details): Bu servis ile birden fazla kullanıcınızın cüzdan bilgilerini tek istekte toplu olarak görüntüleyebilirsiniz.
- [Cüzdan - İşlem Geçmişi](https://docs.altpay.dev/waas/(cuzdan)/waas-balance-history): Bu servis ile cüzdan kullanıcılarınızın işlem geçmişini görüntüleyebilirsiniz.
- [Zamanlanmış Puan - Güncelleme](https://docs.altpay.dev/waas/(zamanlanmis-puan)/waas-scheduled-point-update): Bu servis ile daha önce oluşturulmuş zamanlanmış puan tanımlamasını güncelleyebilirsiniz.
- [Zamanlanmış Puan - Zamanlanmış Puan Listesi](https://docs.altpay.dev/waas/(zamanlanmis-puan)/waas-scheduled-point-list): Bu servis ile şirketinize ait tüm zamanlanmış puan tanımlamalarını listeleyebilirsiniz.
- [Zamanlanmış Puan - Toplu Oluşturma](https://docs.altpay.dev/waas/(zamanlanmis-puan)/waas-scheduled-point-bulk-create): Bu servis ile kullanıcılarınıza zamanlanmış puan tanımlamaları toplu olarak oluşturabilirsiniz.
- [Token Kontrolü](https://docs.altpay.dev/waas/waas-check-token): Iframe ile Kullanım isteği cevabında verilen "token", ilgili kullanıcıya tanımlanmış ve belirli sürelidir.
- [Kullanıcı Kayıt - Oluştur](https://docs.altpay.dev/waas/(kullanici)/(kayit)/waas-user-register): Bu servis, OTP işleminden sonra kullanıcıyı oluşturup cüzdan hesabının açılması için kullanılır.
- [Kullanıcı Kayıt - Linkleme](https://docs.altpay.dev/waas/(kullanici)/(kayit)/waas-link-existing-user): Bu servis ile Macellan SuperApp'te kayıtlı ancak cüzdanınızda kayıtlı olmayan kullanıcıyı linkleme işlemi için kullanabilirsiniz.
- [Kullanıcı Güncelle - Durum](https://docs.altpay.dev/waas/(kullanici)/(guncelle)/waas-user-status-update): Bu servis ile kullanıcının durumu Aktif-Pasif e ayarlanabilir.
- [Kullanıcı Güncelle - Telefon](https://docs.altpay.dev/waas/(kullanici)/(guncelle)/waas-user-phone-update): Bu servis ile cüzdan uygulaması eşlemesi yapılan kullanıcınızın telefon bilgisini güncelleyebilirsiniz.
- [Kullanıcı Güncelle - Kullanıcı Bilgileri](https://docs.altpay.dev/waas/(kullanici)/(guncelle)/waas-user-update): Bu servis ile cüzdan uygulaması eşlemesi yapılan kullanıcılarınızın bilgilerini güncelleyebilirsiniz.
- [Kullanıcı Detay - Linkleme Id'ye Göre (Toplu)](https://docs.altpay.dev/waas/(kullanici)/(detay)/waas-user-get-by-mapping-bulk): İlgili linkleme id'lere ait kullanıcı bilgilerini toplu olarak verir.
- [Kullanıcı Detay - Telefon Numarasına Göre](https://docs.altpay.dev/waas/(kullanici)/(detay)/waas-user-get-by-phone): İlgili telefon numarasına ait kullanıcı bilgisi verilir.
- [Kullanıcı Detay - Linkleme Id'ye Göre](https://docs.altpay.dev/waas/(kullanici)/(detay)/waas-user-get-by-mapping): İlgili linkleme id ye ait kullanıcı bilgisi verilir.
- [Paketler ve Abonelikler - Satın Alınan Kullanılabilir Paketler](https://docs.altpay.dev/waas/(paketler-ve-abonelikler)/waas-purchased-packages): Belirtilen linkleme id'ye ait kullanıcının satın aldığı ve kullanılabilir paket ve aboneliklerin listesini döner.
- [Puan - Puan Geçmişi](https://docs.altpay.dev/waas/(puan)/waas-point-history): Bu servis ile şirketinize ait tüm cüzdan kullanıcılarının puan geçmişini görüntüleyebilirsiniz.
- [Nakit Yükleme - İşlem Geçmişi](https://docs.altpay.dev/waas/(nakit-yukleme)/waas-cash-deposit-list): Bu servis ile cüzdan kullanıcılarınızın ve şirketinizin nakit yükleme geçmişini görüntüleyebilirsiniz.
- [Nakit Yükleme - Yükleme Servisi](https://docs.altpay.dev/waas/(nakit-yukleme)/waas-cash-deposit-direct): Nakit yükleme servisi, entegratör firmanın, kullanıcıdan herhangi bir onay almadan kullanıcının cüzdanına nakit yükleme yapmasını sağlar.
- [Direct Payment - Ödeme Kontrolü](https://docs.altpay.dev/waas/(direct-payment)/waas-payment-pre-check): Sepet veya ödeme aşamalarında cüzdan ile ödeme seçeneğinde kullanabileceğiniz servistir.
- [Direct Payment - Ödeme Servisi](https://docs.altpay.dev/waas/(direct-payment)/waas-payment-make): Ödeme aşamasında kullanıcının cüzdanından belirtilen tutar kadar harcama yapma işlemi için kullanılır.
- [Direct Payment - Ödeme İade Servisi](https://docs.altpay.dev/waas/(direct-payment)/waas-payment-direct-refund): Ödeme yapıldıktan sonra istenilen tutarda iade işlemi yapmak için kullanılır.
- [Direct Payment - Ödeme Detay Güncelleme](https://docs.altpay.dev/waas/(direct-payment)/waas-payment-update-detail): Ödeme işlemi tamamlandıktan sonra ödeme detaylarını güncellemek için kullanılır.
- [iFrame ile Kullanım](https://docs.altpay.dev/waas/waas-open-iframe): Mobil uygulamanızda belirttiğiniz kullanıcı ile cüzdan uygulamasını açmak için kullanılır.
- [QR - QR Oluştur](https://docs.altpay.dev/waas/(qr)/waas-qr-generate): Bu servis, kullanıcının işlem yapabilmesi için bir qr kodu oluşturur.
- [Kampanyalar - Kampanya Listesi](https://docs.altpay.dev/waas/(kampanyalar)/waas-campaigns-list): Bu servis ile şirketinizin aktif kampanyalarını görüntüleyebilirsiniz.

## Webhook

- [Yükleme İşlemi](https://docs.altpay.dev/webhooks/deposit-success): Şirketinize ait cüzdanlara başarılı yükleme işlemi sonrası tetiklenir.
- [Waas Kullanıcı Kaydı](https://docs.altpay.dev/webhooks/waas-user-registered): Waas entegrasyon servisi ile kullanıcı kaydı gerçekleştirildikten sonra tetiklenir.
- [Nakit Yükleme İşlemi](https://docs.altpay.dev/webhooks/cash-deposit-success): Şirketinize ait cüzdanlara başarılı nakit yükleme işlemi sonrası tetiklenir.
- [Nakit Yükleme İadesi](https://docs.altpay.dev/webhooks/cash-deposit-refund): Şirketinize ait cüzdanlarda nakit yükleme iadesi işlemi sonrası tetiklenir.
- [Harcama İşlemi](https://docs.altpay.dev/webhooks/payment-complete): Şirketinize ait cüzdanlardan başarılı harcama işlemi sonrası tetiklenir.
- [Puan Kaydı İşlemi](https://docs.altpay.dev/webhooks/point-history): Şirketinize ait cüzdanlarda puan işlemi gerçekleştiğinde tetiklenir.
- [Webhook Çağrı Logları](https://docs.altpay.dev/webhooks/logs): Bu endpoint, uygulamanıza gönderilen webhook çağrılarının geçmişini görüntüleyebilmeniz için sunulur.
- [Harcama İadesi](https://docs.altpay.dev/webhooks/payment-refund): Şirketinize ait cüzdanlardan harcama iadesi işlemi sonrası tetiklenir.
- [Yükleme İadesi](https://docs.altpay.dev/webhooks/deposit-refund): Şirketinize ait cüzdanlarda yükleme iadesi işlemi sonrası tetiklenir.

## Event Log

- [Event Log Ekleme](https://docs.altpay.dev/event-log/add-event-log): Sistem event loglarını kaydetmek için kullanılır.