Demo langsung

Pembayaran untuk software travel

Integrasi API Paddle: kapan merchant of record cocok untuk bisnis travel

Paddle menjual software, SaaS, dan produk digital atas nama Anda sebagai merchant of record. Itu membuatnya cocok bagi perusahaan teknologi travel yang menagih langganannya sendiri, dan biasanya bukan alat yang tepat untuk menerima pembayaran penerbangan, hotel, dan tur. Halaman ini menjelaskan perbedaannya, cara kerja integrasi Paddle, dan cara menghubungkannya ke PHPTRAVELS bila kasus Anda sesuai.

  • Merchant of record, bukan gateway
  • Dibuat untuk software dan langganan
  • Webhook bertanda tangan
  • Dihubungkan sebagai integrasi kustom

Dua model berbeda

Merchant of record vs payment gateway

Payment gateway memindahkan uang untuk Anda: Anda adalah penjual, perusahaan pembayaran memproses kartu, sementara pajak, faktur, refund, dan sengketa tetap menjadi tanggung jawab Anda. Merchant of record melangkah lebih jauh dan menjadi penjual di mata pelanggan maupun otoritas pajak. Saat seseorang membeli lewat Paddle, Paddle yang menjual kepada mereka, memungut dan menyetorkan pajak penjualan atau PPN, menerbitkan faktur, menangani chargeback, lalu membayarkan bagian Anda.

Model ini menghemat banyak pekerjaan pajak dan kepatuhan bagi perusahaan software, tetapi juga berarti Paddle yang menentukan apa yang mau dijualnya. Platformnya dibuat untuk software, SaaS, dan produk digital, bukan layanan perjalanan yang disediakan maskapai, hotel, dan operator tur. Mekanisme umum pembayaran kartu dibahas di halaman API Payment Gateway.

Diagram alur pembayaran: pelanggan membayar online sementara tanggung jawab pembayaran, pajak, dan pencairan berpindah antara penjual dan penyedia pembayaran
PertanyaanPaddle (merchant of record)Payment gateway
Siapa penjualnya?Paddle adalah penjual resmi. Tanda terima dan tagihan kartu pelanggan berasal dari sisi Paddle dalam penjualan.Anda penjualnya. Gateway hanya memproses pembayaran di akun merchant Anda.
Siapa yang mengurus pajak penjualan dan PPN?Paddle menghitung, memungut, dan menyetorkan pajak penjualan serta PPN di tempat ia berjualan.Anda sendiri, lewat pendaftaran pajak, akuntan, dan penagihan Anda.
Siapa yang menerbitkan faktur?Paddle menerbitkan faktur atau tanda terima untuk pembeli.Sistem Anda sendiri yang menerbitkannya, misalnya faktur pemesanan di admin Anda.
Siapa yang menangani chargeback?Paddle menangani sengketa dan chargeback sebagai penjual.Anda menjawab sengketa dengan bukti lewat dasbor atau API gateway.
Apa yang bisa Anda jual?Software, SaaS, langganan, dan produk digital, sesuai aturan penggunaan yang dapat diterima Paddle.Penjualan barang dan jasa yang disetujui gateway, termasuk pemesanan perjalanan bagi banyak merchant travel.
Bagaimana Anda dibayar?Paddle mencairkan pendapatan Anda setelah dipotong biaya, sesuai jadwal pencairannya.Pembayaran yang ditangkap diselesaikan ke akun merchant atau rekening bank Anda, dikurangi biaya gateway.

Biaya, negara yang didukung, dan daftar pasti produk yang diizinkan ditetapkan Paddle dan berubah dari waktu ke waktu. Periksa ketentuan Paddle sebelum Anda mengandalkannya.

Panduan keputusan

Apakah Paddle cocok untuk yang Anda jual?

Mulai dari apa yang dibayar pelanggan. Pilih skenario yang paling dekat dengan bisnis Anda.

01

Pelancong membayar penerbangan, hotel, dan tur

Pelanggan membeli perjalanan yang dilayani maskapai, hotel, atau operator tur. Pembayaran seperti ini sering butuh otorisasi sekarang dan capture nanti, refund sebagian setelah biaya pembatalan, dan checkout multi-mata uang.

Pandangan kami

Gunakan payment gateway

