Geliştiriciler
Chargeless her iadeye ve iptale işletmenin yayımladığı politikayla karar verir ve işlemi ödeme sağlayıcısında yürütür. Bu rehberler, bir işletmenin kendi sistemlerini Chargeless'a bağlayan mühendisler içindir. Bir entegrasyon üç yoldan birini izler; çoğu ilk ikisini kullanır.
Sunucularınızdan Chargeless'ı çağırın
Chargeless API ile arka ucunuz bir müşteriyi doğrular, ödemelerine ve aboneliklerine bakar, politikanızın karar verdiği iadeleri ve iptalleri gönderir, kendi destek formunuzdan talepler iletir; politikayı, işlemleri, vakaları, iadeleri, itirazları ve dolandırıcılık uyarılarını okur. HTTPS üzerinden JSON'dur (Connect protokolü) ve bir API anahtarıyla kimlik doğrular: sr_live_… ya da yalnızca test modundaki ödeme hesaplarını bağlayan bir test çalışma alanından sr_test_….
- Chargeless API'si: Arka Ucunuz için: anahtarlar, hatalar, yeniden denemeler, sınırlar ve akışlar; curl, Node ve Go örnekleriyle.
- API Başvurusu: 20 prosedürün tümü, alanları ve birer örnek yanıtla.
Olanlardan haberdar olun
Webhook'lar, bir işlem yürütüldüğünde ya da başarısız olduğunda, bir vaka ekibinize devredildiğinde, bir talep değiştiğinde ya da bir isteğe karar verildiğinde sistemlerinize haber verir: yeniden denenen, imzalı HTTPS POST istekleri.
- Chargeless Webhook'larını Almak: events/v1: olaylar, gövdeler, imzalar ve yeniden denemeler.
Chargeless faturalama sisteminizi çağırsın
Müşterileriniz, ödemeleriniz ve abonelikleriniz kendi sisteminizde duruyorsa merchant-provider/v1 sözleşmesini sunarsınız: Chargeless'ın olguları okumak ve politikasının onayladığı iadeleri ve iptalleri yürütmek için çağırdığı küçük bir sözleşme. Aynı işlemleri ve kuralları taşıyan iki bağlaması vardır: REST uç noktaları ya da Streamable HTTP üzerinden MCP araçları. providercheck uyumluluk kiti, canlıya geçmeden önce ikisinden birini sandbox'ınıza karşı doğrular.
- Faturalama Sisteminizi Bir Öğleden Sonrada Bağlayın: buradan başlayın. Sırasıyla ne kuracağınız, her adımı nasıl test edeceğiniz ve nasıl canlıya geçeceğiniz.
- Kendi Faturalama Sisteminizi Bağlamak: merchant-provider/v1: sözleşme, imzalama, idempotency, sonuçlar, retler ve canlıya geçiş.
- Örneklerle REST Bağlantısı: her REST işlemi, istekle, başarı ve her hata için yanıtla, ağda göründüğü haliyle; Node ile yazılmış eksiksiz bir sunucuyla.
- MCP Bağlantısı: araçlar, ağda bir oturum ve Go ile yazılmış eksiksiz bir sunucu.
- providercheck: Uyumluluk Kiti: uyumluluk kitini indirin ve sandbox'ınıza karşı çalıştırın.
İtirazlarınızı kendi kayıtlarınızla destekleyin
Bir müşteri bir ödemeye itiraz ettiğinde Chargeless bankaya elindeki kanıtla yanıt verir. Kanıt servisiniz, merchant-evidence/v1, yalnızca sizin bildiklerinizi ekler: satın almanın nereden geldiğini, müşterinin neyi kabul ettiğini, neyi kullandığını ve neyi teslim aldığını. Ödeme sağlayıcınız hangisi olursa olsun, Chargeless'ın bir itirazın kanıtını hazırlarken sorduğu tek bir imzalı HTTPS uç noktasıdır. Yanıtınız kanıt olarak gönderilir ve hiçbir zaman saklanmaz.
- Kanıt Servisiniz: istek, alan alan yanıt, hangi iddiaya neyin yanıt verdiği ve Node ile yazılmış eksiksiz bir sunucu.
Neler var, neler yok
- Bir API anahtarı politikanın, güvenlik limitlerinin ve acil durdurmaların içinde kalarak çalışır. Panele oturum açamaz, politikayı yayımlayamaz; ayarları, ekibi ya da anahtarları değiştiremez; talepleri okuyamaz ve yanıtlayamaz.
- MCP bağlamasında MCP sunucusu sizin sisteminizdir, istemci Chargeless'tır. Chargeless, yapay zekâ asistanlarının bağlanacağı kendine ait bir MCP sunucusu çalıştırmaz ve araçlarınızı hiçbir zaman bir dil modeli çağırmaz: çağrılar, kaydedilmiş bir karardan sonra Chargeless'ın kendi kodundan gelir.
- Yayımlanmış bir istemci kütüphanesi yoktur. Aşağıdaki OpenAPI belgelerinden ya da Buf ile proto dosyalarından kendiniz üretin (API rehberine bakın).
İndirilenler
- backend-api-v1.yaml: Chargeless API (OpenAPI 3.1)
- merchant-provider-v1.yaml: merchant-provider/v1, REST bağlantısı (OpenAPI 3.1)
- merchant-provider-v1-contract.zip: merchant-provider/v1 sözleşmesi: OpenAPI, JSON Schema dosyaları, örnekler ve MCP profili
- providercheck: macOS, Linux ve Windows için uyumluluk kiti
- merchant-evidence-v1-contract.zip: merchant-evidence/v1 sözleşmesi: istek ve yanıtın JSON Schema dosyaları ve örnekleri
- merchant-decision-v1-contract.zip: merchant-decision/v1 sözleşmesi: istek ve yanıtın JSON Schema dosyaları, örnekleri ve imza vektörü
Chargeless'ı her gün kullanan ekipler için işletme kılavuzu /tr/docs adresindedir.