লাইভ ডেমো

ট্রাভেল সফটওয়্যারের পেমেন্ট

Paddle API ইন্টিগ্রেশন: ট্রাভেল ব্যবসায় কখন মার্চেন্ট অফ রেকর্ড মানায়

Paddle মার্চেন্ট অফ রেকর্ড হিসেবে আপনার হয়ে সফটওয়্যার, SaaS ও ডিজিটাল পণ্য বিক্রি করে। নিজের সাবস্ক্রিপশনের বিল করা ট্রাভেল টেকনোলজি কোম্পানির জন্য এটি জোরালো সমাধান, কিন্তু ফ্লাইট, হোটেল ও ট্যুরের টাকা নেওয়ার জন্য সাধারণত ভুল হাতিয়ার। এই পেজে পার্থক্য, Paddle ইন্টিগ্রেশন কীভাবে কাজ করে এবং আপনার ব্যবহার মিললে কীভাবে PHPTRAVELS-এর সঙ্গে জুড়বেন তা ব্যাখ্যা করা হয়েছে।

  • মার্চেন্ট অফ রেকর্ড, গেটওয়ে নয়
  • সফটওয়্যার ও সাবস্ক্রিপশনের জন্য তৈরি
  • সাইন করা ওয়েবহুক
  • কাস্টম ইন্টিগ্রেশন হিসেবে সংযুক্ত

দুটি আলাদা মডেল

মার্চেন্ট অফ রেকর্ড বনাম পেমেন্ট গেটওয়ে

পেমেন্ট গেটওয়ে আপনার হয়ে টাকা সরায়: বিক্রেতা আপনি, পেমেন্ট কোম্পানি কার্ড প্রসেস করে, আর কর, ইনভয়েস, রিফান্ড ও বিরোধ থাকে আপনার দায়িত্বেই। মার্চেন্ট অফ রেকর্ড আরও এক ধাপ এগিয়ে গ্রাহক ও কর কর্তৃপক্ষের চোখে নিজেই বিক্রেতা হয়ে যায়। কেউ Paddle-এর মাধ্যমে কিনলে Paddle তাকে বিক্রি করে, সেলস ট্যাক্স বা VAT সংগ্রহ করে জমা দেয়, ইনভয়েস দেয়, চার্জব্যাক সামলায় এবং তারপর আপনার অংশ পরিশোধ করে।

এই মডেল সফটওয়্যার কোম্পানির অনেক কর ও কমপ্লায়েন্সের কাজ বাঁচায়, কিন্তু তার মানে Paddle নিজেই ঠিক করে কী পুনরায় বিক্রি করবে। এর প্ল্যাটফর্ম সফটওয়্যার, SaaS ও ডিজিটাল পণ্যের জন্য তৈরি, এয়ারলাইন, হোটেল ও ট্যুর অপারেটরের দেওয়া ভ্রমণ সেবার জন্য নয়। কার্ড পেমেন্টের সাধারণ কার্যপদ্ধতি পেমেন্ট গেটওয়ে API পেজে আছে।

