Canlı demo

Seyahat yazılımı için ödemeler

Paddle API entegrasyonu: merchant of record bir seyahat işletmesine ne zaman uyar

Paddle, merchant of record (kayıtlı satıcı) olarak yazılım, SaaS ve dijital ürünleri sizin adınıza satar. Bu yüzden kendi aboneliklerini faturalayan bir seyahat teknolojisi şirketi için güçlü bir seçenektir; uçak, otel ve tur ödemelerini tahsil etmek içinse genellikle yanlış araçtır. Bu sayfa farkı, bir Paddle entegrasyonunun nasıl çalıştığını ve kullanım senaryonuz uygunsa onu PHPTRAVELS'a nasıl bağlayacağınızı anlatır.

  • Geçit değil, merchant of record
  • Yazılım ve abonelikler için geliştirildi
  • İmzalı webhook'lar
  • Özel entegrasyon olarak bağlanır

İki farklı model

Merchant of record ve ödeme geçidi

Ödeme geçidi parayı sizin için taşır: satıcı sizsiniz, ödeme şirketi kartı işler; vergi, fatura, iade ve itiraz süreçleri ise sizin sorumluluğunuzda kalır. Merchant of record bir adım daha ileri gider ve müşterinin ve vergi dairelerinin gözünde satıcı olur. Biri Paddle üzerinden satın aldığında ona Paddle satar; satış vergisini veya KDV'yi tahsil edip öder, faturayı keser, geri ödeme taleplerini (chargeback) yürütür ve ardından payınızı size öder.

Bu model bir yazılım şirketini büyük bir vergi ve uyumluluk yükünden kurtarır, ama aynı zamanda neyi yeniden satmak istediğine Paddle'ın karar vermesi anlamına gelir. Platformu yazılım, SaaS ve dijital ürünler için kurulmuştur; havayollarının, otellerin ve tur operatörlerinin sunduğu seyahat hizmetleri için değil. Kartlı ödemelerin genel işleyişi Ödeme geçidi API sayfasında anlatılıyor.

Bir müşterinin çevrimiçi ödeme yaptığı ve ödeme, vergi ile hak ediş sorumluluklarının satıcı ile ödeme sağlayıcı arasında el değiştirdiği ödeme akışı şeması
SoruPaddle (merchant of record)Ödeme geçidi
Satıcı kim?Satıcı Paddle'dır. Müşterinin makbuzu ve kart ekstresi, satışın Paddle tarafından yapıldığını gösterir.Satıcı sizsiniz. Geçit yalnızca ödemeyi sizin üye iş yeri hesabınız üzerinden işler.
Satış vergisi ve KDV'yi kim yönetir?Paddle, sattığı yerlerde satış vergisini ve KDV'yi hesaplar, tahsil eder ve öder.Siz yönetirsiniz: kendi vergi kayıtlarınız, muhasebecinizi ve faturalamanız üzerinden.
Faturayı kim keser?Alıcıya faturayı veya makbuzu Paddle keser.Kendi sisteminiz keser, örneğin yönetim panelinizdeki rezervasyon faturası.
Chargeback'leri kim yönetir?Paddle, satıcı olarak itirazları ve chargeback'leri yürütür.İtirazları, geçidin panelinden veya API'sinden kanıtlarla siz yanıtlarsınız.
Ne satabilirsiniz?Paddle'ın kabul edilebilir kullanım kuralları çerçevesinde yazılım, SaaS, abonelik ve dijital ürünler.Geçidin onayladığı fiziksel ürün ve hizmet satışları; birçok seyahat işletmesi için seyahat rezervasyonları da dahil.
Ödemenizi nasıl alırsınız?Paddle, komisyonunu düştükten sonra kazancınızı kendi ödeme takvimine göre öder.Tahsil edilen ödemeler, geçit komisyonu düşülerek üye iş yeri veya banka hesabınıza yatar.

Komisyonlar, desteklenen ülkeler ve izin verilen ürünlerin tam listesi Paddle tarafından belirlenir ve zamanla değişir. Plan yapmadan önce Paddle'ın kendi şartlarına bakın.

Karar yardımcısı

Sattığınız ürün için Paddle doğru mu?

Müşterinin neye ödeme yaptığından yola çıkın. İşletmenize en yakın senaryoyu seçin.

01

Yolcular uçak, otel ve tur için ödeme yapıyor

Müşteri, bir havayolu, otel veya tur operatörünün gerçekleştireceği bir seyahati satın alıyor. Bu ödemelerde çoğu zaman önce provizyon alıp sonra tahsil etmek, iptal ücretlerinden sonra kısmi iade ve çok para birimli ödeme sayfası gerekir.

Görüşümüz

Ödeme geçidi kullanın

Seyahat rezervasyonları için Paddle'ı kullanmadan önce Paddle'ın kabul edilebilir kullanım kurallarına bakın. Çoğu seyahat işletmesi rezervasyon ödemelerini Stripe, PayPal, Adyen gibi bir ödeme geçidi ya da yerel bir geçit üzerinden alır.

02

Kendi seyahat yazılımınızı veya SaaS'ınızı satıyorsunuz