Periksa aturan penggunaan yang dapat diterima Paddle sebelum memakainya untuk pemesanan perjalanan. Kebanyakan bisnis travel menerima pembayaran pemesanan lewat payment gateway seperti Stripe, PayPal, Adyen, atau gateway regional.

02

Anda menjual software travel atau SaaS sendiri

Anda vendor teknologi travel dan agen membayar langganan bulanan atau tahunan untuk alat pemesanan, akses API, plugin, atau portal white label Anda.

Pandangan kami

Paddle bisa cocok

Inilah jenis penjualan yang dibuat untuk merchant of record: Paddle menagih langganan, mengurus pajak di tiap negara, dan membayarkan hasilnya kepada Anda, sehingga Anda tidak perlu mendaftar PPN di semua negara tempat pelanggan Anda berada.

03

Anda menjual pemesanan sekaligus software

Agensi Anda menjalankan situs pemesanan untuk pelancong dan juga melisensikan platform atau alatnya kepada agensi lain.

Pandangan kami

Pakai keduanya, dipisahkan

Terima pembayaran pemesanan lewat gateway siap pakai dalam alur pemesanan, dan tagih langganan software lewat Paddle. Dua alur, dua set catatan, masing-masing dengan perlakuan pajak yang tepat.

Cara kerjanya

Cara kerja integrasi Paddle dari awal sampai akhir

Paddle Billing bekerja dengan produk dan harga yang Anda buat di Paddle, checkout yang dibuka oleh Paddle.js, dan webhook yang memberi tahu server Anda apa yang terjadi.

  1. 01

    Produk dan harga

    Anda membuat tiap paket sekali di Paddle, misalnya harga bulanan dan tahunan, lalu menyimpan ID harga di sistem Anda.

    pri_…

  2. 02

    Checkout Paddle.js

    Halaman Anda memuat Paddle.js dan membuka checkout sebagai overlay atau frame inline dengan ID harga dan referensi pelanggan Anda sendiri.

    Paddle.Checkout.open()

  3. 03

    Transaksi selesai

    Pembeli membayar, Paddle menagih kartu atau dompet, menerapkan pajak, dan membuat transaksi, serta langganan bila harganya berulang.

    txn_…

  4. 04

    Webhook bertanda tangan

    Paddle mengirim event seperti transaction.completed ke endpoint Anda, ditandatangani di header Paddle-Signature.

    transaction.completed

  5. 05

    Sistem Anda bertindak

    Server Anda memverifikasi tanda tangan, lalu mengaktifkan akun, memperpanjang paket, atau mencatat pembayaran.

    200 OK

Simpan kunci API hanya di server Anda. Browser memakai token sisi klien yang terpisah, dan lingkungan sandbox serta live masing-masing punya kunci, harga, dan secret webhook sendiri.

Keamanan webhook

Memeriksa header Paddle-Signature

Webhook bisa dipalsukan oleh siapa pun yang tahu URL endpoint Anda. Memverifikasi tanda tangan di setiap event membuat pengaktifan akun dari webhook menjadi aman.

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);

Contoh ilustrasi dalam PHP polos. Ikuti dokumentasi Paddle terbaru, atau SDK resminya, untuk format yang tepat.

  1. 01

    Gunakan body mentah

    Tanda tangan dihitung dari body request persis seperti yang diterima, jadi bacalah sebelum parsing JSON mengubahnya.

  2. 02

    Timestamp plus hash

    Header membawa timestamp dan hash HMAC-SHA256 yang dibuat dengan secret key endpoint Anda. Bangun ulang dan bandingkan dalam waktu konstan.

  3. 03

    Tolak event lama dan berulang

    Tolak event dengan timestamp yang terlalu lama dan simpan ID tiap event agar pengiriman berulang tidak diproses dua kali.

  4. 04

    Sandbox dulu

    Bangun dan uji di sandbox Paddle dengan kartu uji, lalu ganti kunci, harga, dan secret ke live.

PHPTRAVELS dan Paddle

Menghubungkan Paddle ke PHPTRAVELS

Jawaban jujur dulu, lalu pilihannya.

Paddle bukan konektor siap pakai

Paddle tidak ada dalam daftar payment gateway PHPTRAVELS dan belum punya panduan pengaturan yang dipublikasikan. Gateway siap pakai, yang ditampilkan di bawah, adalah yang dibuat untuk menerima pembayaran pemesanan.