পেমেন্ট ফ্লো ডায়াগ্রাম: গ্রাহক অনলাইনে পেমেন্ট করছেন এবং পেমেন্ট, কর ও পরিশোধের দায়িত্ব বিক্রেতা ও পেমেন্ট প্রদানকারীর মধ্যে স্থানান্তরিত হচ্ছে
প্রশ্নPaddle (মার্চেন্ট অফ রেকর্ড)পেমেন্ট গেটওয়ে
বিক্রেতা কে?Paddle হলো রেকর্ডে থাকা বিক্রেতা। গ্রাহকের রসিদ ও কার্ড স্টেটমেন্ট আসে Paddle-এর পক্ষ থেকে।বিক্রেতা আপনি। গেটওয়ে শুধু আপনার মার্চেন্ট অ্যাকাউন্টে পেমেন্ট প্রসেস করে।
সেলস ট্যাক্স ও VAT কে সামলায়?Paddle যেসব জায়গায় বিক্রি করে সেখানে সেলস ট্যাক্স ও VAT হিসাব, সংগ্রহ ও জমা দেয়।আপনি, নিজের কর নিবন্ধন, অ্যাকাউন্ট্যান্ট ও ইনভয়েসিংয়ের মাধ্যমে।
ইনভয়েস কে দেয়?Paddle ক্রেতাকে ইনভয়েস বা রসিদ দেয়।আপনার নিজের সিস্টেম, যেমন অ্যাডমিনে বুকিং ইনভয়েস।
চার্জব্যাক কে সামলায়?Paddle বিক্রেতা হিসেবে বিরোধ ও চার্জব্যাক সামলায়।আপনি গেটওয়ের ড্যাশবোর্ড বা API-র মাধ্যমে প্রমাণসহ বিরোধের জবাব দেন।
আপনি কী বিক্রি করতে পারেন?সফটওয়্যার, SaaS, সাবস্ক্রিপশন ও ডিজিটাল পণ্য, Paddle-এর গ্রহণযোগ্য ব্যবহার নীতির মধ্যে।গেটওয়ে যে পণ্য ও সেবা বিক্রি অনুমোদন করে, অনেক ট্রাভেল মার্চেন্টের ক্ষেত্রে ট্রাভেল বুকিংসহ।
টাকা কীভাবে পান?Paddle তার ফি কেটে নিজের পরিশোধ সূচি অনুযায়ী আপনার আয় পরিশোধ করে।ক্যাপচার করা পেমেন্ট গেটওয়ের ফি বাদ দিয়ে আপনার মার্চেন্ট বা ব্যাংক অ্যাকাউন্টে সেটল হয়।

ফি, সমর্থিত দেশ ও অনুমোদিত পণ্যের সঠিক তালিকা Paddle নিজে ঠিক করে এবং সময়ের সঙ্গে বদলায়। এর ওপর পরিকল্পনা করার আগে Paddle-এর নিজস্ব শর্ত দেখে নিন।

সিদ্ধান্তের সহায়ক

আপনি যা বিক্রি করেন তার জন্য Paddle কি ঠিক?

গ্রাহক কীসের জন্য টাকা দিচ্ছেন সেখান থেকে শুরু করুন। আপনার ব্যবসার সবচেয়ে কাছের পরিস্থিতিটি বেছে নিন।

01

যাত্রীরা ফ্লাইট, হোটেল ও ট্যুরের জন্য টাকা দেন

গ্রাহক এমন একটি ভ্রমণ কিনছেন যা এয়ারলাইন, হোটেল বা ট্যুর অপারেটর সরবরাহ করে। এ ধরনের পেমেন্টে প্রায়ই এখন অথরাইজ ও পরে ক্যাপচার, বাতিলের ফির পর আংশিক রিফান্ড এবং একাধিক মুদ্রায় চেকআউট লাগে।

আমাদের মত

পেমেন্ট গেটওয়ে ব্যবহার করুন

ট্রাভেল বুকিংয়ে Paddle ব্যবহারের আগে এর গ্রহণযোগ্য ব্যবহার নীতি দেখে নিন। বেশির ভাগ ট্রাভেল ব্যবসা বুকিংয়ের পেমেন্ট নেয় Stripe, PayPal, Adyen বা আঞ্চলিক গেটওয়ের মতো পেমেন্ট গেটওয়ে দিয়ে।

02

আপনি নিজের ট্রাভেল সফটওয়্যার বা SaaS বিক্রি করেন

আপনি ট্রাভেল টেকনোলজি সরবরাহকারী এবং এজেন্সিগুলো আপনার বুকিং টুল, API অ্যাক্সেস, প্লাগইন বা হোয়াইট-লেবেল পোর্টালের জন্য মাসিক বা বার্ষিক সাবস্ক্রিপশন দেয়।

আমাদের মত

Paddle মানাতে পারে

মার্চেন্ট অফ রেকর্ড ঠিক এই ধরনের বিক্রির জন্যই তৈরি: Paddle সাবস্ক্রিপশনের বিল করে, প্রতিটি দেশে কর সামলায় এবং আপনাকে পরিশোধ করে, ফলে আপনার গ্রাহক যেখানেই থাকুক সেখানে VAT-এর জন্য নিবন্ধন করতে হয় না।

03

আপনি বুকিং ও সফটওয়্যার দুটোই বিক্রি করেন