Bir seyahat teknolojisi sağlayıcısısınız ve acenteler rezervasyon aracınız, API erişiminiz, bir eklentiniz veya beyaz etiketli portalınız için size aylık ya da yıllık abonelik ödüyor.

Görüşümüz

Paddle uygun olabilir

Merchant of record tam olarak bu tür satış için geliştirilmiştir: Paddle aboneliği faturalar, her ülkedeki vergiyi halleder ve size ödeme yapar; böylece müşterilerinizin bulunduğu her yerde KDV kaydı yaptırmanız gerekmez.

03

Hem rezervasyon hem yazılım satıyorsunuz

Acenteniz yolculara yönelik bir rezervasyon sitesi işletiyor ve aynı zamanda platformunu veya araçlarını diğer acentelere lisanslıyor.

Görüşümüz

İkisini de kullanın, ama ayrı tutun

Rezervasyon ödemelerini rezervasyon akışında hazır bir geçitle alın, yazılım aboneliklerini ise Paddle ile faturalayın. İki akış, iki kayıt seti; her birinde doğru vergi uygulaması.

Nasıl çalışır

Bir Paddle entegrasyonu baştan sona nasıl çalışır

Paddle Billing, Paddle'da oluşturduğunuz ürün ve fiyatlarla, Paddle.js'in açtığı ödeme sayfasıyla ve sunucunuza olanları bildiren webhook'larla çalışır.

  1. 01

    Ürünler ve fiyatlar

    Her planı Paddle'da bir kez oluşturursunuz, örneğin aylık ve yıllık bir fiyat, ve fiyat kimliklerini kendi sisteminizde saklarsınız.

    pri_…

  2. 02

    Paddle.js ödeme sayfası

    Sayfanız Paddle.js'i yükler ve fiyat kimliği ile kendi müşteri referansınızla ödeme sayfasını bir katman ya da satır içi çerçeve olarak açar.

    Paddle.Checkout.open()

  3. 03

    İşlem tamamlandı

    Alıcı öder, Paddle kartı veya cüzdanı tahsil eder, vergiyi uygular ve bir işlem oluşturur; fiyat yinelenen türdeyse bir abonelik de oluşturur.

    txn_…

  4. 04

    İmzalı webhook

    Paddle, transaction.completed gibi bir olayı uç noktanıza gönderir ve Paddle-Signature başlığıyla imzalar.

    transaction.completed

  5. 05

    Sisteminiz harekete geçer

    Sunucunuz imzayı doğrular, ardından hesabı etkinleştirir, planı yeniler veya ödemeyi kaydeder.

    200 OK

API anahtarını yalnızca sunucunuzda tutun. Tarayıcı ayrı bir istemci tarafı belirteci kullanır; sandbox ve canlı ortamların her birinin kendi anahtarları, fiyatları ve webhook gizli anahtarları vardır.

Webhook güvenliği

Paddle-Signature başlığını doğrulama

Uç nokta URL'nizi bilen herkes bir webhook'u taklit edebilir. Her olayın imzasını doğrulamak, bir webhook'a dayanarak hesap etkinleştirmeyi güvenli hale getirir.

paddle-webhook.php
 1$raw    = file_get_contents("php://input"); 2$header = $_SERVER["HTTP_PADDLE_SIGNATURE"] ?? "";  // ts=…;h1=… 3parse_str(str_replace(";", "&", $header), $sig); 4 5$expected = hash_hmac("sha256", $sig["ts"] . ":" . $raw, $endpointSecret); 6if (!hash_equals($expected, $sig["h1"] ?? "")) { 7    http_response_code(400); exit;            // not from Paddle 8} 9if (time() - (int) $sig["ts"] > $tolerance) exit; // too old1011$event = json_decode($raw, true);12if (alreadyHandled($event["event_id"])) exit;      // repeat delivery13if ($event["event_type"] === "transaction.completed") {14    activatePlan($event["data"]["custom_data"]["account_id"]);15}16http_response_code(200);

Düz PHP ile yazılmış açıklayıcı bir örnektir. Kesin biçim için Paddle'ın güncel belgelerini veya resmi SDK'sını izleyin.

  1. 01

    Ham gövdeyi kullanın

    İmza, istek gövdesi alındığı haliyle hesaplanır; bu yüzden JSON ayrıştırma onu değiştirmeden önce okuyun.

  2. 02

    Zaman damgası ve karma

    Başlık bir zaman damgası ve uç noktanızın gizli anahtarıyla üretilmiş bir HMAC-SHA256 karması taşır. Onu yeniden oluşturun ve sabit zamanlı karşılaştırın.

  3. 03

    Eski ve tekrarlanan olayları reddedin

    Zaman damgası çok eski olan olayları reddedin ve her olay kimliğini saklayın; böylece tekrar gönderilen bir olay iki kez işlenmez.

  4. 04

    Önce sandbox

    Paddle'ın sandbox ortamında test kartlarıyla geliştirip test edin, sonra anahtarları, fiyatları ve gizli anahtarı canlıya geçirin.

PHPTRAVELS ve Paddle

