{ "info": { "_postman_id": "beabd722-a799-8906-a5fb-7ec9b4576f5c", "name": "Macellan SuperApp API", "description": { "content": "Macellan SuperApp API koleksiyonu. `baseUrl` ve `bearerToken` değişkenlerini doldurarak kullanabilirsiniz.", "type": "text/plain" }, "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "Ödeme", "description": "Payment and Refund Service\n\nContact Support:\n Email: altdev@macellan.net", "item": [ { "name": "Read QR", "description": "QR'ın kullanıcı tarafından oluşturulduğu akış", "item": [ { "id": "129d6503-4c6b-0a12-5344-0783c7921f91", "name": "Collect", "request": { "name": "Collect", "description": { "content": "- Collect servisi, harcama işlemi tutarının belirlenmesi için kullanılır.\n\n- Firma kullanıcının Macellan SuperApp mobil uygulamasından oluşturduğu\nQR kod veya 6 haneli referans koduyla birlikte harcama tutarını servise\nileterek bu servisi kullanır.\n\n- Servis başarılı bir şekilde çağrıldıktan sonra kullanıcı harcama özet ve onay ekranına yönlendirilir.\n\n### Extra Bilgiler\n:::note\n- `external_id` alanı opsiyoneldir. Genellikle ödemeye ait sipariş numarası gibi harici sistem ID'si burada gönderilir; işlemleri kolayca takip etmenize yardımcı olur.\n:::\n\n### Ürün Listesi\n`product_list` alanı opsiyoneldir ve satın alınan ürünlerin detaylarını bu alanda gönderebilirsiniz. Bu bilgiler\nraporlama ve analiz amaçlı kullanılır.\n\n:::note\nÜrün listesi gönderildiğinde:\n* Her ürün için `price` ve `quantity` alanları birlikte zorunludur\n* Her ürünün `total_price` değeri, `price * quantity` ile eşleşmelidir\n* Tüm ürünlerin `total_price` toplamı, harcama tutarı `price` ile eşleşmelidir\n:::\n", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "collect" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/payment/collect" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"price\": 1.23,\n \"reference_code\": 123456,\n \"branch_code\": \"Test-123\",\n \"external_id\": \"EXT-12345\",\n \"product_list\": [\n {\n \"item_id\": 1,\n \"name\": \"Ayran\",\n \"category_name\": \"İçecekler\",\n \"price\": 20,\n \"quantity\": 2,\n \"total_price\": 40\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c9696c60-cfbf-e02e-0fb8-260a376f1870", "name": "Status", "request": { "name": "Status", "description": { "content": "- Status servisi, harcama işleminin durumunu sorgulamak için kullanılır.\n- Firma, belirli aralıklarla harcama işleminin hangi durumda olduğunu sorgular. \n- Eğer harcama işlemi `approved` durumunda ise firma, harcama işlemini tamamlamak için [Complete](/payment/payment-complete) servisine istek gönderir. `no_balance`, `reject` ve `expire` durumları için firma, harcama işlemini sonlandırmalıdır. \n- İsteğe bağlı olarak `payment_id` yada `order_id` ile sorgulama yapabilirsiniz.", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "status" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Harcama İşlem ID", "type": "text/plain" }, "key": "payment_id", "value": "1" }, { "disabled": false, "description": { "content": "Harcama İşlemi Unique Sipariş ID", "type": "text/plain" }, "key": "order_id", "value": "1" } ], "variable": [], "raw": "{{baseUrl}}/integration/payment/status?payment_id=1&order_id=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a118f9e0-8cc2-b0aa-7a2b-26289949f5ac", "name": "Send Again Approval (Optional)", "request": { "name": "Send Again Approval (Optional)", "description": { "content": "- 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.", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "send-again-approval" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/payment/send-again-approval" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payment_id\": 1\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1098f1f2-6ea5-966b-2bbd-780b094a5489", "name": "Complete", "request": { "name": "Complete", "description": { "content": "- Complete servisi, harcama işleminin son adımıdır ve işlemi tamamlamak için kullanılır.\n- Kullanıcı harcama işlemi onayladıktan sonra bu servis çağrılmalıdır.\n- Bu servis çağrılmadığı takdirde kullanıcının bakiyesinden harcama işlem tutarı düşülmez.", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "complete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/payment/complete" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payment_id\": 1\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "43b06cb1-07a1-b1ad-3b82-87a0b63466c2", "name": "Cancel", "request": { "name": "Cancel", "description": { "content": "- Cancel servisi, harcama işleminin iptal edilmesini sağlar.\n- Eğer harcama işlemi kullanıcı onayında ise harcama iptal edilir ve harcama işleminin `status` değeri `cancel` olarak değişir.\n- Eğer harcama işlemi `complete` durumda ise harcama tutarı kullanıcıya iade edilir ve harcama işleminin `status` değeri `complete` olarak kalır.", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/payment/cancel" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payment_id\": 1\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "d308dcbf-ef41-6dc3-58e9-2aa3717bbada" }, { "name": "Generate QR", "description": "QR'ın entegratör firma tarafından oluşturulduğu akış", "item": [ { "id": "57f82e26-a090-f347-68bf-21f7dfafc365", "name": "Payment Create", "request": { "name": "Payment Create", "description": { "content": "- Create Servisi, harcama işlemlerini oluşturmak amacıyla kullanılır.\n\n- İşlem sonucunda dönen referans kodu, Macellan SuperApp kullanıcısına iletilir ve bu referans kodu ya da\noluşturulan QR kodu kullanılarak işlem devam ettirilebilir.\n\n- QR kodun süresi 120 saniyedir.\n\n### Extra Bilgiler\n:::note\n- `external_id` alanı opsiyoneldir. Genellikle ödemeye ait sipariş numarası gibi harici sistem ID'si burada gönderilir; işlemleri kolayca takip etmenize yardımcı olur.\n- Aynı kasa ve tutarla kısa süre içinde tekrar istek atıldığında mevcut QR döner. `external_id` farklı gönderilirse yeni bir QR üretilir.\n- Mevcut QR'ın tekrar kullanılabilmesi için `external_id` değerlerinin birebir eşleşmesi gerekir; isteklerden birinde `external_id` gönderilip diğerinde gönderilmediğinde de yeni bir QR üretilir.\n- Mevcut QR döndüğünde, istekle birlikte `product_list` gönderildiyse ürün listesi yeni gönderilen değerle güncellenir.\n:::\n\n### Ürün Listesi\n`product_list` alanı opsiyoneldir ve satın alınan ürünlerin detaylarını bu alanda gönderebilirsiniz. Bu bilgiler\nraporlama ve analiz amaçlı kullanılır.\n\n:::note\nÜrün listesi gönderildiğinde:\n* Her ürün için `price` ve `quantity` alanları birlikte zorunludur\n* Her ürünün `total_price` değeri, `price * quantity` ile eşleşmelidir\n* Tüm ürünlerin `total_price` toplamı, harcama tutarı `price` ile eşleşmelidir\n:::\n", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/payment/create" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"price\": 1.23,\n \"branch_code\": \"Test-123\",\n \"external_id\": \"EXT-12345\",\n \"product_list\": [\n {\n \"item_id\": 1,\n \"name\": \"Ayran\",\n \"category_name\": \"İçecekler\",\n \"price\": 20,\n \"quantity\": 2,\n \"total_price\": 40\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6ed3fb73-0c9b-714d-56fa-6485435f6926", "name": "Status", "request": { "name": "Status", "description": { "content": "- Status servisi, harcama işleminin durumunu sorgulamak için kullanılır.\n- Firma, belirli aralıklarla harcama işleminin hangi durumda olduğunu sorgular. \n- Eğer harcama işlemi `approved` durumunda ise firma, harcama işlemini tamamlamak için [Complete](/payment/payment-complete) servisine istek gönderir. `no_balance`, `reject` ve `expire` durumları için firma, harcama işlemini sonlandırmalıdır. \n- İsteğe bağlı olarak `payment_id` yada `order_id` ile sorgulama yapabilirsiniz.", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "status" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Harcama İşlem ID", "type": "text/plain" }, "key": "payment_id", "value": "1" }, { "disabled": false, "description": { "content": "Harcama İşlemi Unique Sipariş ID", "type": "text/plain" }, "key": "order_id", "value": "1" } ], "variable": [], "raw": "{{baseUrl}}/integration/payment/status?payment_id=1&order_id=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2af76a24-cff5-2bfb-df42-6f21bea8f224", "name": "Complete", "request": { "name": "Complete", "description": { "content": "- Complete servisi, harcama işleminin son adımıdır ve işlemi tamamlamak için kullanılır.\n- Kullanıcı harcama işlemi onayladıktan sonra bu servis çağrılmalıdır.\n- Bu servis çağrılmadığı takdirde kullanıcının bakiyesinden harcama işlem tutarı düşülmez.", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "complete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/payment/complete" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payment_id\": 1\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f0bfb00b-d64e-8024-95cd-8e873f37def8", "name": "Cancel", "request": { "name": "Cancel", "description": { "content": "- Cancel servisi, harcama işleminin iptal edilmesini sağlar.\n- Eğer harcama işlemi kullanıcı onayında ise harcama iptal edilir ve harcama işleminin `status` değeri `cancel` olarak değişir.\n- Eğer harcama işlemi `complete` durumda ise harcama tutarı kullanıcıya iade edilir ve harcama işleminin `status` değeri `complete` olarak kalır.", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/payment/cancel" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payment_id\": 1\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "d0f68b00-8fc2-f45b-8194-0a24828a1c73" }, { "name": "Refund", "description": "İade Servisi", "item": [ { "id": "d242bab9-1135-15d5-8b65-c83a37fc7131", "name": "Payment Refund Request List", "request": { "name": "Payment Refund Request List", "description": { "content": "- 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.\n- Mütabakat servisi olarak kullanılabilir.\n- Eğer bir harcamaya ait iadeleri almak istiyorsanız parametre olarak `order_id` göndererek filtreleme yapabilirsiniz.", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "refund", "request", "list" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Sayfa Başı Listeleme Sayısı", "type": "text/plain" }, "key": "per_page", "value": "30" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "start_date", "value": "2026-01-01T00:00:00Z" }, { "disabled": false, "description": { "content": "Bitiş Tarihi", "type": "text/plain" }, "key": "end_date", "value": "2026-01-31T23:59:59Z" }, { "disabled": false, "description": { "content": "Harcama İşlemi Unique Sipariş ID", "type": "text/plain" }, "key": "order_id", "value": "1" } ], "variable": [], "raw": "{{baseUrl}}/integration/payment/refund/request/list?per_page=30&start_date=2026-01-01T00:00:00Z&end_date=2026-01-31T23:59:59Z&order_id=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "01d569e4-fcaa-3831-afbe-23871a2b1e83", "name": "Details", "request": { "name": "Details", "description": { "content": "- Refund Request Details servisi, iade işleminin detaylarını görüntülemek için kullanılır.", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "refund", "request", ":refundRequestId", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "1", "key": "refundRequestId", "disabled": false, "description": { "content": "(Required) İade İşlem ID", "type": "text/plain" } } ], "raw": "{{baseUrl}}/integration/payment/refund/request/:refundRequestId/details" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3e6a47e1-f0c2-a92b-f024-5eb2f8fa6433", "name": "Refund Make", "request": { "name": "Refund Make", "description": { "content": "- Refund Make servisi harcama işleminin iadesini gerçekleştirmek için kullanılır.\n- Bu servis çağrıldıktan sonra iade işlemi sonlanır.", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "refund", "make" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/payment/refund/make" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"request_id\": 1,\n \"amount\": 1,\n \"comment\": \"Test\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "59e97d1f-1c33-b6a8-0e0d-72db86be410f", "name": "Refund Close", "request": { "name": "Refund Close", "description": { "content": "- Refund Close servisi iade isteğini iptal etmek için kullanılır.", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "refund", "close" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/payment/refund/close" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"request_id\": 1,\n \"comment\": \"Test\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "89aa6787-90b3-23e5-4484-5db92c75ed92", "name": "Direct Refund", "request": { "name": "Direct Refund", "description": { "content": "- Direct Refund servisi, entegratör firmanın kullanıcı tarafından oluşturulan iade isteği\nolmaksızın harcama işlemini iade etmek için kullanılır.\n\n### Ürün Listesi\n`product_list` alanı opsiyoneldir ve satın alınan ürünlerin detaylarını bu alanda gönderebilirsiniz. Bu bilgiler\nraporlama ve analiz amaçlı kullanılır.\n\n:::note\nÜrün listesi gönderildiğinde:\n* Her ürün için `price` ve `quantity` alanları birlikte zorunludur\n* Her ürünün `total_price` değeri, `price * quantity` ile eşleşmelidir\n* Tüm ürünlerin `total_price` toplamı, ödeme tutarı `price + point` ile eşleşmelidir\n:::\n", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "refund", "direct" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/payment/refund/direct" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": 1.23,\n \"order_id\": 1131347753,\n \"comment\": \"Test\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "27b8fbec-a1f5-5bd0-eb01-a46bf4c5a7d6" }, { "name": "OTP İle Ödeme", "description": "Müşterinin uygulamayı açmadan veya QR akışından bağımsız cep telefonuna gönderilecek olan OTP ile ödeme akışı\n\nİlk olarak [Gönderim](/payment/payment-with-otp-send) servisi çağırılarak, telefon ve ödeme detayları ile ödeme işlemi başlatılması gerekmektedir.\n\nSonrasında kullanıcıdan alınan OTP kod ve harcama id ile ödemenin [tamamlanması](/payment/payment-with-otp-complete) gerekmektedir.\n", "item": [ { "id": "4b2263d0-26f0-13a2-0f9b-e1213baa5cb7", "name": "Gönderim", "request": { "name": "Gönderim", "description": { "content": "- OTP ile ödeme başlatma servisi, müşterinin telefon ve ödeme detayları ile ödeme işlemi başlatılması için kullanılır. \n\n- Müşterinin telefonuna OTP doğrulama kodu gönderilir ve ödeme kaydını oluşturur. \n\n- Ödemeyi tamamlamak için [doğrulama](/payment/payment-with-otp-complete) servisi çağrılmalıdır.\n\n- Ödeme bilgileri 2 farklı şekilde kullanılabilir. Puan tutarının manuel belirlenmesi veya kullanıcıya puan kullanma seçeneğinin seçtirilmesi\n - **Puan Kullanımının Kullanıcı Tarafından Seçtirilmesi(point_usage kullanımı):** İstekte opsiyonel olarak istenen `point_usage` parametresi kullanıldığında,\nkullanıcı cüzdanındaki puan tutarı önceliklendirilerek, harcama tutarı kadar kullandırılmaya çalışılır.\nÖrn. 100 liralık harcama isteğinde, kullanıcının 500 Bakiye, 200 Puan olduğunu düşünürsek, `point_usage` parametresi `true` gönderdildiğinde harcama,\nkullanıcının puan tutarından düşürülerek gerçekleştirilir. Ödeme işlemi sonrası kullanıcının cüzdanı 500 Bakiye, 100 Puan olarak güncellenir.\n - **Puan Tutarının Manuel Belirlenmesi(point kullanımı):** Harcamada kullanıcının cüzdanından düşülecek puanın sizin tarafınızdan belirlenmesidir. \nİstekte opsiyonel olarak istenen `point` değeri kadar kullanıcı cüzdanından harcama yapılmaya çalışılır.\nÖrn. 100 liralık harcama isteğinde, price: 70, point: 30 gönderildiğinde kullanıcı cüzdanından 70 bakiye ve 30 puan ile harcama yapılmaya çalışılacaktır.\nBu yöntem ile harcama isteği yapıldığında, `price` ve `point` değerlerini kullanıcı cüzdan tutarına göre sizin hesaplamanız gerekmektedir.\nBu yöntem kullanıldığında `point_usage` parametresi gönderilse bile dikkate alınmayacaktır.\n\n### Extra Bilgiler\n:::note\n- `external_id` alanı opsiyoneldir. Genellikle ödemeye ait sipariş numarası gibi harici sistem ID'si burada gönderilir; işlemleri kolayca takip etmenize yardımcı olur.\n:::\n\n### Ürün Listesi\n`product_list` alanı opsiyoneldir ve satın alınan ürünlerin detaylarını bu alanda gönderebilirsiniz. Bu bilgiler\nraporlama ve analiz amaçlı kullanılır.\n\n:::note\nÜrün listesi gönderildiğinde:\n* Her ürün için `price` ve `quantity` alanları birlikte zorunludur\n* Her ürünün `total_price` değeri, `price * quantity` ile eşleşmelidir\n:::\n", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "otp", "send" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/payment/otp/send" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"+905231113344\",\n \"price\": 1.23,\n \"point\": 1,\n \"point_usage\": false,\n \"apply_campaigns\": true,\n \"external_id\": \"EXT-12345\",\n \"branch_code\": \"Test-123\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ff4fb636-c5bf-cb28-4f0e-cb48e163c5fb", "name": "Doğrulama", "request": { "name": "Doğrulama", "description": { "content": "- OTP ödeme tamamlama servisi ile müşteriden alınan OTP kodu ve harcama id ile ödeme işlemini tamamlamak için kullanılır. \n\n- [Ödeme Başlatma](/payment/payment-with-otp-send) isteğinden sonra çalıştırılması gerekmektedir.\n", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "otp", "complete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/payment/otp/complete" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"+905231113344\",\n \"code\": \"123456\",\n \"payment_id\": 1\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "26b3f6a9-a494-de02-98a1-8b8d887b43c0" }, { "name": "Payment", "description": "", "item": [ { "id": "06598c65-167b-35f1-87dc-4f2b8c5e640d", "name": "Direct Charge", "request": { "name": "Direct Charge", "description": { "content": "- Direct Charge servisi Macellan SuperApp kullanıcısı onayı, QR veya referans kodu olmadan harcama işlemi\nyapmak için kullanılır. \n\n- Bu servisi kullanmak için **Direct Payment Api** modülünün açık olması gerekir.\n\n### Extra Bilgiler\n:::note\n- `external_id` alanı opsiyoneldir. Genellikle ödemeye ait sipariş numarası gibi harici sistem ID'si burada gönderilir; işlemleri kolayca takip etmenize yardımcı olur.\n:::\n\n### Ürün Listesi\n`product_list` alanı opsiyoneldir ve satın alınan ürünlerin detaylarını bu alanda gönderebilirsiniz. Bu bilgiler\nraporlama ve analiz amaçlı kullanılır.\n\n:::note\nÜrün listesi gönderildiğinde:\n* Her ürün için `price` ve `quantity` alanları birlikte zorunludur\n* Her ürünün `total_price` değeri, `price * quantity` ile eşleşmelidir\n* Tüm ürünlerin `total_price` toplamı, harcama tutarı `price + point` ile eşleşmelidir\n:::\n", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "direct-charge" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/payment/direct-charge" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"wallet_id\": 12,\n \"price\": 1,\n \"gateway\": \"terminal\",\n \"point\": 0,\n \"branch_code\": \"Test-123\",\n \"external_id\": \"EXT-12345\",\n \"product_list\": [\n {\n \"item_id\": 1,\n \"name\": \"Ayran\",\n \"category_name\": \"İçecekler\",\n \"price\": 20,\n \"quantity\": 2,\n \"total_price\": 40\n }\n ],\n \"apply_campaigns\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3b18da8c-a205-4563-793a-d4c4e08b1705", "name": "Ödeme Detay Güncelleme", "request": { "name": "Ödeme Detay Güncelleme", "description": { "content": "- Ödeme işlemi tamamlandıktan sonra ödeme detaylarını güncellemek için kullanılır.\n\n- Bu servis ile ödeme işlemine ait ek bilgiler external_id, product_list ve extra gibi detaylar güncellenebilir.\n\n### Extra Bilgiler\n:::note\n- `external_id` alanı opsiyoneldir. Genellikle ödemeye ait sipariş numarası gibi harici sistem ID'si burada gönderilir; işlemleri kolayca takip etmenize yardımcı olur.\n- `extra` alanı opsiyoneldir ve ödeme işlemine ait ek bilgileri bu alanda gönderebilirsiniz.\n- `product_list` alanı opsiyoneldir ve satın alınan ürünlerin detaylarını bu alanda gönderebilirsiniz.\n:::\n\n### Ürün Listesi\n`product_list` alanı opsiyoneldir ve satın alınan ürünlerin detaylarını bu alanda gönderebilirsiniz. Bu bilgiler\nraporlama ve analiz amaçlı kullanılır.\n\n:::note\nÜrün listesi gönderildiğinde:\n* Her ürün için `price` ve `quantity` alanları birlikte zorunludur\n* Her ürünün `total_price` değeri, `price * quantity` ile eşleşmelidir\n* Tüm ürünlerin `total_price` toplamı, ödeme tutarı `price + point` ile eşleşmelidir\n:::\n", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "update", "detail" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/payment/update/detail" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"order_id\": 1131347753,\n \"external_id\": \"EXT-12345\",\n \"extra\": {\n \"note\": \"Özel not\",\n \"source\": \"mobile_app\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "44779958-6ab4-3bc6-fc0d-2bac9130da70", "name": "Payment List", "request": { "name": "Payment List", "description": { "content": "- 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. \n- Mütabakat servisi olarak kullanılabilir.", "type": "text/plain" }, "url": { "path": [ "integration", "payment", "list" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Sayfa Başı Listeleme Sayısı", "type": "text/plain" }, "key": "per_page", "value": "30" }, { "disabled": false, "description": { "content": "Başlangıç Tarihi", "type": "text/plain" }, "key": "start_date", "value": "2026-01-01T00:00:00Z" }, { "disabled": false, "description": { "content": "Bitiş Tarihi", "type": "text/plain" }, "key": "end_date", "value": "2026-01-31T23:59:59Z" }, { "disabled": false, "description": { "content": "Harcama Durumu (This can only be one of create,approval,approved,no_balance,reject,expire,complete,service_error)", "type": "text/plain" }, "key": "status", "value": "reject" }, { "disabled": false, "description": { "content": "Tek Bir Token İle Entegrasyon Sağlandığında Kullanılan Şube Kodu", "type": "text/plain" }, "key": "branch_code", "value": "12345" } ], "variable": [], "raw": "{{baseUrl}}/integration/payment/list?per_page=30&start_date=2026-01-01T00:00:00Z&end_date=2026-01-31T23:59:59Z&status=reject&branch_code=12345" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "fd70c159-f32f-3cab-627f-5eed50d30ea6" } ], "id": "ae9771fe-98c2-09b7-5a24-1aac1ea93f68" }, { "name": "Nakit Yükleme", "description": "Cash Deposit Service\n\nContact Support:\n Email: altdev@macellan.net", "item": [ { "name": "Read QR", "description": "QR'ın kullanıcı tarafından oluşturulduğu akış", "item": [ { "id": "1775b5c9-b64b-74d8-7939-6170f84c1cdc", "name": "Read QR", "request": { "name": "Read QR", "description": { "content": "- Read QR servisi, yükleme işlemi tutarının belirlenmesi için kullanılır.\n- Firma kullanıcının Macellan SuperApp mobil uygulamasından oluşturduğu QR kod veya 6 haneli referans koduyla birlikte yükleme tutarını servise ileterek bu servisi kullanır.\n- Servis başarılı bir şekilde çağrıldıktan sonra kullanıcı yükleme özet ve onay ekranına yönlendirilir.\n- İade işlemi için nakit yükleme servisinin kullanılacağı durumlarda `is_apply_campaigns` değeri `false` olarak gönderilmeli ve yapılan nakit yükleme işlemi için kullanıcının kampanyalardan yararlanması engellenmelidir. Eğer hiç bir değer göndermezseniz `true` olarak setlenecektir.", "type": "text/plain" }, "url": { "path": [ "integration", "deposit", "cash", "read-qr" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/deposit/cash/read-qr" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": 1.23,\n \"reference_code\": 123456,\n \"branch_code\": \"Test-123\",\n \"is_apply_campaigns\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1ab9a4a7-3a40-1c77-b876-ded875dbcb44", "name": "Send Again Approval(Opsiyonel)", "request": { "name": "Send Again Approval(Opsiyonel)", "description": { "content": "- 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.", "type": "text/plain" }, "url": { "path": [ "integration", "deposit", "cash", "send-again-approval" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/deposit/cash/send-again-approval" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": 1\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3383e987-39bb-6358-ca54-98a8e0a2feb5", "name": "Status", "request": { "name": "Status", "description": { "content": "- Status servisi, yükleme işleminin durumunu sorgulamak için kullanılır.\n- Firma, belirli aralıklarla yükleme işleminin hangi durumda olduğunu sorgular.\n- Eğer ödeme işlemi `success` durumunda ise firma, ödeme işlemini tamamlanmış olarak kabul etmelidir.\n- `reject` ve `expire` durumları için firma, yükleme işlemini sonlandırmalıdır.", "type": "text/plain" }, "url": { "path": [ "integration", "deposit", "cash", "status" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "id", "value": "1" } ], "variable": [], "raw": "{{baseUrl}}/integration/deposit/cash/status?id=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "76ad9417-36da-839b-b289-2c27e234a6b8" }, { "name": "Generate QR", "description": "QR'ın entegratör firma tarafından oluşturulduğu akış", "item": [ { "id": "65cbc4b3-eec4-38be-a2ae-c4a85d29fd19", "name": "Generate Qr", "request": { "name": "Generate Qr", "description": { "content": "- Generate Qr Servisi, yükleme işlemlerini oluşturmak amacıyla kullanılır.\n- İşlem sonucunda dönen referans kodu, Macellan SuperApp kullanıcısına iletilir ve bu referans kodu ya da oluşturulan QR kodu kullanılarak işlem devam ettirilebilir.\n- QR kodun süresi 120 saniyedir.\n- İade işlemi için nakit yükleme servisinin kullanılacağı durumlarda `is_apply_campaigns` değeri `false` olarak gönderilmeli ve yapılan nakit yükleme işlemi için kullanıcının kampanyalardan yararlanması engellenmelidir. Eğer hiç bir değer göndermezseniz `true` olarak setlenecektir.", "type": "text/plain" }, "url": { "path": [ "integration", "deposit", "cash", "generate-qr" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/deposit/cash/generate-qr" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": 1.23,\n \"branch_code\": \"Test-123\",\n \"is_apply_campaigns\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a1ea180f-9516-1807-4ffe-7a77b0a85a6d", "name": "Status", "request": { "name": "Status", "description": { "content": "- Status servisi, yükleme işleminin durumunu sorgulamak için kullanılır.\n- Firma, belirli aralıklarla yükleme işleminin hangi durumda olduğunu sorgular.\n- Eğer ödeme işlemi `success` durumunda ise firma, ödeme işlemini tamamlanmış olarak kabul etmelidir.\n- `reject` ve `expire` durumları için firma, yükleme işlemini sonlandırmalıdır.", "type": "text/plain" }, "url": { "path": [ "integration", "deposit", "cash", "status" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "id", "value": "1" } ], "variable": [], "raw": "{{baseUrl}}/integration/deposit/cash/status?id=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "86828596-482a-397f-5b84-25606980d31c" }, { "name": "Direct", "description": "", "item": [ { "id": "5a852dba-131c-365e-b6cb-b23cfd46ef81", "name": "Direct", "request": { "name": "Direct", "description": { "content": "- 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.\n- İade işlemi için nakit yükleme servisinin kullanılacağı durumlarda `is_apply_campaigns` değeri `false` olarak gönderilmeli ve yapılan nakit yükleme işlemi için kullanıcının kampanyalardan yararlanması engellenmelidir. Eğer hiç bir değer göndermezseniz `true` olarak setlenecektir.", "type": "text/plain" }, "url": { "path": [ "integration", "deposit", "cash", "direct" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/deposit/cash/direct" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"wallet_id\": 12,\n \"amount\": 1.23,\n \"branch_code\": \"Test-123\",\n \"is_apply_campaigns\": true,\n \"order_id\": \"1842515611\",\n \"method\": \"cash\",\n \"point\": 1.23,\n \"point_expire_date\": \"2025-12-31\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "88001dd6-9389-1f13-d8b5-1f64a68f411e" } ], "id": "ae8a574e-1da0-8a7b-e39e-cdbb3c3f0787" }, { "name": "QR", "description": "QR Service\n\nContact Support:\n Email: altdev@macellan.net", "item": [ { "id": "d4821e0e-627d-89a3-3f6f-8fd75b5ad054", "name": "Status", "request": { "name": "Status", "description": { "content": "- Qr durumunu sorgulamak, qr'ı oluşturan kullanıcıyı ve cüzdan bilgilerini almak için kullanılır.", "type": "text/plain" }, "url": { "path": [ "integration", "qr", "status" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) 6 Haneli Qr Referans Kodu", "type": "text/plain" }, "key": "reference_code", "value": "A1B2C3" }, { "disabled": false, "description": { "content": "Tek Bir Token İle Entegrasyon Sağlandığında Kullanılan Şube Kodu", "type": "text/plain" }, "key": "branch_code", "value": "12345" } ], "variable": [], "raw": "{{baseUrl}}/integration/qr/status?reference_code=A1B2C3&branch_code=12345" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "d755cb52-401c-1b4e-2db6-455a9958215e" }, { "name": "Cüzdan", "description": "Wallet Service\n\nContact Support:\n Email: altdev@macellan.net", "item": [ { "id": "1227690a-6eff-58ce-59c0-413bba309d56", "name": "Liste", "request": { "name": "Liste", "description": { "content": "- Şirkete ait cüzdanların listelendiği ve her bir cüzdanın sahibi ve bakiyesi gibi temel bilgileri gösterir.", "type": "text/plain" }, "url": { "path": [ "integration", "wallet", "list" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Filtrelenmek istenen başlangıç tarihi.", "type": "text/plain" }, "key": "start_date", "value": "2026-01-01T00:00:00Z" }, { "disabled": false, "description": { "content": "Filtrelenmek istenen minimum bakiye miktarı.", "type": "text/plain" }, "key": "min_balance", "value": "1" }, { "disabled": false, "description": { "content": "Filtrelenmek istenen minimum puan miktarı.", "type": "text/plain" }, "key": "min_point", "value": "1" }, { "disabled": false, "description": { "content": "Listelenmek istenen sayfa numarası.", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [], "raw": "{{baseUrl}}/integration/wallet/list?start_date=2026-01-01T00:00:00Z&min_balance=1&min_point=1&page=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "dd3e0a86-ad94-7226-8278-4661f5f8da9e", "name": "Detay", "request": { "name": "Detay", "description": { "content": "- İstenen cüzdana ait detaylar görüntülenir.\n- Detayda cüzdan sahibi ve bakiye gibi bilgiler vardır.", "type": "text/plain" }, "url": { "path": [ "integration", "wallet", ":walletId", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "1", "key": "walletId", "disabled": false, "description": { "content": "(Required) Görüntülenmek istenen cüzdan id numarasını temsil eder.", "type": "text/plain" } } ], "raw": "{{baseUrl}}/integration/wallet/:walletId/details" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "691fca59-47ed-655e-c3c9-9ba87f8c1576", "name": "Bakiye Geçmişi Listesi", "request": { "name": "Bakiye Geçmişi Listesi", "description": { "content": "- Kullanıcıların cüzdan bakiye geçmişi hakkında bilgi içeren verileri temsil eder.\n\n- Bakiye işlemlerini, yükleme geçmişini, harcama geçmişini ve diğer finansal işlemleri izlemek için kullanılır.\n\n
\n\n### Response Değerleri Ve Açıklamaları\n\n| Değer | Tip | Açıklama |\n|--------------------|-------------------|-----------------------------------------------|\n| `id` | integer | Bakiye ID |\n| `user_id` | integer | Kullanıcı ID |\n| `wallet_id` | integer | Cüzdan ID |\n| `branch_code` | string (nullable) | Şube Kodu |\n| `type` | string (enum) | İşlem Tipi (enum: top-up, capture, ...) |\n| `description` | string (enum) | Bakiye Açıklama (enum: bkm, masterpass ...) |\n| `amount` | float | İşlem Tutarı |\n| `spent_point` | float | Harcanan Puan Tutarı |\n| `earned_point` | float | Kazanılan Puan Tutarı |\n| `historyable_type` | string (enum) | Geçmiş Tipi (enum: bank_transfer, ...) |\n| `created_at` | string | Oluşturma Tarihi |\n\n
\n\n### Enum Değerleri Ve Açıklamaları\n\n#### `type` (İşlem Tipi)\n\n| Enum Değeri | Açıklama |\n|-------------------------|------------------------------|\n| `top-up` | Bakiye Yükleme |\n| `capture` | Bakiye Harcama |\n| `payment_refund` | Harcama İadesi |\n| `deposit_refund` | Yükleme İadesi |\n| `cash_deposit_refund` | Nakit Yükleme İadesi |\n\n
\n\n#### `description` (Bakiye Açıklama)\n\n| Enum Değeri | Açıklama |\n|---------------------------|------------------------------------|\n| `bkm` | BKM |\n| `masterpass` | Masterpass |\n| `masterpass_dp` | Masterpass DP |\n| `paycell` | Paycell |\n| `cash` | Nakit |\n| `turkcell_dcb` | Turkcell DCB |\n| `united_payment` | United Payment |\n| `united_payment_dp` | United Payment DP |\n| `eftpos` | ÖKC (Ödeme Kaydedici) |\n| `static_qr` | Statik QR |\n| `tag_qr` | Etiket QR |\n| `tap_card` | Temassız Kart |\n| `terminal` | Terminal |\n| `kerzz_pos` | Kerzz POS |\n| `simpra_pos` | Simpra POS |\n| `gizmo` | Gizmo |\n| `iap` | IAP (In-App Purchase) |\n| `soft_play` | Soft Play |\n| `soft_play_time_extension`| Soft Play Süre Uzatma |\n| `waas` | Waas |\n| `balance_burn` | Bakiye Yakma |\n| `order` | Sipariş |\n| `box_office` | Gişe |\n\n
\n\n#### `historyable_type` (Geçmiş Tipi)\n\n| Enum Değeri | Açıklama |\n|---------------------------|------------------------------|\n| `bank_transfer` | Banka Transferi |\n| `cash_deposit` | Nakit Yükleme |\n| `cash_deposit_refund` | Nakit Yükleme İadesi |\n| `deposit` | Yükleme |\n| `deposit_refund` | Yükleme İadesi |\n| `payment` | Harcama |\n| `payment_refund` | Harcama İadesi |\n", "type": "text/plain" }, "url": { "path": [ "integration", "wallet", "balance-history", "list" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Filtrelemek istenen başlangıç tarihi.", "type": "text/plain" }, "key": "start_date", "value": "2026-01-01T00:00:00Z" }, { "disabled": false, "description": { "content": "(Required) Filtrelemek istenen bitiş tarihi.", "type": "text/plain" }, "key": "end_date", "value": "2026-01-31T23:59:59Z" }, { "disabled": false, "description": { "content": "Listelenmek istenen sayfa numarası.", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [], "raw": "{{baseUrl}}/integration/wallet/balance-history/list?start_date=2026-01-01T00:00:00Z&end_date=2026-01-31T23:59:59Z&page=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a0af4e1f-ca1d-592d-7148-b992099abe77", "name": "Puan Geçmişi Listesi", "request": { "name": "Puan Geçmişi Listesi", "description": { "content": "- Kullanıcıların puan geçmişi hakkında bilgi içeren verileri temsil eder.\n\n- Kullanıcıların ödeme işlemleri ve kampanyalar sonucunda kazandıkları ve harcadıkları puanları izlemek için kullanılır.\n\n
\n\n### Response Değerleri Ve Açıklamaları\n\n| Alan | Tür | Açıklama |\n|-------------------|--------------------------|---------------------------------------------------|\n| `id` | integer | ID |\n| `user_id` | integer | Kullanıcı ID |\n| `wallet_id` | integer | Cüzdan ID |\n| `payment_id` | integer (nullable) | Harcama ID |\n| `branch_code` | string (nullable) | Şube Kodu |\n| `type` | string (enum) | İşlem Tipi (enum: usage, load, ...) |\n| `amount` | float | İşlem Tutarı |\n| `win_type` | string (enum) | Kazanma Tipi (enum: coupon, campaign, ...) |\n| `win_name` | string (nullable) | Kazanım Adı |\n| `campaign_type` | string (nullable) (enum) | Kampanya Tipi (enum: deposit_gift, ...) |\n| `created_at` | string | Oluşturma Tarihi |\n\n
\n\n### Enum Değerleri Ve Açıklamaları\n\n#### `type` (İşlem Tipi)\n\n| Enum Değeri | Açıklama |\n|--------------------|------------------------------|\n| `usage` | Harcama |\n| `load` | Kazanma |\n| `expire` | Süresi Doldu |\n| `revoke` | İptal |\n\n
\n\n#### `win_type` (Kazanma Tipi)\n\n| Enum Değeri | Açıklama |\n|--------------------|------------------------------|\n| `coupon` | Kupon |\n| `campaign` | Kampanya |\n| `receivable` | Alacak |\n| `gift_card` | Hediye Kartı |\n\n
\n\n#### `campaign_type` (Kampanya Tipi)\n\n| Enum Değeri | Açıklama |\n|---------------------------------|------------------------------|\n| `deposit_gift` | Yüklemeye Puan |\n| `payment_count_gift` | Harcama Sayısına Puan |\n| `cross_marketing_deposit_gift` | Çapraz Satış Yüklemeye Puan |\n", "type": "text/plain" }, "url": { "path": [ "integration", "wallet", "point-history", "list" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Filtrelemek istenen başlangıç tarihi.", "type": "text/plain" }, "key": "start_date", "value": "2026-01-01T00:00:00Z" }, { "disabled": false, "description": { "content": "(Required) Filtrelemek istenen bitiş tarihi.", "type": "text/plain" }, "key": "end_date", "value": "2026-01-31T23:59:59Z" }, { "disabled": false, "description": { "content": "Listelenmek istenen sayfa numarası.", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [], "raw": "{{baseUrl}}/integration/wallet/point-history/list?start_date=2026-01-01T00:00:00Z&end_date=2026-01-31T23:59:59Z&page=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0eb622d8-74b0-6702-eb39-fa982b17e313", "name": "Telefon Numarasına Göre", "request": { "name": "Telefon Numarasına Göre", "description": { "content": "- İlgili telefon numarasına ait cüzdan bilgisi verilir.\n", "type": "text/plain" }, "url": { "path": [ "integration", "wallet", "by-phone", ":phone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "905231113344", "key": "phone", "disabled": false, "description": { "content": "(Required) Telefon numarası", "type": "text/plain" } } ], "raw": "{{baseUrl}}/integration/wallet/by-phone/:phone" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "1ef20d0c-84c9-f014-99b4-942e1fad1b44" }, { "name": "Kullanıcı", "description": "User Service\n\nContact Support:\n Email: altdev@macellan.net", "item": [ { "id": "9349a75e-8b74-9f62-1b06-49e5f04bbc8a", "name": "Detay", "request": { "name": "Detay", "description": { "content": "- Token'ın bağlı olduğu kullanıcıya ait detaylar görüntülenir.", "type": "text/plain" }, "url": { "path": [ "integration", "user", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/user/me" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "51899e17-625a-3af8-3c75-a2a29f317d44", "name": "Yetkili Kullanıcı Oluştur", "request": { "name": "Yetkili Kullanıcı Oluştur", "description": { "content": "- Kasiyer ve Şube yetkilisi rolünde kullanıcı oluşturmak için kullanılır.\n- Kasiyer rolünde `branch_codes` alanı sadece bir şube kodu alabilir.\n- Şube yetkilisi rolünde `branch_codes` alanı birden fazla şube kodu alabilir.", "type": "text/plain" }, "url": { "path": [ "integration", "user", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/user/create" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"password\": \"test123\",\n \"branch_codes\": [\n \"Test-123\",\n \"Test-124\"\n ],\n \"role\": \"Branch Admin\",\n \"first_name\": \"Test\",\n \"last_name\": \"Test\",\n \"email\": \"test1@macellan.net\",\n \"phone\": \"+905231113344\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "27b55831-9d8e-2d5f-3c56-c2f2407da98f", "name": "Güncelle", "request": { "name": "Güncelle", "description": { "content": "- Önceden oluşturulan kullanıcıları güncellemek için kullanılır.\n- Kasiyer rolünde `branch_codes` alanı sadece bir şube kodu alabilir.\n- Şube yetkilisi rolünde `branch_codes` alanı birden fazla şube kodu alabilir.", "type": "text/plain" }, "url": { "path": [ "integration", "user", "update" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/user/update" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"id\": 1,\n \"phone\": \"+905231113344\",\n \"password\": \"test123\",\n \"branch_codes\": [\n \"Test-123\",\n \"Test-124\"\n ],\n \"role\": \"Branch Admin\",\n \"last_name\": \"Test\",\n \"email\": \"test1@macellan.net\",\n \"first_name\": \"Test\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bec2ad99-6db7-debc-763a-d9491581e760", "name": "Oluştur", "request": { "name": "Oluştur", "description": { "content": "- Bu servis, [OTP](/otp/otp-send) işleminden sonra kullanıcıyı oluşturup cüzdan hesabının açılması için kullanılır.\n", "type": "text/plain" }, "url": { "path": [ "integration", "user", "personal-user", "register" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/user/personal-user/register" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"verify_id\": 1,\n \"first_name\": \"Macellan\",\n \"last_name\": \"Superapp\",\n \"email\": \"dev@macellan.app\",\n \"phone\": \"+905231113344\",\n \"locale\": \"tr\",\n \"subscribe_sms\": false,\n \"subscribe_email\": false,\n \"id_number\": \"11111111111\",\n \"gender\": \"male\",\n \"birth_date\": \"2000-12-20\",\n \"register_waas\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "1bb57933-0897-cfa8-258d-c228c21d41c4" }, { "name": "Şirket", "description": "Company Service\n\nContact Support:\n Email: altdev@macellan.net", "item": [ { "id": "04cb4081-a393-ff3c-b954-049c6e90d8ba", "name": "Şirket Detayları", "request": { "name": "Şirket Detayları", "description": { "content": "Şirket detaylarını getirir.", "type": "text/plain" }, "url": { "path": [ "integration", "company", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/company/details" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "eb330f0f-9d53-c07e-16c9-18ec3019ce16" }, { "name": "Şube", "description": "Branch Service\n\nContact Support:\n Email: altdev@macellan.net", "item": [ { "id": "362b8fb6-b59c-b38d-76b0-52c064927a1b", "name": "Oluştur", "request": { "name": "Oluştur", "description": { "content": "- Şube oluşturmak için kullanılır.\n- Lokasyon bilgisi enlem ve boylam bilgisi arasına virgül konarak gönderilmelidir ('enlem,boylam').\n- Code alanı unique bir değer olarak gönderilmelidir.", "type": "text/plain" }, "url": { "path": [ "integration", "branch", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/branch/create" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"+905231113344\",\n \"active\": true,\n \"location\": \"41.08447542240944, 28.985638326773866\",\n \"open_address\": \"Test open address\",\n \"code\": \"Test-123\",\n \"allow_point_usage\": true,\n \"name\": \"Test Branch\",\n \"description\": \"Test description\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c96da277-1f6c-6782-0aa3-dee5a5a5cd36", "name": "Güncelle", "request": { "name": "Güncelle", "description": { "content": "- Önceden oluşturulan şubeleri güncellemek için kullanılır.\n- Code alanı güncellenmek istendiğinde mevcut kullanılan `code` alanı aynen gönderilmeli. Güncellenmek istenen `code` değeri ise `updated_code` olarak gönderilmelidir.", "type": "text/plain" }, "url": { "path": [ "integration", "branch", "update" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/branch/update" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"Test-123\",\n \"phone\": \"+905231113344\",\n \"active\": true,\n \"location\": \"41.08447542240944, 28.985638326773866\",\n \"open_address\": \"Test open address\",\n \"updated_code\": \"New-Code-123\",\n \"allow_point_usage\": true,\n \"description\": \"Test description\",\n \"name\": \"Test Branch\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "c0d0ef3b-4419-2959-4c83-a2844f5e9e41" }, { "name": "Temassız Kart", "description": "Temassız kart işlemleri için API dokümantasyonu\n\nContact Support:\n Email: altdev@macellan.net", "item": [ { "id": "3a0ebffa-4f9d-a6a3-b1ff-d3c5f7d6959d", "name": "Kart ile Ödeme", "request": { "name": "Kart ile Ödeme", "description": { "content": "Bu endpoint kart numarası ile ödeme almak için kullanılır.\n\n### Kart Numarası\nKart numarası iki farklı formattan biriyle gönderilebilir:\n* `card_no`: Hex formatında işlenmiş kart numarası (örn: '1234ABCD')\n* `card_no_raw`: İşlenmemiş numerik kart numarası (örn: 123456789)\n\nBu alanlardan sadece birinin gönderilmesi zorunludur. `card_no_raw` gönderildiğinde, sistem otomatik olarak kart numarasını little-endian hex formatına dönüştürür.\n\n#### Little-Endian Dönüşümü\nLittle-endian dönüşümü, kart numarasını hex formatına çevirip byte'ları ters çevirme işlemidir.\nÖrneğin:\n```\nNumerik: 123456789\nLittle-endian: 15CD5B07\n```\n\n### Ürün Listesi\n`product_list` alanı opsiyoneldir ve satın alınan ürünlerin detaylarını bu alanda gönderebilirsiniz. Bu bilgiler\nraporlama ve analiz amaçlı kullanılır.\n\n:::note\nÜrün listesi gönderildiğinde:\n* Her ürün için `price` ve `quantity` alanları birlikte zorunludur\n* Her ürünün `total_price` değeri, `price * quantity` ile eşleşmelidir\n* Tüm ürünlerin `total_price` toplamı, ödeme tutarı `price` ile eşleşmelidir\n:::\n", "type": "text/plain" }, "url": { "path": [ "integration", "tap-card", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/tap-card/pay" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"price\": 40,\n \"card_no\": \"15CD5B07\",\n \"card_no_raw\": 123456789\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "96700205-1878-ba4d-b912-4a0689882eef", "name": "Bakiye Sorgulama", "request": { "name": "Bakiye Sorgulama", "description": { "content": "Kart bakiye sorgulama işlemi yapar.\n\n ### Kart Numarası\n Kart numarası iki farklı formattan biriyle gönderilebilir:\n * `card_no`: Hex formatında işlenmiş kart numarası (örn: '1234ABCD')\n * `card_no_raw`: İşlenmemiş numerik kart numarası (örn: 123456789)\n\n Bu alanlardan sadece birinin gönderilmesi zorunludur. `card_no_raw` gönderildiğinde, sistem otomatik olarak kart numarasını little-endian hex formatına dönüştürür.\n\n #### Little-Endian Dönüşümü\n Little-endian dönüşümü, kart numarasını hex formatına çevirip byte'ları ters çevirme işlemidir.\n Örneğin:\n ```\n Numerik: 123456789\n Little-endian: 15CD5B07\n ```\n", "type": "text/plain" }, "url": { "path": [ "integration", "tap-card", "balance-inquiry" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/tap-card/balance-inquiry" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"card_no\": \"15CD5B07\",\n \"card_no_raw\": 123456789\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "2c3b8be4-3583-f16c-d843-3b389ae67eab" }, { "name": "Box Office", "description": "Box Office işlemleri için API dokümantasyonu\n\nContact Support:\n Email: altdev@macellan.net", "item": [ { "id": "ac5183cb-da78-39b5-6dd2-a5a5291e2928", "name": "Kart Kaydı ve Bakiye Yükleme", "request": { "name": "Kart Kaydı ve Bakiye Yükleme", "description": { "content": "Bu endpoint, yeni bir kullanıcı için kart kaydı ve bakiye yükleme işlemlerini gerçekleştirir.\n- Kullanıcının telefon numarasına OTP (Tek Kullanımlık Şifre) gönderilir. OTP işlemleri için bkz: [OTP Gönderim](/otp/otp-send)\n- OTP doğrulaması başarılı olduğunda, verify_id alınır\n- Telefon numarası, verify_id ve aşağıdaki bilgilerle birlikte endpoint çağrılır.\n\nNot: Ek bilgiler 'extra' alanında gönderilebilir.", "type": "text/plain" }, "url": { "path": [ "integration", "box-office", "verified-top-up" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/box-office/verified-top-up" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"+905321234567\",\n \"verify_id\": 12345,\n \"card_no\": \"1234567890\",\n \"amount\": 100.5,\n \"method\": \"cash\",\n \"extra\": {\n \"note\": \"İlk yükleme\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "764bd7be-a510-2336-35ac-4f822a7f4dda", "name": "Bakiye Yükleme", "request": { "name": "Bakiye Yükleme", "description": { "content": "Mevcut bir karta bakiye yükleme işlemi yapar.", "type": "text/plain" }, "url": { "path": [ "integration", "box-office", "top-up" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/box-office/top-up" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"card_no\": \"1234567890\",\n \"amount\": 50,\n \"method\": \"credit_card\",\n \"extra\": {\n \"receipt_no\": \"RC123456\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "34d094dd-763f-2881-71a1-a8ca98a0c9f0", "name": "Bakiye Sorgulama", "request": { "name": "Bakiye Sorgulama", "description": { "content": "Kart bakiye sorgulama işlemi yapar.", "type": "text/plain" }, "url": { "path": [ "integration", "box-office", "balance-inquiry" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/box-office/balance-inquiry" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"card_no\": \"1234567890\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "70201059-21f3-b4e3-05d3-8af0106a12ec" }, { "name": "OTP", "description": "OTP\n\nContact Support:\n Email: altdev@macellan.net", "item": [ { "name": "OTP", "description": "OTP doğrulama isteyen servisler için, gönderim ve doğrulama işlemi yapabilmenizi sağlar.\n\nÖrnek:\n - [Waas Kullanıcı Kayıt](/waas/waas-user-register)\n - [Waas Kullanıcı Linkleme](/waas/waas-link-existing-user)\n - [Waas Kullanıcı Telefonu Güncelleme](/waas/waas-user-phone-update)\n - [Box Office Kart Kaydı ve Bakiye Yükleme](/box-office/verified-top-up)", "item": [ { "id": "1726d4a3-ffa4-770f-bce9-77cfa40f6da6", "name": "Gönderim", "request": { "name": "Gönderim", "description": { "content": "Belirtilen telefon numarasına, OTP gönderimini sağlar.\n\n**Not:** Development ortamında [doğrulamayı](/otp/otp-verify) başarılı şekilde çalıştırmanız için response da code bilgisi gönderilmektedir.", "type": "text/plain" }, "url": { "path": [ "integration", "otp", "send" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/otp/send" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"+905231113344\",\n \"gateway\": \"sms\",\n \"app_hash\": null\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d932f95c-1a0c-71b4-ade4-30f89e74f182", "name": "Doğrulama", "request": { "name": "Doğrulama", "description": { "content": "Gönderim yapılan OTP yi doğrulama işlemi için kullanılmaktadır. Bu servisten dönen ``verify_id`` değeri, OTP doğrulama isteyen servislerde kullanılabilir.", "type": "text/plain" }, "url": { "path": [ "integration", "otp", "verify" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/otp/verify" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"string\",\n \"gateway\": \"sms\",\n \"phone\": \"+905231113344\",\n \"app_hash\": null\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "cbe40288-1afe-39b0-1197-999b33a18c8a" } ], "id": "a5253f86-ec8f-6c4d-ea14-5bbd28735e26" }, { "name": "Waas", "description": "Wallet As A Service\n\nContact Support:\n Email: altdev@macellan.net", "item": [ { "name": "Kullanıcı Detay", "description": "", "item": [ { "id": "09bab053-390b-2a06-e7b9-29c2ec37490a", "name": "Telefon Numarasına Göre", "request": { "name": "Telefon Numarasına Göre", "description": { "content": "İlgili telefon numarasına ait kullanıcı bilgisi verilir. \nBu servis, kullanıcıya cüzdan hesabı oluşturmak için hangi servisleri çağırmanız gerektiğini belirlemek için de kullanılabilir. Aşağıdaki maddelere göre işlem gerçekleştirilebilir.\n\n- 404 response ve response içerisinde `state: \"non_registered\"` verilmesi durumunda, bu telefon numarasının Macellan SuperApp'te kayıtlı olmadığı belirtilir. [OTP](/otp/otp-send) işlemi gerçekleştirip [Oluştur](/waas/waas-user-register) servisi çağrılmalıdır.\n- Response datası içerisinde `state: \"registered_but_non_linked\"`, ise bu telefon numarası Macellan SuperApp'te kayıtlı ancak cüzdan linklemesi yapılmamıştır. [OTP](/otp/otp-send) işlemi gerçekleştirip [Linkleme](/waas/waas-link-existing-user) servisi çağrılmalıdır.\n - Linklemesi yapılmamış kullanıcının ad-soyad gibi bilgileri maskelenmiş olarak verilmekte. (Response içerisinde verilen user bilgisi)\n- Response datası içerisinde `state: \"linked\"` ise, bu telefon numarası linklenmiştir.\n - Kullanıcı bilgisi maskelenmeden verilir. (Response içerisinde verilen user bilgisi)\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "users", "by-phone", ":phone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "905231113344", "key": "phone", "disabled": false, "description": { "content": "(Required) Telefon numarası", "type": "text/plain" } } ], "raw": "{{baseUrl}}/waas/integration/users/by-phone/:phone" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4cb0514a-5381-3ea4-08ff-7014adc004df", "name": "Linkleme Id'ye Göre", "request": { "name": "Linkleme Id'ye Göre", "description": { "content": "İlgili linkleme id ye ait kullanıcı bilgisi verilir.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "users", "by-mapping", ":userMappingId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "8b5ac43a-20ce-4987-a739-d8a7ee480eaa", "key": "userMappingId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ], "raw": "{{baseUrl}}/waas/integration/users/by-mapping/:userMappingId" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9572a174-11c6-ec9d-0911-b908adc0a8b4", "name": "Linkleme Id'ye Göre (Toplu)", "request": { "name": "Linkleme Id'ye Göre (Toplu)", "description": { "content": "İlgili linkleme id'lere ait kullanıcı bilgilerini toplu olarak verir.\nMaksimum 30 adet linkleme id gönderilebilir.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "users", "by-mapping-bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/users/by-mapping-bulk" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"user_mapping_ids\": [\n \"8b5ac43a-20ce-4987-a739-d8a7ee480eaa\",\n \"9c6bd54b-31df-5098-b840-e9b8ff591fbb\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "f54cb308-4d2a-681d-f3d8-9d39b71320aa" }, { "name": "Kullanıcı Güncelleme", "description": "", "item": [ { "id": "6b2f78c6-0ee1-fb5f-cede-b9a4ed8e88ba", "name": "Telefon", "request": { "name": "Telefon", "description": { "content": "- Bu servis ile cüzdan uygulaması eşlemesi yapılan kullanıcınızın telefon bilgisini güncelleyebilirsiniz. [OTP](/otp/otp-send) işleminden sonra çalıştırılmaldır.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "users", "phone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/users/phone" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"user_mapping_id\": \"8b5ac43a-20ce-4987-a739-d8a7ee480eaa\",\n \"phone\": \"+905231113344\",\n \"verify_id\": 1\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "20173da6-8999-e1d8-8645-4e74c1bba48b", "name": "Durum", "request": { "name": "Durum", "description": { "content": "- Bu servis ile kullanıcının durumu Aktif-Pasif e ayarlanabilir. Pasif kullanıcılar waas uygulamasını kullanamaz.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "users", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/users/status" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"user_mapping_id\": \"8b5ac43a-20ce-4987-a739-d8a7ee480eaa\",\n \"is_active\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "46c301c5-9929-ce6f-a38a-300eccea1975" }, { "name": "Nakit Yükleme", "description": "", "item": [ { "id": "980f215c-8f5d-feca-23ce-2dcf0271d74f", "name": "Yükleme Servisi", "request": { "name": "Yükleme Servisi", "description": { "content": "- 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.\n- İade işlemi için nakit yükleme servisinin kullanılacağı durumlarda `is_apply_campaigns` değeri `false` olarak gönderilmeli ve yapılan nakit yükleme işlemi için kullanıcının kampanyalardan yararlanması engellenmelidir. Eğer hiç bir değer göndermezseniz `true` olarak setlenecektir.", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "cash-deposits", "make" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/cash-deposits/make" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"user_mapping_id\": \"8b5ac43a-20ce-4987-a739-d8a7ee480eaa\",\n \"amount\": 1.23,\n \"is_apply_campaigns\": true,\n \"order_id\": \"1842515611\",\n \"method\": \"cash\",\n \"point\": 1.23,\n \"point_expire_date\": \"2025-12-31\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "513897a5-adf7-e78b-aa1b-a268a3766fe3", "name": "İşlem Geçmişi", "request": { "name": "İşlem Geçmişi", "description": { "content": "- Bu servis ile cüzdan kullanıcılarınızın ve şirketinizin nakit yükleme geçmişini görüntüleyebilirsiniz.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "cash-deposits", "list" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Filtrelemek istenen başlangıç tarihi.", "type": "text/plain" }, "key": "start_date", "value": "2026-01-01T00:00:00Z" }, { "disabled": false, "description": { "content": "(Required) Filtrelemek istenen bitiş tarihi.", "type": "text/plain" }, "key": "end_date", "value": "2026-01-31T23:59:59Z" }, { "disabled": false, "description": { "content": "Kullanıcı oluşturma veya linkleme aşamasında size iletilen ilgili kullanıcıya ait linkleme id değeri.", "type": "text/plain" }, "key": "user_mapping_id", "value": "a08a39ed-78c5-43dc-ae5c-161e50a634fd" }, { "disabled": false, "description": { "content": "Listelenmek istenen sayfa numarası.", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [], "raw": "{{baseUrl}}/waas/integration/cash-deposits/list?start_date=2026-01-01T00:00:00Z&end_date=2026-01-31T23:59:59Z&user_mapping_id=a08a39ed-78c5-43dc-ae5c-161e50a634fd&page=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "5340305e-1ea3-ade2-80f8-96978ef0c08a" }, { "name": "Paketler ve Abonelikler", "description": "", "item": [ { "id": "db19d4c5-c79f-4805-fd31-cdbdfb69336c", "name": "Satın Alınan Kullanılabilir Paketler", "request": { "name": "Satın Alınan Kullanılabilir Paketler", "description": { "content": "- Belirtilen linkleme id'ye ait kullanıcının satın aldığı ve kullanılabilir paket ve aboneliklerin listesini döner.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "purchased-packages", ":userMappingId" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Listelenmek istenen sayfa numarası.", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [ { "type": "any", "value": "8b5ac43a-20ce-4987-a739-d8a7ee480eaa", "key": "userMappingId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ], "raw": "{{baseUrl}}/waas/integration/purchased-packages/:userMappingId?page=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "7e1c11d5-b6bc-2bb4-abbc-6c8342f9d477" }, { "name": "Kampanyalar", "description": "", "item": [ { "id": "282cfe60-3034-d799-c630-92a8447904e2", "name": "Kampanya Listesi", "request": { "name": "Kampanya Listesi", "description": { "content": "- Bu servis ile şirketinizin aktif kampanyalarını görüntüleyebilirsiniz.\n\n- `user_mapping_id` parametresi opsiyoneldir. Gönderildiğinde, kullanıcının kampanyaları kullanıp kullanmadığı bilgisi de döner.\n\n- `user_mapping_id` parametresi gönderildiğinde, kullanıcının daha önce kullandığı `onboarding` kampanyaları varsa listede görünmez.\n\n### Enum Değerleri Ve Açıklamaları\n\n#### `campaign_types` (Kampanya Türü)\n\n| Enum Değeri | Açıklama |\n|---------------------------------|------------------------------|\n| `deposit_gift` | Yüklemeye Puan |\n| `payment_count_gift` | Harcama Sayısına Puan |\n| `cross_marketing_deposit_gift` | Çapraz Satış Yüklemeye Puan |\n| `payment_discount` | Harcamaya İndirim |\n\n
\n\n#### `point_earn_type` (Puan Kazanma Türü)\n\n| Enum Değeri | Açıklama |\n|---------------|--------------|\n| `fixed` | Tutar Bazlı |\n| `percentage` | Oran Bazlı |\n\n
\n\n#### `point_earn_type` Alanlarına Göre Sıfır Değerler\n\n| point_earn_type | point_amount | point_percent |\n|-----------------|--------------|---------------|\n| `fixed` | Değer döner | 0 döner |\n| `percentage` | 0 döner | Değer döner |\n\n
\n\n#### Kampanya Türlerine Göre Alan Kullanımı\n\n| Kampanya Türü | point_earn_type | amount | point_amount | point_percent | process_count | minimum_amount | maximum_amount |\n|----------------|------------------|--------|--------------|---------------|---------------|----------------|----------------|\n| `deposit_gift` | fixed/percentage | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |\n| `payment_count_gift` | fixed/percentage | ❌ | ✅ | ✅ | ✅ | ✅ | ❌ |\n| `cross_marketing_deposit_gift` | fixed | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |\n| `payment_discount` | percentage | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |\n\n
\n\n#### Boolean Alanlar\n\n| Alan | Açıklama |\n|------|----------|\n| `multiple_usage` | Çoklu Kullanım: Aynı kampanya aynı kullanıcı için birden fazla kez kullanılabilir |\n| `include_multiples` | Katlarını Dahil Et (point_earn_type=fixed olduğunda): Yükleme tutarının katlarına da puan kazanılabilir |\n| `combined_usage` | Diğer Kampanyalarla Kullanım: Diğer kampanyalarla birlikte kullanılabilir |\n| `onboarding` | Onboarding Kampanyası: Yeni kayıt olan kullanıcılar için kullanılabilir kampanya |\n\n
\n\n#### Tarih Alanları\n\n| Alan | Açıklama |\n|------|----------|\n| `point_expire_date` | Puan son kullanma tarihi (sabit tarih seçildiğinde) |\n| `expiration_days` | Puan geçerlilik gün sayısı (gün bazlı seçildiğinde) |\n| `calculated_expiration_date` | Hesaplanan puan son kullanma tarihi (point_expire_date varsa onu, yoksa expiration_days kadar gün ekleyerek hesaplanan tarihi) |\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "campaigns", "list" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Kullanıcı oluşturma veya linkleme aşamasında size iletilen ilgili kullanıcıya ait linkleme id değeri.", "type": "text/plain" }, "key": "user_mapping_id", "value": "8b5ac43a-20ce-4987-a739-d8a7ee480eaa" }, { "disabled": false, "description": { "content": "Kampanya türü filtresi", "type": "text/plain" }, "key": "campaign_types", "value": "deposit_gift" }, { "disabled": false, "description": { "content": "Kampanya türü filtresi", "type": "text/plain" }, "key": "campaign_types", "value": "cross_marketing_deposit_gift" } ], "variable": [], "raw": "{{baseUrl}}/waas/integration/campaigns/list?user_mapping_id=8b5ac43a-20ce-4987-a739-d8a7ee480eaa&campaign_types=deposit_gift&campaign_types=cross_marketing_deposit_gift" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "41116d21-8813-f061-213f-dfc997a96b52" }, { "name": "Qr", "description": "", "item": [ { "id": "0335c98c-4962-3512-ed70-f9621c9f4be4", "name": "QR Oluştur", "request": { "name": "QR Oluştur", "description": { "content": "- Bu servis, kullanıcının işlem yapabilmesi için bir qr kodu oluşturur.\n\n- QR kodun süresi 120 saniyedir.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "qr", "generate" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Kullanıcı oluşturma veya linkleme aşamasında size iletilen ilgili kullanıcıya ait linkleme id değeri.", "type": "text/plain" }, "key": "user_mapping_id", "value": "8b5ac43a-20ce-4987-a739-d8a7ee480eaa" } ], "variable": [], "raw": "{{baseUrl}}/waas/integration/qr/generate?user_mapping_id=8b5ac43a-20ce-4987-a739-d8a7ee480eaa" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "cab0597f-f864-ba61-7875-7afd0686bd2e" }, { "name": "Temassız Kart", "description": "", "item": [ { "id": "5b8fc49a-84e6-6f67-3671-b80b2b42ba71", "name": "Kart Tanımlama", "request": { "name": "Kart Tanımlama", "description": { "content": "- Bu servis ile cüzdan kullanıcılarınıza temassız kart tanımlayabilirsiniz.\n\n- Tek bir kart tanımlamak için de bu servis kullanılır, `cards` dizisine tek eleman göndermeniz yeterlidir.\n\n- Her istekte en fazla **50** kart gönderilebilir.\n\n- `name` alanı karta yazılan etikettir. Kartı fiilen kullanan kişiyi ayırt etmek için kullanılabilir.\n\n- Kart numarası halihazırda aktif bir karta aitse veya kullanıcı bulunamazsa, o kart `fails` listesinde döner. Listedeki diğer kartlar tanımlanmaya devam eder.\n\n- Aynı kart numarası bir istekte iki kez gönderilemez.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "tap-card", "bulk", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/tap-card/bulk/create" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"cards\": [\n {\n \"card_no\": \"1A2B3C4D\",\n \"user_mapping_id\": \"8b5ac43a-20ce-4987-a739-d8a7ee480eaa\",\n \"name\": \"Ayşe Yılmaz\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8f40674e-3bfd-4a98-9c4e-85f4ca7418d3", "name": "Kart Listesi", "request": { "name": "Kart Listesi", "description": { "content": "- Bu servis ile bir cüzdan kullanıcısına tanımlı **aktif** kartları listeleyebilirsiniz.\n\n- İptal edilmiş kartlar listede yer almaz.\n\n- Kartlar en yeniden eskiye doğru sıralanır.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "tap-card", "list" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Kullanıcı oluşturma veya linkleme aşamasında size iletilen ilgili kullanıcıya ait linkleme id değeri.", "type": "text/plain" }, "key": "user_mapping_id", "value": "8b5ac43a-20ce-4987-a739-d8a7ee480eaa" } ], "variable": [], "raw": "{{baseUrl}}/waas/integration/tap-card/list?user_mapping_id=8b5ac43a-20ce-4987-a739-d8a7ee480eaa" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "23720182-8877-f839-6987-65ac1a029a99", "name": "Kart İptali", "request": { "name": "Kart İptali", "description": { "content": "- Bu servis ile cüzdan kullanıcılarınıza tanımlı temassız kartları iptal edebilirsiniz.\n\n- Tek bir kart iptal etmek için de bu servis kullanılır, `cards` dizisine tek eleman göndermeniz yeterlidir.\n\n- Her istekte en fazla **50** kart gönderilebilir.\n\n- İptal edilemeyen kartlar `fails` listesinde sebebiyle birlikte döner. Listedeki diğer kartlar iptal edilmeye devam eder.\n\n- Aynı kart numarası bir istekte iki kez gönderilemez.\n\n- Kart iptali kullanıcının cüzdan bakiyesine dokunmaz. Kartın depozitosu varsa iade edildi olarak kapatılır, tutar cüzdana yüklenmez. İptal sebebi `lost` ise depozito iade edilmez.\n\n:::warn\nİptal geri alınamaz. Aynı kart numarası daha sonra yeniden tanımlanabilir, ancak iptal edilen kayıt tekrar aktif edilemez.\n:::\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "tap-card", "bulk", "reset" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/tap-card/bulk/reset" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"cards\": [\n \"1A2B3C4D\",\n \"5E6F7G8H\"\n ],\n \"reason\": \"refund\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "4afb3db3-a518-e821-04bb-c7e65a574a36" }, { "name": "Müşteri Grupları", "description": "", "item": [ { "id": "a4524678-2c68-d8c9-2a4c-07f1ba75750d", "name": "Müşteri Grubu Listesi", "request": { "name": "Müşteri Grubu Listesi", "description": { "content": "- Bu servis ile şirketinize ait müşteri gruplarını listeleyebilirsiniz.\n\n- Müşteri grupları Macellan SuperApp panelinden oluşturulur. Bu servis yalnızca var olan grupları listeler.\n\n- Gruplar en yeniden eskiye doğru sıralanır.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "user-groups" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Listelenmek istenen sayfa numarası.", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [], "raw": "{{baseUrl}}/waas/integration/user-groups?page=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "546bd7db-303e-4f05-b59e-6d5d3ae9decb", "name": "Gruba Üye Ekleme", "request": { "name": "Gruba Üye Ekleme", "description": { "content": "Bu servis ile bir müşteri grubuna **temassız kart** veya **telefon numarası** ekleyebilirsiniz.\n\n**Genel**\n\n- `type` alanında üye türünü (`tap_card` veya `phone`), `values` alanında kart veya telefon numaralarını gönderin.\n\n- Her istekte yalnızca bir tür gönderilir, en fazla **1000** değer gönderilebilir.\n\n- Eklenemeyen üyeler `fails` listesinde, gönderdiğiniz değer ve sebebiyle birlikte döner. Listedeki diğer üyeler eklenmeye devam eder.\n\n**Temassız kart** (`tap_card`)\n\n- Kart, grubun şirketine ait ve aktif olmalıdır.\n\n- İptal edilen kart artık grubun üyesi sayılmaz. Kart daha sonra yeniden tanımlanırsa gruba tekrar eklenmelidir.\n\n**Telefon** (`phone`)\n\n- Telefon numarası, şirketinizde cüzdanı olan bir kullanıcıya ait olmalıdır.\n\n- Numara `+90 532 123 45 67`, `05321234567` gibi farklı biçimlerde gönderilebilir.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "user-groups", ":id", "members" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "32", "key": "id", "disabled": false, "description": { "content": "(Required) Müşteri grubu listesinde dönen grup id değeri.", "type": "text/plain" } } ], "raw": "{{baseUrl}}/waas/integration/user-groups/:id/members" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"tap_card\",\n \"values\": [\n \"1A2B3C4D\",\n \"5E6F7G8H\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5ab43302-af20-95bb-d7b9-b9f6a5aea23d", "name": "Gruptan Üye Çıkarma", "request": { "name": "Gruptan Üye Çıkarma", "description": { "content": "Bu servis ile bir müşteri grubundan **temassız kart** veya **telefon numarası** çıkarabilirsiniz.\n\n**Genel**\n\n- `type` alanında üye türünü (`tap_card` veya `phone`), `values` alanında kart veya telefon numaralarını gönderin.\n\n- Her istekte yalnızca bir tür gönderilir, en fazla **1000** değer gönderilebilir.\n\n- Grupta bulunmayan üyeler `fails` listesinde, gönderdiğiniz değerle birlikte döner. Listedeki diğer üyeler çıkarılmaya devam eder.\n\n**Temassız kart** (`tap_card`)\n\n- Kart numarası, kartın durumuna bakılmadan eşleştirilir. İptal edilmiş bir kart da gruptan çıkarılabilir.\n\n**Telefon** (`phone`)\n\n- Numara `+90 532 123 45 67`, `05321234567` gibi farklı biçimlerde gönderilebilir.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "user-groups", ":id", "members" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "32", "key": "id", "disabled": false, "description": { "content": "(Required) Müşteri grubu listesinde dönen grup id değeri.", "type": "text/plain" } } ], "raw": "{{baseUrl}}/waas/integration/user-groups/:id/members" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"type\": \"tap_card\",\n \"values\": [\n \"1A2B3C4D\",\n \"5E6F7G8H\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "403cfc2a-ef05-d6ce-2ffd-f01730d06e47" }, { "id": "dd209c0c-21bb-825f-be16-00b007cea493", "name": "iFrame ile Kullanım", "request": { "name": "iFrame ile Kullanım", "description": { "content": "- Mobil uygulamanızda belirttiğiniz kullanıcı ile cüzdan uygulamasını açmak için kullanılır.\n- Servis başarılı bir şekilde çağrıldıktan sonra, üretilen url **3 gün** süre ile geçerli olacaktır.\n- Bu sebepten üretilen url için backend servisinizde 3 gün kontrolü yapabilir ve 3 gün süre geçmeden yeni link alınabilir.", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "open-iframe" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/open-iframe" }, "header": [ { "disabled": false, "description": { "content": "(Required) Waas platform bilgisi. Geçerli değerler: mobile_waas, web_waas", "type": "text/plain" }, "key": "X-Waas-Platform", "value": "mobile_waas" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"user_mapping_id\": \"8b5ac43a-20ce-4987-a739-d8a7ee480eaa\",\n \"locale\": \"tr\",\n \"redirect_page\": \"home\",\n \"redirect_data\": {\n \"amount\": 10,\n \"qr_content\": \"123456\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "13be2dec-9861-4111-5a86-80f1e7e651e0", "name": "Token Kontrolü", "request": { "name": "Token Kontrolü", "description": { "content": "- [Iframe ile Kullanım](/waas/waas-open-iframe) isteği cevabında verilen \"token\", ilgili kullanıcıya tanımlanmış ve belirli sürelidir.\n- Bu servis ile token'ın hangi kullanıcıya ait olduğu, geçerliliği veya kalan süresini kontrol etmek için kullanılabilir.", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "tokens", "check", ":token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "eyJpdiI6Imx0QW10cjc1T01aOVh0UURzQzRYaUE9PSIsInZhbHVlIjoiUldiYzN4QlFNZzhjdnpzVElHeXVHVUgxOWlHMm44a1R5TmY0bzBFSGV6SGFGelR4ck93aXRmRzRXRGplcFZxbEM5R1BHaHlUWWNqcktPTTJDTTZrS1Z6N0NGVVp3S2pHL05DV04xTVZBRkptZE9LOVhkL0MzR2drT1VaOUlVSWwiLCJtYWMiOiI5NGJlMDlmYmExNTA1NjY2MjAzYTg2MzIzMjI5ZjFiNGU1ZTI4YjQxZTBhOTM4OTkwMTFhM2RiYWQ4MjQwZjI3IiwidGFnIjoiIn0=", "key": "token", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ], "raw": "{{baseUrl}}/waas/integration/tokens/check/:token" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "926ba6e5-372f-fb6a-5914-0e7dc06756ba", "name": "Ödeme Kontrolü", "request": { "name": "Ödeme Kontrolü", "description": { "content": "- Sepet veya ödeme aşamalarında cüzdan ile ödeme seçeneğinde kullanabileceğiniz servistir.\nBu servis ile kullanıcının bakiyesi ve puan bilgisi alınıp ödemeyi puan ile yapıp yapamayacağı bilgisi alınır.\nEğer ilgili kullanıcının ödeme için yeterli bakiyesi yoksa cüzdan\nuygulamasına yönlendirip ödemeye hazır hale getirilmesi gerekmektedir.\n\n- Macellan SuperApp cüzdan uygulamasında kullanıcı, ödeme için eksik olan tutarı başarıyla yüklediğinde,\nuygulamamız [postMessage](https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage) kullanarak\n`{success: true, event: 'COMPLETE_DEPOSIT'}`\nmesajını gönderir. Bu mesaj, ödemenin hazır olduğunu belirtir ve sizin tarafınızdan yakalanması gerekmektedir.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "payments", "pre-check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/payments/pre-check" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"user_mapping_id\": \"8b5ac43a-20ce-4987-a739-d8a7ee480eaa\",\n \"price\": 10,\n \"round_up_deposit\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "27d9fff5-bd10-d7c8-1a22-93bf2f1d7c29", "name": "Ödeme Servisi", "request": { "name": "Ödeme Servisi", "description": { "content": "- Ödeme aşamasında kullanıcının cüzdanından belirtilen tutar kadar harcama yapma işlemi için kullanılır.\n\n- [Ödeme Kontrolü](/waas/waas-payment-pre-check) isteğinden sonra çalıştırılması gerekmektedir.\n\n- Ödeme servisi, 2 farklı şekilde kullanılabilir. Puan tutarının manuel belirlenmesi veya kullanıcıya puan kullanma seçeneğinin seçtirilmesi\n - **Puan Kullanımının Kullanıcı Tarafından Seçtirilmesi(point_usage kullanımı):** İstekte opsiyonel olarak istenen `point_usage` parametresi kullanıldığında,\nkullanıcı cüzdanındaki puan tutarı önceliklendirilerek, harcama tutarı kadar kullandırılmaya çalışılır.\nÖrn. 100 liralık harcama isteğinde, kullanıcının 500 Bakiye, 200 Puan olduğunu düşünürsek, `point_usage` parametresi `true` gönderdildiğinde harcama,\nkullanıcının puan tutarından düşürülerek gerçekleştirilir. Ödeme işlemi sonrası kullanıcının cüzdanı 500 Bakiye, 100 Puan olarak güncellenir.\n - **Puan Tutarının Manuel Belirlenmesi(point kullanımı):** Harcamada kullanıcının cüzdanından düşülecek puanın sizin tarafınızdan belirlenmesidir. \nİstekte opsiyonel olarak istenen `point` değeri kadar kullanıcı cüzdanından harcama yapılmaya çalışılır.\nÖrn. 100 liralık harcama isteğinde, price: 70, point: 30 gönderildiğinde kullanıcı cüzdanından 70 bakiye ve 30 puan ile harcama yapılmaya çalışılacaktır.\nBu yöntem ile harcama isteği yapıldığında, `price` ve `point` değerlerini kullanıcı cüzdan tutarına göre sizin hesaplamanız gerekmektedir.\n([Ödeme Kontrolü](/waas/waas-payment-pre-check) isteğinde kullanıcı cüzdan bilgileri verilmektedir.)\nBu yöntem kullanıldığında `point_usage` parametresi gönderilse bile dikkate alınmayacaktır.\n\n### Extra Bilgiler\n:::note\n- `external_id` alanı opsiyoneldir. Genellikle ödemeye ait sipariş numarası gibi harici sistem ID'si burada gönderilir; işlemleri kolayca takip etmenize yardımcı olur.\n:::\n\n### Ürün Listesi\n`product_list` alanı opsiyoneldir ve satın alınan ürünlerin detaylarını bu alanda gönderebilirsiniz. Bu bilgiler\nraporlama ve analiz amaçlı kullanılır.\n\n:::note\nÜrün listesi gönderildiğinde:\n* Her ürün için `price` ve `quantity` alanları birlikte zorunludur\n* Her ürünün `total_price` değeri, `price * quantity` ile eşleşmelidir\n* Tüm ürünlerin `total_price` toplamı, ödeme tutarı `price + point` ile eşleşmelidir\n:::\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "payments", "make" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/payments/make" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"user_mapping_id\": \"8b5ac43a-20ce-4987-a739-d8a7ee480eaa\",\n \"price\": 10,\n \"point_usage\": false,\n \"point\": 1,\n \"external_id\": \"EXT-12345\",\n \"apply_campaigns\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "48eca073-afe4-59b7-3622-6b76014dfe3e", "name": "Ödeme Detay Güncelleme", "request": { "name": "Ödeme Detay Güncelleme", "description": { "content": "- Ödeme işlemi tamamlandıktan sonra ödeme detaylarını güncellemek için kullanılır.\n\n- Bu servis ile ödeme işlemine ait ek bilgiler external_id, product_list ve extra gibi detaylar güncellenebilir.\n\n### Extra Bilgiler\n:::note\n- `external_id` alanı opsiyoneldir. Genellikle ödemeye ait sipariş numarası gibi harici sistem ID'si burada gönderilir; işlemleri kolayca takip etmenize yardımcı olur.\n- `extra` alanı opsiyoneldir ve ödeme işlemine ait ek bilgileri bu alanda gönderebilirsiniz.\n- `product_list` alanı opsiyoneldir ve satın alınan ürünlerin detaylarını bu alanda gönderebilirsiniz.\n:::\n\n### Ürün Listesi\n`product_list` alanı opsiyoneldir ve satın alınan ürünlerin detaylarını bu alanda gönderebilirsiniz. Bu bilgiler\nraporlama ve analiz amaçlı kullanılır.\n\n:::note\nÜrün listesi gönderildiğinde:\n* Her ürün için `price` ve `quantity` alanları birlikte zorunludur\n* Her ürünün `total_price` değeri, `price * quantity` ile eşleşmelidir\n* Tüm ürünlerin `total_price` toplamı, ödeme tutarı `price + point` ile eşleşmelidir\n:::\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "payments", "update", "detail" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/payments/update/detail" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"order_id\": 1131347753,\n \"external_id\": \"EXT-12345\",\n \"extra\": {\n \"note\": \"Özel not\",\n \"source\": \"mobile_app\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "045923c9-ad25-6dd3-74e3-98d87c2990da", "name": "Ödeme İade Servisi", "request": { "name": "Ödeme İade Servisi", "description": { "content": "- Ödeme yapıldıktan sonra istenilen tutarda iade işlemi yapmak için kullanılır.\n\n- [Ödeme Servisi](/waas/waas-payment-make) isteğinden dönen order_id değeri ile işlem gerçekleştirebilir.\n\n- İade edilmek istenen tutar en fazla ödeme tutarı + ödeme puan tutarı olabilir.\n\n\n### Ürün Listesi\n`product_list` alanı opsiyoneldir ve satın alınan ürünlerin detaylarını bu alanda gönderebilirsiniz. Bu bilgiler\nraporlama ve analiz amaçlı kullanılır.\n\n:::note\nÜrün listesi gönderildiğinde:\n* Her ürün için `price` ve `quantity` alanları birlikte zorunludur\n* Her ürünün `total_price` değeri, `price * quantity` ile eşleşmelidir\n* Tüm ürünlerin `total_price` toplamı, ödeme tutarı `price + point` ile eşleşmelidir\n:::\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "payments", "refunds", "direct" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/payments/refunds/direct" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": 1.23,\n \"order_id\": 1131347753,\n \"comment\": \"Test\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "UserUpdate", "description": "", "item": [ { "id": "4cf2b0c7-e535-f008-7fdb-04abdb8a11d6", "name": "Kullanıcı Bilgileri", "request": { "name": "Kullanıcı Bilgileri", "description": { "content": "- Bu servis ile cüzdan uygulaması eşlemesi yapılan kullanıcılarınızın bilgilerini güncelleyebilirsiniz.\n\n- Sisteminizde kayıtlı kullanıcının email, ad soyad gibi bilgileri değiştiğinde bu servis çalıştırılmalıdır.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/users" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"user_mapping_id\": \"8b5ac43a-20ce-4987-a739-d8a7ee480eaa\",\n \"email\": \"dev@macellan.app\",\n \"locale\": \"tr\",\n \"first_name\": \"Macellan\",\n \"last_name\": \"Superapp\",\n \"details\": {\n \"id_number\": \"111111111111\",\n \"birth_date\": \"2000-12-20\",\n \"subscribe_sms\": false,\n \"subscribe_email\": false\n },\n \"verifies\": {\n \"email\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "55d4e9d4-c527-ea55-785d-a540c1d7fb9f" }, { "id": "0d339ea5-b12c-c7c2-b1ab-02f0d80c445a", "name": "Oluştur", "request": { "name": "Oluştur", "description": { "content": "- Bu servis, [OTP](/otp/otp-send) işleminden sonra kullanıcıyı oluşturup cüzdan hesabının açılması için kullanılır.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "users", "register" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/users/register" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\",\n \"first_name\": \"Macellan\",\n \"last_name\": \"Superapp\",\n \"phone\": \"+905231113344\",\n \"verify_id\": 1,\n \"locale\": \"tr\",\n \"subscribe_sms\": false,\n \"subscribe_email\": false,\n \"id_number\": \"11111111111\",\n \"gender\": \"male\",\n \"birth_date\": \"2000-12-20\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4adc6e33-cd7d-0d45-6f1d-7c5af36c2304", "name": "Linkleme", "request": { "name": "Linkleme", "description": { "content": "- 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. [OTP](/otp/otp-send) işleminden sonra çağrılmalıdır.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "users", "register", "link-existing-user" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/users/register/link-existing-user" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"+905231113344\",\n \"verify_id\": 1\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3ad635a4-583d-c90c-43d9-e410f9a89d22", "name": "Detay", "request": { "name": "Detay", "description": { "content": "- Bu servis ile cüzdan uygulaması eşlemesi yapılan kullanıcılarınızın cüzdan bilgilerini görüntüleyebilirsiniz.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "wallets", ":userMappingId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "8b5ac43a-20ce-4987-a739-d8a7ee480eaa", "key": "userMappingId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ], "raw": "{{baseUrl}}/waas/integration/wallets/:userMappingId" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "427628e4-bcf9-4315-d750-9902feb297d8", "name": "Detay (Toplu)", "request": { "name": "Detay (Toplu)", "description": { "content": "- Bu servis ile birden fazla kullanıcınızın cüzdan bilgilerini tek istekte toplu olarak görüntüleyebilirsiniz.\n- Tek istekte en fazla **50** adet linkleme id gönderebilirsiniz.\n- Yanıt, anahtarları gönderdiğiniz linkleme id (`user_mapping_id`) değerleri olan bir nesne olarak döner.\n- Şirketinize ait olmayan veya bulunamayan linkleme id'ler yanıtta yer almaz.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "wallets", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/wallets/bulk" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"user_mapping_ids\": [\n \"8b5ac43a-20ce-4987-a739-d8a7ee480eaa\",\n \"9c6bd54b-31df-5098-b840-e9b8ff591fbb\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5309102c-7445-e6c7-0739-8d6ab6a92e98", "name": "İşlem Geçmişi", "request": { "name": "İşlem Geçmişi", "description": { "content": "- Bu servis ile cüzdan kullanıcılarınızın işlem geçmişini görüntüleyebilirsiniz.\n\n### Enum Değerleri Ve Açıklamaları\n\n#### `type` (İşlem Tipi)\n\n| Enum Değeri | Açıklama |\n|-------------------------|------------------------------|\n| `top-up` | Bakiye Yükleme |\n| `capture` | Bakiye Harcama |\n| `payment_refund` | Harcama İadesi |\n| `deposit_refund` | Yükleme İadesi |\n| `cash_deposit_refund` | Nakit Yükleme İadesi |\n\n
\n\n#### `description` (Bakiye Açıklama)\n\n| Enum Değeri | Açıklama |\n|---------------------------|------------------------------------|\n| `bkm` | BKM |\n| `masterpass` | Masterpass |\n| `masterpass_dp` | Masterpass DP |\n| `paycell` | Paycell |\n| `cash` | Nakit |\n| `turkcell_dcb` | Turkcell DCB |\n| `united_payment` | United Payment |\n| `united_payment_dp` | United Payment DP |\n| `eftpos` | ÖKC (Ödeme Kaydedici) |\n| `static_qr` | Statik QR |\n| `tag_qr` | Etiket QR |\n| `tap_card` | Temassız Kart |\n| `terminal` | Terminal |\n| `kerzz_pos` | Kerzz POS |\n| `simpra_pos` | Simpra POS |\n| `gizmo` | Gizmo |\n| `iap` | IAP (In-App Purchase) |\n| `soft_play` | Soft Play |\n| `soft_play_time_extension`| Soft Play Süre Uzatma |\n| `waas` | Waas |\n| `balance_burn` | Bakiye Yakma |\n| `order` | Sipariş |\n| `box_office` | Gişe |\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "wallets", ":userMappingId", "balance-histories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "İşlem tipi filtresi", "type": "text/plain" }, "key": "balance_filters[]", "value": "top-up" }, { "disabled": false, "description": { "content": "Bakiye açıklama filtresi", "type": "text/plain" }, "key": "description_filters", "value": "bkm" }, { "disabled": false, "description": { "content": "Bakiye açıklama filtresi", "type": "text/plain" }, "key": "description_filters", "value": "masterpass" }, { "disabled": false, "description": { "content": "Filtrelemek istenen başlangıç tarihi.", "type": "text/plain" }, "key": "start_date", "value": "2026-01-01T00:00:00Z" }, { "disabled": false, "description": { "content": "Filtrelemek istenen bitiş tarihi.", "type": "text/plain" }, "key": "end_date", "value": "2026-01-31T23:59:59Z" }, { "disabled": false, "description": { "content": "Listelenmek istenen sayfa numarası.", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [ { "type": "any", "value": "8b5ac43a-20ce-4987-a739-d8a7ee480eaa", "key": "userMappingId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ], "raw": "{{baseUrl}}/waas/integration/wallets/:userMappingId/balance-histories?balance_filters[]=top-up&description_filters=bkm&description_filters=masterpass&start_date=2026-01-01T00:00:00Z&end_date=2026-01-31T23:59:59Z&page=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "be2975d6-2b4f-74d4-2a75-19919218fec1", "name": "Puan Geçmişi", "request": { "name": "Puan Geçmişi", "description": { "content": "- Bu servis ile şirketinize ait tüm cüzdan kullanıcılarının puan geçmişini görüntüleyebilirsiniz.\n\n- Tarih filtreleri ile belirli bir dönemdeki tüm kullanıcıların puan geçmişi listelenir.\n\n### Enum Değerleri Ve Açıklamaları\n\n#### `point_type` (Puan Tipi)\n\n| Enum Değeri | Açıklama |\n|-------------------------------------|---------------------------------|\n| `coupon` | Kupon |\n| `user_coupon` | Kullanıcı Kuponu |\n| `campaign` | Kampanya |\n| `payment_discount` | Harcamaya İndirim |\n| `receivable` | Alacak |\n| `gift_card` | Hediye Kartı |\n| `amusement_event` | Eğlence Parkı Etkinliği |\n| `box_office_predefined_deposit` | Gişe Öntanımlı Yükleme |\n| `refund` | İade |\n| `automated_load` | Otomatik Yükleme |\n| `manual` | Manuel |\n| `external_point_definition` | Harici Puan Tanımlaması |\n\n
\n\n#### `point_history_type` (İşlem Tipi)\n\n| Enum Değeri | Açıklama |\n|-----------------|------------------|\n| `usage` | Harcama |\n| `load` | Kazanma |\n| `expire` | Süresi Doldu |\n| `revoke` | İptal |\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "points", "histories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filtrelemek istenen başlangıç tarihi.", "type": "text/plain" }, "key": "start_date", "value": "2026-01-01" }, { "disabled": false, "description": { "content": "Filtrelemek istenen bitiş tarihi.", "type": "text/plain" }, "key": "end_date", "value": "2026-01-31" }, { "disabled": false, "description": { "content": "Listelenmek istenen sayfa numarası.", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [], "raw": "{{baseUrl}}/waas/integration/points/histories?start_date=2026-01-01&end_date=2026-01-31&page=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0dfd29f9-502f-c656-0529-fd6512cd6b4d", "name": "Puan Özeti", "request": { "name": "Puan Özeti", "description": { "content": "- Bu servis ile cüzdan kullanıcılarınızın toplam puan değerlerini görüntüleyebilirsiniz.\n\n- Kullanıcının tüm puan toplarını (amount, balance, spent, expired, revoked) döner.\n\n### Response Alanları\n\n| Alan | Açıklama |\n|-----------------|-------------------------------------------------|\n| `total_amount` | Toplam kazanılan puan tutarı |\n| `total_balance` | Toplam kullanılabilir puan tutarı |\n| `total_spent` | Toplam harcanan puan tutarı |\n| `total_expired` | Toplam süresi dolmuş puan tutarı |\n| `total_revoked` | Toplam iptal edilen puan tutarı |\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "wallets", ":userMappingId", "point-summary" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "8b5ac43a-20ce-4987-a739-d8a7ee480eaa", "key": "userMappingId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ], "raw": "{{baseUrl}}/waas/integration/wallets/:userMappingId/point-summary" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6d796d03-bc01-2b3e-a89b-a939b3405077", "name": "Zamanlanmış Puanlar", "request": { "name": "Zamanlanmış Puanlar", "description": { "content": "- Bu servis ile cüzdan kullanıcılarınıza ait zamanlanmış puan tanımlamalarını listeleyebilirsiniz.\n\n- Opsiyonel tarih filtreleri ile belirli bir dönemdeki zamanlanmış puanlar `grant_date` alanına göre filtrelenir.\n\n- Tarih filtreleri birlikte gönderilmelidir. Sadece `start_date` veya sadece `end_date` gönderilemez.\n\n### Enum Değerleri Ve Açıklamaları\n\n#### `status` (Durum)\n\n| Enum Değeri | Açıklama |\n|---------------|------------------|\n| `waiting` | Beklemede |\n| `processed` | İşlendi |\n| `expired` | Süresi Doldu |\n| `cancelled` | İptal Edildi |\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "wallets", ":userMappingId", "scheduled-points" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filtrelemek istenen başlangıç tarihi.", "type": "text/plain" }, "key": "start_date", "value": "2026-01-01" }, { "disabled": false, "description": { "content": "Filtrelemek istenen bitiş tarihi.", "type": "text/plain" }, "key": "end_date", "value": "2026-01-31" }, { "disabled": false, "description": { "content": "Listelenmek istenen sayfa numarası.", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [ { "type": "any", "value": "8b5ac43a-20ce-4987-a739-d8a7ee480eaa", "key": "userMappingId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ], "raw": "{{baseUrl}}/waas/integration/wallets/:userMappingId/scheduled-points?start_date=2026-01-01&end_date=2026-01-31&page=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "be2975d6-2b4f-74d4-2a75-19919218fec1", "name": "Puan Geçmişi", "request": { "name": "Puan Geçmişi", "description": { "content": "- Bu servis ile cüzdan kullanıcınıza ait puan geçmişini listeleyebilirsiniz.\n\n- Opsiyonel tarih filtreleri ile belirli bir dönemdeki puan geçmişi `created_at` alanına göre filtrelenir.\n\n- Tarih filtreleri birlikte gönderilmelidir. Sadece `start_date` veya sadece `end_date` gönderilemez.\n\n### Enum Değerleri Ve Açıklamaları\n\n#### `point_type` (Puan Tipi)\n\n| Enum Değeri | Açıklama |\n|-------------------------------------|---------------------------------|\n| `coupon` | Kupon |\n| `user_coupon` | Kullanıcı Kuponu |\n| `campaign` | Kampanya |\n| `payment_discount` | Harcamaya İndirim |\n| `receivable` | Alacak |\n| `gift_card` | Hediye Kartı |\n| `amusement_event` | Eğlence Parkı Etkinliği |\n| `box_office_predefined_deposit` | Gişe Öntanımlı Yükleme |\n| `refund` | İade |\n| `automated_load` | Otomatik Yükleme |\n| `manual` | Manuel |\n| `external_point_definition` | Harici Puan Tanımlaması |\n\n
\n\n#### `point_history_type` (İşlem Tipi)\n\n| Enum Değeri | Açıklama |\n|-----------------|------------------|\n| `usage` | Harcama |\n| `load` | Kazanma |\n| `expire` | Süresi Doldu |\n| `revoke` | İptal |\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "wallets", ":userMappingId", "point-histories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filtrelemek istenen başlangıç tarihi.", "type": "text/plain" }, "key": "start_date", "value": "2026-01-01" }, { "disabled": false, "description": { "content": "Filtrelemek istenen bitiş tarihi.", "type": "text/plain" }, "key": "end_date", "value": "2026-01-31" }, { "disabled": false, "description": { "content": "Listelenmek istenen sayfa numarası.", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [ { "type": "any", "value": "8b5ac43a-20ce-4987-a739-d8a7ee480eaa", "key": "userMappingId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ], "raw": "{{baseUrl}}/waas/integration/wallets/:userMappingId/point-histories?start_date=2026-01-01&end_date=2026-01-31&page=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8a05e640-8836-5716-5042-e37790531b50", "name": "Sözleşme", "request": { "name": "Sözleşme", "description": { "content": "- Bu servis ile Macellan SuperApp panelinden hazırlanan cüzdan sözleşme bilgilerini alabilirsiniz.\n\n- Kullanıcı kayıt aşamasında cüzdan sözleşmenizin onaylatılması gerekmektedir.\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "wallets", "agreement" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/wallets/agreement" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "14d1ef89-d405-2cf2-db5c-d4c1a820a5d0", "name": "Zamanlanmış Puan Listesi", "request": { "name": "Zamanlanmış Puan Listesi", "description": { "content": "- Bu servis ile şirketinize ait tüm zamanlanmış puan tanımlamalarını listeleyebilirsiniz.\n\n- Tarih filtreleri ile belirli bir dönemdeki zamanlanmış puanlar `grant_date` alanına göre filtrelenir.\n\n### Enum Değerleri Ve Açıklamaları\n\n#### `status` (Durum)\n\n| Enum Değeri | Açıklama |\n|---------------|------------------|\n| `waiting` | Beklemede |\n| `processed` | İşlendi |\n| `expired` | Süresi Doldu |\n| `cancelled` | İptal Edildi |\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "points", "scheduled-points", "list" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Filtrelemek istenen başlangıç tarihi.", "type": "text/plain" }, "key": "start_date", "value": "2026-01-01" }, { "disabled": false, "description": { "content": "(Required) Filtrelemek istenen bitiş tarihi.", "type": "text/plain" }, "key": "end_date", "value": "2026-01-31" }, { "disabled": false, "description": { "content": "Listelenmek istenen sayfa numarası.", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [], "raw": "{{baseUrl}}/waas/integration/points/scheduled-points/list?start_date=2026-01-01&end_date=2026-01-31&page=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "30203e5a-2e22-b7f1-6a02-bcb155244f3f", "name": "Toplu Oluşturma", "request": { "name": "Toplu Oluşturma", "description": { "content": "- Bu servis ile kullanıcılarınıza zamanlanmış puan tanımlamaları toplu olarak oluşturabilirsiniz.\n\n- Maksimum 50 adet zamanlanmış puan tanımlaması gönderilebilir.\n\n- İstek içerisindeki her bir zamanlanmış puan tanımlaması için aşağıdaki kontroller yapılır:\n - `user_mapping_id` değerinin geçerliliği kontrol edilir\n - `external_id` değerinin daha önce kullanılmamış olması kontrol edilir\n\n- Geçersiz `user_mapping_id` değerleri için işlem yapılmaz ve `failed_user_mapping_ids` içinde döner.\n\n- Daha önce kullanılmış `external_id` değerleri için işlem yapılmaz ve `failed_external_ids` içinde döner.\n\n- Geçerli `user_mapping_id` ve benzersiz `external_id` değerleri için işlem asenkron olarak gerçekleştirilir.\n\n- Response içerisinde:\n - `queued_user_mapping_ids`: Kuyruğa alınan kullanıcı mapping id'leri\n - `queued_external_ids`: Kuyruğa alınan external id'leri\n - `failed_user_mapping_ids`: Geçersiz kullanıcı mapping id'leri\n - `failed_external_ids`: Daha önce kullanılmış veya duplicate olan external id'leri\n\n### Önemli Notlar\n\n:::note\n- `grant_date` bugünden önce olamaz ve `expire_date`'den önce olmalıdır\n- `expire_date` bugünden sonra olmalıdır\n- `external_id` değeri benzersiz olmalıdır. Aynı `external_id` ile daha önce oluşturulmuş bir zamanlanmış puan tanımlaması varsa, bu istek reddedilir\n:::\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "points", "scheduled-points", "create-bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/points/scheduled-points/create-bulk" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"scheduled_points\": [\n {\n \"user_mapping_id\": \"8b5ac43a-20ce-4987-a739-d8a7ee480eaa\",\n \"expire_date\": \"2025-12-31\",\n \"grant_date\": \"2025-01-15\",\n \"amount\": 100,\n \"name\": \"Özel kampanya puanı\",\n \"external_id\": \"EXT-12345\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "dfc1d451-1e98-89bd-62cc-15eb9f26d18d", "name": "Güncelleme", "request": { "name": "Güncelleme", "description": { "content": "- Bu servis ile daha önce oluşturulmuş zamanlanmış puan tanımlamasını güncelleyebilirsiniz.\n\n- Sadece gönderilen alanlar güncellenir, gönderilmeyen alanlar değişmez.\n\n- `amount` değeri ile zamanlanmış puan tutarı eksiltilebilir:\n - **Negatif değer:** Mevcut puan tutarından çıkarılır. Sonuç 0'a ulaşırsa zamanlanmış puan iptal edilir.\n - Çıkarılmak istenen tutar mevcut tutardan fazla olamaz.\n\n### Önemli Notlar\n\n:::note\n- `grant_date` bugünden önce olamaz ve `expire_date`'den önce olmalıdır\n- `expire_date` bugünden sonra olmalıdır\n- `external_id` ile zamanlanmış puan bulunur\n- Zamanlanmış puan sadece `WAITING` durumundayken güncellenebilir\n- `amount` sadece negatif değer veya 0 kabul eder, pozitif değer gönderilemez\n:::\n", "type": "text/plain" }, "url": { "path": [ "waas", "integration", "points", "scheduled-points", "update" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/waas/integration/points/scheduled-points/update" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"external_id\": \"EXT-12345\",\n \"amount\": -50,\n \"grant_date\": \"2025-01-20\",\n \"expire_date\": \"2025-12-31\",\n \"name\": \"Güncellenmiş kampanya puanı\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "59718fbc-d3e8-65dd-ffac-21d551a9b1af" }, { "name": "Webhook", "description": "Title\n\nContact Support:\n Email: altdev@macellan.net", "item": [ { "id": "8108b123-fd90-02c2-6bc0-b0d393f2d454", "name": "Webhook Çağrı Logları", "request": { "name": "Webhook Çağrı Logları", "description": { "content": "Bu endpoint, uygulamanıza gönderilen webhook çağrılarının geçmişini görüntüleyebilmeniz için sunulur. Hangi webhook olaylarının ne zaman tetiklendiğini, gönderilen verileri ve çağrının başarılı olup olmadığını inceleyebilir, entegrasyonlarınızı doğrulamak ve olası sorunları tespit etmek için kullanabilirsiniz.\n- Log kayıtları son 15 güne ait verileri kapsar. `start_date` parametresi en fazla 15 gün öncesine kadar olan tarihleri kabul eder.\n- `start_date` parametresi belirtilmediğinde, varsayılan olarak son 1 güne ait kayıtlar listelenir.\n- Bir webhook çağrısına ait tüm gönderim denemeleri aynı `uuid` ile kaydedilir. `uuid` parametresi ile filtreleme yaparak, ilgili webhook çağrısının kaç kez denendiğini ve her denemeye ait kayıtları görüntüleyebilirsiniz.", "type": "text/plain" }, "url": { "path": [ "integration", "webhook-logs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of deposit_success,deposit_refund,cash_deposit_success,cash_deposit_refund,payment_complete,payment_refund,point_history,waas_user_registered)", "type": "text/plain" }, "key": "event", "value": "deposit_success" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "start_date", "value": "2026-01-25 13:00:00" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "end_date", "value": "2026-01-25 23:59:59" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "uuid", "value": "b8dd8e93-d29b-4594-9a7d-d01d6bf89833" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [], "raw": "{{baseUrl}}/integration/webhook-logs?event=deposit_success&start_date=2026-01-25 13:00:00&end_date=2026-01-25 23:59:59&uuid=b8dd8e93-d29b-4594-9a7d-d01d6bf89833&page=1" }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "d29d395d-aef5-0a07-7ae6-9d8513eda711" }, { "name": "Event Log", "description": "Event Log işlemleri için API dokümantasyonu\n\nContact Support:\n Email: altdev@macellan.net", "item": [ { "id": "8f32000d-74ad-180d-8ade-fefbe2ace90b", "name": "Event Log Ekleme", "request": { "name": "Event Log Ekleme", "description": { "content": "Sistem event loglarını kaydetmek için kullanılır.", "type": "text/plain" }, "url": { "path": [ "integration", "event-log", "add" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [], "raw": "{{baseUrl}}/integration/event-log/add" }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"identity\": \"user123\",\n \"source\": \"kioks\",\n \"event\": \"card_read\",\n \"message\": \"Kart başarıyla okundu\",\n \"transaction_id\": \"TRX123456\",\n \"extra\": {\n \"card_no\": \"1234567890\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "id": "3d728ccc-bc51-cd51-1490-9d182513106c" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "event": [], "variable": [ { "key": "baseUrl", "value": "https://api.altpay.dev", "type": "string" }, { "key": "bearerToken", "value": "", "type": "string" } ] }