আপনার এজেন্সি যাত্রীদের জন্য বুকিং সাইট চালায় এবং একই সঙ্গে নিজের প্ল্যাটফর্ম বা টুল অন্য এজেন্সিকে লাইসেন্স দেয়।

আমাদের মত

দুটোই ব্যবহার করুন, আলাদা রেখে

বুকিং ফ্লোতে তৈরি গেটওয়ে দিয়ে বুকিংয়ের পেমেন্ট নিন এবং সফটওয়্যার সাবস্ক্রিপশনের বিল করুন Paddle দিয়ে। দুটি ফ্লো, দুই সেট রেকর্ড, প্রতিটিতে সঠিক কর আচরণ।

কীভাবে কাজ করে

Paddle ইন্টিগ্রেশন শুরু থেকে শেষ পর্যন্ত কীভাবে কাজ করে

Paddle Billing কাজ করে Paddle-এ বানানো পণ্য ও মূল্য, Paddle.js দিয়ে খোলা চেকআউট এবং কী ঘটেছে তা আপনার সার্ভারকে জানানো ওয়েবহুক দিয়ে।

  1. 01

    পণ্য ও মূল্য

    প্রতিটি প্ল্যান Paddle-এ একবার বানান, যেমন মাসিক ও বার্ষিক মূল্য, এবং মূল্যের ID আপনার সিস্টেমে রাখুন।

    pri_…

  2. 02

    Paddle.js চেকআউট

    আপনার পেজ Paddle.js লোড করে মূল্যের ID ও আপনার নিজস্ব গ্রাহক রেফারেন্সসহ চেকআউট ওভারলে বা ইনলাইন ফ্রেম হিসেবে খোলে।

    Paddle.Checkout.open()

  3. 03

    লেনদেন সম্পন্ন

    ক্রেতা পেমেন্ট করেন, Paddle কার্ড বা ওয়ালেট থেকে টাকা কাটে, কর প্রয়োগ করে একটি লেনদেন তৈরি করে, আর মূল্য পুনরাবৃত্ত হলে একটি সাবস্ক্রিপশনও।

    txn_…

  4. 04

    সাইন করা ওয়েবহুক

    Paddle আপনার এন্ডপয়েন্টে transaction.completed-এর মতো ইভেন্ট পাঠায়, Paddle-Signature হেডারে সাইন করা অবস্থায়।

    transaction.completed

  5. 05

    আপনার সিস্টেম কাজ করে

    আপনার সার্ভার সিগনেচার যাচাই করে, তারপর অ্যাকাউন্ট চালু করে, প্ল্যান নবায়ন করে বা পেমেন্ট রেকর্ড করে।

    200 OK

API কী শুধু আপনার সার্ভারে রাখুন। ব্রাউজার আলাদা ক্লায়েন্ট-সাইড টোকেন ব্যবহার করে, আর sandbox ও লাইভ পরিবেশের প্রত্যেকটির নিজস্ব কী, মূল্য ও ওয়েবহুক সিক্রেট আছে।

ওয়েবহুক নিরাপত্তা

Paddle-Signature হেডার যাচাই

আপনার এন্ডপয়েন্টের URL জানা যে কেউ ওয়েবহুক জাল করতে পারে। প্রতিটি ইভেন্টে সিগনেচার যাচাই করলেই ওয়েবহুক থেকে অ্যাকাউন্ট চালু করা নিরাপদ হয়।

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

সাধারণ PHP-তে উদাহরণমাত্র। সঠিক ফরম্যাটের জন্য Paddle-এর বর্তমান ডকুমেন্টেশন বা তাদের অফিসিয়াল SDK অনুসরণ করুন।

  1. 01

    র বডি ব্যবহার করুন

    সিগনেচার রিকোয়েস্ট বডির ওপর ঠিক যেভাবে এসেছে সেভাবেই হিসাব করা হয়, তাই JSON পার্সিং বদলে দেওয়ার আগেই এটি পড়ে নিন।

  2. 02

    টাইমস্ট্যাম্পসহ হ্যাশ

    হেডারে একটি টাইমস্ট্যাম্প এবং আপনার এন্ডপয়েন্টের সিক্রেট কী দিয়ে তৈরি HMAC-SHA256 হ্যাশ থাকে। সেটি আবার তৈরি করে ধ্রুব সময়ে তুলনা করুন।

  3. 03

    পুরোনো ও পুনরাবৃত্ত ইভেন্ট বাতিল করুন

    টাইমস্ট্যাম্প খুব পুরোনো হলে ইভেন্ট প্রত্যাখ্যান করুন এবং প্রতিটি ইভেন্ট ID সংরক্ষণ করুন, যাতে পুনরায় ডেলিভারি দুইবার প্রসেস না হয়।

  4. 04

    আগে sandbox

    টেস্ট কার্ড দিয়ে Paddle-এর sandbox-এ বানান ও পরীক্ষা করুন, তারপর কী, মূল্য ও সিক্রেট লাইভে বদলান।