Paddle'ı PHPTRAVELS'a bağlama

Önce dürüst bir cevap, sonra seçenekler.

Paddle hazır bir bağlayıcı değildir

Paddle, PHPTRAVELS ödeme geçidi listesinde yer almaz ve yayımlanmış bir kurulum rehberi yoktur. Aşağıda gösterilen hazır geçitler, rezervasyon ödemelerini almak için geliştirilmiş olanlardır.

Özel entegrasyonu sorunRezervasyon demosunu deneyin

  • Rezervasyon ödemeleri için: hazır bir geçit

    Kendi üye iş yeri hesabınızla yönetim panelinde Stripe ödemeleri veya PayPal ödemeleri gibi hazır bir geçidi etkinleştirin. Ödeme sayfası, iadeler ve rezervasyon referansı, Ödeme ağ geçidi entegrasyonu sayfasında anlatıldığı gibi rezervasyon akışına zaten bağlıdır.

  • Yazılım satışı için: özel entegrasyon olarak Paddle

    Kullanım senaryonuz Paddle'ın kurallarına uyuyorsa geliştiricilerimiz onu bir Özel API entegrasyonu olarak bağlayabilir: sayfanızda Paddle.js ödeme sayfası, doğrulamalı bir webhook uç noktası ve müşterilerinize bağlı kaydedilen ödemeler. İş başlamadan önce fiyat teklifi verilir.

  • Ya da kaynak kod üzerinde kendiniz geliştirin

    PHPTRAVELS kendi sunucunuzda çalışır ve tüm kaynak koduyla gelir; böylece kendi geliştiricileriniz rezervasyon motorunun yanına abonelikler için Paddle ekleyebilir. Her lisansın neleri içerdiğini Fiyatlandırma sayfası listeler.

Rezervasyon ödemelerine hazır

PHPTRAVELS'a zaten bağlı ödeme geçitleri

Yolcu ve acente ödemeleri için bu geçitler hazırdır: sağlayıcıda hesap açar, anahtarlarınızı yönetim paneline girer, test eder ve canlıya alırsınız. Liste, entegrasyon dizinimizdeki güncel listedir.

Alt acenteler, B2B acente cüzdanı üzerinden ön ödemeli bakiye veya kredi limitiyle de ödeme yapabilir; bunun için hiçbir geçit gerekmez.

SSS

Paddle API entegrasyonu: sık sorulan sorular

Satış ekibiyle görüşün

Hazır bir bağlayıcı olarak değil. Paddle, PHPTRAVELS ödeme geçidi listesinde yok. Kullanım senaryonuz Paddle'ın kurallarına uyuyorsa, örneğin kendi yazılım aboneliklerinizi satıyorsanız, özel entegrasyon olarak eklenebilir veya geliştiricileriniz tarafından pakete dahil kaynak kod üzerinde geliştirilebilir.

Paddle yazılım, SaaS ve dijital ürünler için kurulmuş bir merchant of record'dur; bu yüzden uçak, otel veya tur için genellikle doğru araç değildir. Seyahat rezervasyonları için kullanmadan önce Paddle'ın kabul edilebilir kullanım kurallarına bakın; çoğu seyahat işletmesi rezervasyon ödemelerini Stripe, PayPal, Adyen gibi bir ödeme geçidi ya da yerel bir geçit üzerinden alır.

Müşteriye yasal olarak satışı yapan şirkettir. Satış vergisi veya KDV'yi tahsil edip ödemekten, fatura kesmekten, iade ve chargeback'leri yönetmekten sorumludur ve müşterinin ekstresinde görünür. Paddle ile bu rolü Paddle üstlenir ve size ödeme yapar.

Geçit ödemeleri sizin için işler, satıcı sizsiniz ve vergi ile itiraz işleri de sizde kalır. Paddle ise satıcının kendisi olur; bu, yazılım satışlarında o işleri ortadan kaldırır ama üzerinden satabileceklerinizi sınırlar.

Seyahat değil kendi yazılımınızı sattığınızda: acentelerin abonelikle ödediği bir rezervasyon aracı, API, eklenti veya beyaz etiketli portal. O zaman Paddle onları faturalayabilir ve her ülkedeki vergiyi halledebilir.

Paddle, tamamlanan bir işlem veya yenilenen bir abonelik gibi olayları kaydettiğiniz bir URL'ye gönderir. Her istek, zaman damgası ve karma içeren bir Paddle-Signature başlığı taşır; sunucunuz harekete geçmeden önce bunu uç noktanın gizli anahtarıyla kontrol eder.

Evet. Paddle'ın kendi hesabı, API anahtarları, fiyatları ve test kartları olan ayrı bir sandbox ortamı vardır. Orada geliştirip test edin, sonra yapılandırmayı canlı ortama taşıyın.

Evet, iki ayrı akış olarak: rezervasyon motoru yolcu ödemelerini hazır bir geçitle alır, Paddle ise yazılım aboneliklerinizi faturalar. Her satışa doğru vergi uygulaması yapılabilmesi için kayıtlarını ayrı tutun.

Keşfetmeye devam edin

Platform hakkında daha fazlası