Tanyakan integrasi kustomCoba demo pemesanan

  • Untuk pembayaran pemesanan: gateway siap pakai

    Aktifkan gateway siap pakai seperti Pembayaran Stripe atau Pembayaran PayPal di admin dengan akun merchant Anda sendiri. Checkout, refund, dan referensi pemesanan sudah terhubung ke alur pemesanan, seperti dijelaskan di halaman Integrasi payment gateway.

  • Untuk penjualan software: Paddle sebagai integrasi kustom

    Bila kasus Anda sesuai aturan Paddle, developer kami dapat menghubungkannya sebagai Integrasi API kustom: checkout Paddle.js di halaman Anda, endpoint webhook terverifikasi, dan pembayaran tercatat pada pelanggan Anda. Pekerjaan ini dibuatkan penawaran sebelum dimulai.

  • Atau bangun sendiri di atas source code

    PHPTRAVELS di-host sendiri dan disertai source code lengkap, jadi developer Anda dapat menambahkan Paddle untuk langganan di samping mesin pemesanan. Halaman Harga mencantumkan isi tiap lisensi.

Siap untuk pembayaran pemesanan

Payment gateway yang sudah terhubung ke PHPTRAVELS

Untuk pembayaran pelancong dan agen, gateway berikut sudah siap: Anda membuka akun di penyedia, memasukkan kunci di admin, menguji, lalu go live. Daftarnya adalah daftar langsung dari direktori integrasi kami.

Sub-agen juga dapat membayar dari saldo prabayar atau batas kredit lewat Dompet agen B2B, yang sama sekali tidak butuh gateway.

FAQ

Integrasi API Paddle: pertanyaan umum

Hubungi sales

Bukan sebagai konektor siap pakai. Paddle tidak ada dalam daftar payment gateway PHPTRAVELS. Jika kasus Anda sesuai aturan Paddle, misalnya menjual langganan software Anda sendiri, Paddle bisa ditambahkan sebagai integrasi kustom atau dibangun developer Anda di atas source code yang disertakan.

Paddle adalah merchant of record yang dibuat untuk software, SaaS, dan produk digital, jadi umumnya bukan alat untuk penerbangan, hotel, atau tur. Periksa aturan penggunaan yang dapat diterima Paddle sebelum memakainya untuk pemesanan perjalanan; kebanyakan bisnis travel menerima pembayaran pemesanan lewat payment gateway seperti Stripe, PayPal, Adyen, atau gateway regional.

Perusahaan yang secara hukum menjual kepada pelanggan. Ia bertanggung jawab memungut dan menyetorkan pajak penjualan atau PPN, menerbitkan faktur, menangani refund dan chargeback, serta tampil di tagihan pelanggan. Dengan Paddle, Paddle mengambil peran itu lalu membayarkan hasilnya kepada Anda.

Gateway memproses pembayaran untuk Anda sementara Anda tetap menjadi penjual dan menanggung urusan pajak serta sengketa. Paddle sendiri menjadi penjual, sehingga pekerjaan itu hilang untuk penjualan software, tetapi apa yang bisa Anda jual lewatnya menjadi terbatas.

Saat Anda menjual software sendiri, bukan perjalanan: alat pemesanan, API, plugin, atau portal white label yang dibayar agensi lewat langganan. Paddle lalu dapat menagih mereka dan mengurus pajak di tiap negara.

Paddle mengirim event seperti transaksi selesai atau langganan diperpanjang ke URL yang Anda daftarkan. Setiap request membawa header Paddle-Signature berisi timestamp dan hash, yang diperiksa server Anda dengan secret key endpoint sebelum bertindak.

Bisa. Paddle punya lingkungan sandbox terpisah dengan akun, kunci API, harga, dan kartu uji sendiri. Bangun dan uji di sana, lalu pindahkan konfigurasinya ke lingkungan live.

Bisa, sebagai dua alur terpisah: mesin pemesanan menerima pembayaran pelancong lewat gateway siap pakai, dan Paddle menagih langganan software Anda. Pisahkan catatannya agar tiap penjualan mendapat perlakuan pajak yang tepat.

Jelajahi lebih lanjut

Selengkapnya tentang platform