PHPTRAVELS ও Paddle

Paddle-কে PHPTRAVELS-এর সঙ্গে জোড়া

আগে একটি সৎ উত্তর, তারপর বিকল্পগুলো।

Paddle তৈরি কানেক্টর নয়

Paddle PHPTRAVELS-এর পেমেন্ট গেটওয়ে তালিকায় নেই এবং এর কোনো প্রকাশিত সেটআপ গাইড নেই। নিচে দেখানো তৈরি গেটওয়েগুলোই বুকিংয়ের পেমেন্ট নেওয়ার জন্য বানানো।

কাস্টম ইন্টিগ্রেশন সম্পর্কে জিজ্ঞাসা করুনবুকিং ডেমো দেখুন

  • বুকিংয়ের পেমেন্টের জন্য: তৈরি গেটওয়ে

    নিজের মার্চেন্ট অ্যাকাউন্ট দিয়ে অ্যাডমিনে Stripe পেমেন্ট বা PayPal পেমেন্ট-এর মতো তৈরি গেটওয়ে চালু করুন। পেমেন্ট গেটওয়ে ইন্টিগ্রেশন পেজে যেমন ব্যাখ্যা আছে, চেকআউট, রিফান্ড ও বুকিং রেফারেন্স আগে থেকেই বুকিং ফ্লোর সঙ্গে জোড়া।

  • সফটওয়্যার বিক্রির জন্য: কাস্টম ইন্টিগ্রেশন হিসেবে Paddle

    আপনার ব্যবহার Paddle-এর নিয়মের সঙ্গে মিললে আমাদের ডেভেলপাররা এটি কাস্টম API ইন্টিগ্রেশন হিসেবে জুড়তে পারেন: আপনার পেজে Paddle.js চেকআউট, যাচাই করা ওয়েবহুক এন্ডপয়েন্ট এবং আপনার গ্রাহকদের নামে রেকর্ড হওয়া পেমেন্ট। কাজ শুরুর আগে কোট দেওয়া হয়।

  • অথবা সোর্স কোডের ওপর নিজেই বানান

    PHPTRAVELS সেলফ-হোস্টেড এবং পুরো সোর্স কোডসহ আসে, তাই আপনার নিজস্ব ডেভেলপাররা বুকিং ইঞ্জিনের পাশাপাশি সাবস্ক্রিপশনের জন্য Paddle যোগ করতে পারেন। প্রতিটি লাইসেন্সে কী আছে তা মূল্য পেজে দেওয়া আছে।

বুকিংয়ের পেমেন্টের জন্য প্রস্তুত

PHPTRAVELS-এর সঙ্গে আগে থেকেই যুক্ত পেমেন্ট গেটওয়ে

যাত্রী ও এজেন্টের পেমেন্টের জন্য এই গেটওয়েগুলো প্রস্তুত: প্রদানকারীর কাছে অ্যাকাউন্ট খুলুন, অ্যাডমিনে নিজের কী দিন, পরীক্ষা করুন এবং লাইভ হোন। তালিকাটি আমাদের ইন্টিগ্রেশন ডিরেক্টরির লাইভ তালিকা।

সাব-এজেন্টরা B2B এজেন্ট ওয়ালেট-এর মাধ্যমে প্রিপেইড ব্যালান্স বা ক্রেডিট লিমিট থেকেও পেমেন্ট করতে পারেন, যার জন্য কোনো গেটওয়েই লাগে না।

FAQ

Paddle API ইন্টিগ্রেশন: সাধারণ প্রশ্ন

সেলসের সাথে কথা বলুন

তৈরি কানেক্টর হিসেবে নয়। Paddle PHPTRAVELS-এর পেমেন্ট গেটওয়ে তালিকায় নেই। আপনার ব্যবহার Paddle-এর নিয়মের সঙ্গে মিললে, যেমন নিজের সফটওয়্যারের সাবস্ক্রিপশন বিক্রি, এটি কাস্টম ইন্টিগ্রেশন হিসেবে যোগ করা যায় বা আপনার ডেভেলপাররা অন্তর্ভুক্ত সোর্স কোডের ওপর বানাতে পারেন।

Paddle সফটওয়্যার, SaaS ও ডিজিটাল পণ্যের জন্য তৈরি মার্চেন্ট অফ রেকর্ড, তাই ফ্লাইট, হোটেল বা ট্যুরের জন্য সাধারণত উপযুক্ত নয়। ট্রাভেল বুকিংয়ে ব্যবহারের আগে Paddle-এর গ্রহণযোগ্য ব্যবহার নীতি দেখুন; বেশির ভাগ ট্রাভেল ব্যবসা বুকিংয়ের পেমেন্ট নেয় Stripe, PayPal, Adyen বা আঞ্চলিক গেটওয়ের মতো পেমেন্ট গেটওয়ে দিয়ে।

যে কোম্পানি আইনত গ্রাহকের কাছে বিক্রি করে। সেলস ট্যাক্স বা VAT সংগ্রহ ও জমা, ইনভয়েস দেওয়া, রিফান্ড ও চার্জব্যাক সামলানো তার দায়িত্ব, এবং গ্রাহকের স্টেটমেন্টে তারই নাম দেখা যায়। Paddle-এর ক্ষেত্রে Paddle নিজে এই ভূমিকা নেয় এবং আপনাকে পরিশোধ করে।

গেটওয়ে আপনার হয়ে পেমেন্ট প্রসেস করে, আর বিক্রেতা থাকেন আপনি এবং কর ও বিরোধের কাজ আপনার থাকে। Paddle নিজেই বিক্রেতা হয়, ফলে সফটওয়্যার বিক্রিতে সেই কাজ থাকে না, কিন্তু এর মাধ্যমে কী বিক্রি করতে পারবেন তা সীমিত হয়।

যখন আপনি ভ্রমণ নয়, নিজের সফটওয়্যার বিক্রি করেন: বুকিং টুল, API, প্লাগইন বা হোয়াইট-লেবেল পোর্টাল, যার সাবস্ক্রিপশন এজেন্সিরা দেয়। তখন Paddle তাদের বিল করতে এবং প্রতিটি দেশে কর সামলাতে পারে।

Paddle সম্পন্ন লেনদেন বা নবায়িত সাবস্ক্রিপশনের মতো ইভেন্ট আপনার নিবন্ধিত URL-এ পাঠায়। প্রতিটি রিকোয়েস্টে টাইমস্ট্যাম্প ও হ্যাশসহ Paddle-Signature হেডার থাকে, যা আপনার সার্ভার কাজ করার আগে এন্ডপয়েন্টের সিক্রেট কী দিয়ে যাচাই করে।

হ্যাঁ। Paddle-এর আলাদা sandbox পরিবেশ আছে, যাতে নিজস্ব অ্যাকাউন্ট, API কী, মূল্য ও টেস্ট কার্ড রয়েছে। সেখানে বানান ও পরীক্ষা করুন, তারপর কনফিগারেশন লাইভ পরিবেশে নিয়ে যান।

হ্যাঁ, দুটি আলাদা ফ্লো হিসেবে: বুকিং ইঞ্জিন যাত্রীদের পেমেন্ট নেয় তৈরি গেটওয়ে দিয়ে, আর Paddle আপনার সফটওয়্যার সাবস্ক্রিপশনের বিল করে। রেকর্ড আলাদা রাখুন, যাতে প্রতিটি বিক্রিতে সঠিক কর আচরণ প্রযোজ্য হয়।

আরও দেখুন

প্ল্যাটফর্ম সম্পর্কে আরও