여행 소프트웨어 결제
Paddle API 연동: 머천트 오브 레코드가 여행 비즈니스에 맞는 경우
Paddle은 머천트 오브 레코드(판매 주체)로서 소프트웨어, SaaS, 디지털 상품을 대신 판매합니다. 그래서 자사 구독을 청구하는 여행 기술 기업에는 잘 맞지만, 항공권, 호텔, 투어 대금을 받는 용도에는 대체로 맞지 않습니다. 이 페이지에서는 그 차이와 Paddle 연동의 작동 방식, 용도가 맞을 때 PHPTRAVELS에 연결하는 방법을 설명합니다.
- 게이트웨이가 아닌 머천트 오브 레코드
- 소프트웨어와 구독에 최적화
- 서명된 웹훅
- 맞춤 연동으로 연결
서로 다른 두 모델
머천트 오브 레코드 vs 결제 게이트웨이
결제 게이트웨이는 돈의 이동을 대신 처리합니다. 판매자는 여전히 귀사이고, 결제 회사는 카드를 처리할 뿐이며, 세금, 청구서, 환불, 분쟁은 계속 귀사의 몫입니다. 머천트 오브 레코드는 한 걸음 더 나아가 고객과 세무 당국이 보기에 판매자가 됩니다. 누군가 Paddle로 구매하면 Paddle이 고객에게 판매하고, 판매세나 VAT를 징수해 납부하며, 청구서를 발행하고, 차지백을 처리한 뒤 귀사의 몫을 정산해 지급합니다.
이 모델은 소프트웨어 기업의 세무와 컴플라이언스 업무를 크게 줄여 주지만, 무엇을 재판매할지는 Paddle이 정한다는 뜻이기도 합니다. Paddle 플랫폼은 소프트웨어, SaaS, 디지털 상품을 위한 것이며, 항공사, 호텔, 투어 운영사가 제공하는 여행 서비스를 위한 것이 아닙니다. 카드 결제의 일반적인 구조는 결제 게이트웨이 API 페이지에서 다룹니다.
| 질문 | Paddle(머천트 오브 레코드) | 결제 게이트웨이 |
|---|---|---|
| 판매자는 누구인가 | Paddle이 판매자(머천트 오브 레코드)입니다. 고객의 영수증과 카드 명세서는 Paddle 쪽 판매로 표시됩니다. | 판매자는 귀사입니다. 게이트웨이는 귀사의 가맹점 계정으로 결제를 처리할 뿐입니다. |
| 판매세와 VAT는 누가 처리하는가 | Paddle이 판매 대상 지역의 판매세와 VAT를 계산, 징수, 납부합니다. | 귀사가 직접 세무 등록, 회계사, 청구서 발행으로 처리합니다. |
| 청구서는 누가 발행하는가 | Paddle이 구매자에게 청구서 또는 영수증을 발행합니다. | 귀사의 시스템이 발행합니다. 예를 들어 관리자 화면의 예약 청구서입니다. |
| 차지백은 누가 처리하는가 | Paddle이 판매자로서 분쟁과 차지백을 처리합니다. | 게이트웨이 대시보드나 API를 통해 귀사가 증빙 자료로 분쟁에 대응합니다. |
| 무엇을 판매할 수 있는가 | Paddle의 이용 정책 범위 안에서 소프트웨어, SaaS, 구독, 디지털 상품. | 게이트웨이가 승인하는 실물 및 서비스 판매. 많은 여행 가맹점의 여행 예약도 포함됩니다. |
| 대금은 어떻게 받는가 | Paddle이 수수료를 뺀 수익을 자체 정산 일정에 따라 지급합니다. | 매입된 결제 금액이 게이트웨이 수수료를 뺀 뒤 가맹점 계좌 또는 은행 계좌로 정산됩니다. |
수수료, 지원 국가, 판매 허용 상품의 정확한 목록은 Paddle이 정하며 시간이 지나면 바뀝니다. 도입을 계획하기 전에 Paddle의 약관을 직접 확인하세요.
판단 도우미
판매하는 상품에 Paddle이 맞을까요?
고객이 무엇에 대해 결제하는지에서 출발하세요. 귀사의 비즈니스와 가장 가까운 시나리오를 고르면 됩니다.
01
여행자가 항공권, 호텔, 투어를 결제
고객이 구매하는 것은 항공사, 호텔, 투어 운영사가 제공하는 여행입니다. 결제 단계에서는 먼저 승인하고 나중에 매입하는 방식, 취소 수수료를 반영한 부분 환불, 다중 통화 결제가 자주 필요합니다.
저희 의견
결제 게이트웨이를 사용하세요
여행 예약에 Paddle을 쓰기 전에 Paddle의 이용 정책을 확인하세요. 대부분의 여행 기업은 Stripe, PayPal, Adyen 또는 지역 게이트웨이 같은 결제 게이트웨이로 예약 대금을 받습니다.
02
자사의 여행 소프트웨어나 SaaS를 판매
여행 기술 벤더로서, 여행사가 예약 도구, API 이용권, 플러그인, 화이트라벨 포털에 대해 월간 또는 연간 구독료를 지불합니다.
저희 의견
Paddle이 맞을 수 있습니다
머천트 오브 레코드가 바로 이런 판매를 위해 만들어졌습니다. Paddle이 구독을 청구하고 국가별 세금을 처리한 뒤 대금을 지급하므로, 고객이 있는 모든 곳에서 VAT를 등록할 필요가 없습니다.
03
예약과 소프트웨어를 모두 판매
여행사가 여행자를 위한 예약 사이트를 운영하면서, 자사 플랫폼이나 도구를 다른 여행사에 라이선스로 제공하기도 합니다.
저희 의견
둘 다 쓰되 분리하세요
예약 대금은 예약 흐름에서 바로 쓸 수 있는 게이트웨이로 받고, 소프트웨어 구독은 Paddle로 청구하세요. 흐름도 두 개, 기록도 두 벌로 나누어 각각 알맞은 세무 처리를 적용합니다.
작동 방식
Paddle 연동이 처음부터 끝까지 작동하는 방식
Paddle Billing은 Paddle에서 만든 상품과 가격, Paddle.js가 여는 체크아웃, 그리고 일어난 일을 서버에 알리는 웹훅으로 동작합니다.
01
상품과 가격
월간, 연간 가격처럼 각 플랜을 Paddle에서 한 번만 만들고, 가격 ID를 자사 시스템에 보관합니다.
pri_…02
Paddle.js 체크아웃
페이지에서 Paddle.js를 불러와 가격 ID와 자체 고객 참조값을 넘기고, 오버레이 또는 인라인 프레임으로 체크아웃을 엽니다.
Paddle.Checkout.open()03
트랜잭션 완료
구매자가 결제하면 Paddle이 카드나 월렛에 청구하고 세금을 적용해 트랜잭션을 만들며, 가격이 반복 결제라면 구독도 만듭니다.
txn_…04
서명된 웹훅
Paddle이 transaction.completed 같은 이벤트를 귀사의 엔드포인트로 보내며, Paddle-Signature 헤더로 서명합니다.
transaction.completed05
자사 시스템이 처리
서버가 서명을 검증한 뒤 계정을 활성화하거나, 플랜을 갱신하거나, 결제를 기록합니다.
200 OK
API 키는 서버에만 보관하세요. 브라우저는 별도의 클라이언트 측 토큰을 사용하며, 샌드박스와 라이브 환경은 각자 키, 가격, 웹훅 시크릿을 따로 갖습니다.
웹훅 보안
Paddle-Signature 헤더 검증하기
엔드포인트 URL을 아는 사람이라면 누구나 웹훅을 위조할 수 있습니다. 모든 이벤트의 서명을 검증해야 웹훅을 근거로 계정을 활성화해도 안전합니다.
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를 따르세요.
- 01
원본 본문 사용
서명은 받은 그대로의 요청 본문으로 계산됩니다. JSON 파싱으로 내용이 바뀌기 전에 먼저 읽으세요.
- 02
타임스탬프와 해시
헤더에는 타임스탬프와, 엔드포인트의 시크릿 키로 만든 HMAC-SHA256 해시가 들어 있습니다. 직접 다시 계산해 일정 시간 비교(constant-time)로 대조하세요.
- 03
오래되거나 중복된 이벤트 거부
타임스탬프가 너무 오래된 이벤트는 거부하고, 이벤트 ID를 저장해 재전송된 이벤트가 두 번 처리되지 않게 하세요.
- 04
샌드박스 먼저
Paddle 샌드박스에서 테스트 카드로 구축하고 테스트한 다음, 키, 가격, 시크릿을 라이브용으로 바꾸세요.
PHPTRAVELS와 Paddle
Paddle을 PHPTRAVELS에 연결하기
먼저 솔직한 답변을 드리고, 그다음 선택지를 안내합니다.
Paddle은 기본 제공 커넥터가 아닙니다
Paddle은 PHPTRAVELS 결제 게이트웨이 목록에 없고, 공개된 설정 가이드도 없습니다. 예약 대금 수납용으로 만들어진 기본 제공 게이트웨이는 아래에 표시되어 있습니다.
예약 결제에는 기본 제공 게이트웨이
본인의 가맹점 계정으로 Stripe 결제나 PayPal 결제 같은 기본 제공 게이트웨이를 관리자 화면에서 활성화하세요. 결제 게이트웨이 연동 페이지에서 설명하듯, 체크아웃, 환불, 예약 번호는 이미 예약 흐름에 연결되어 있습니다.
소프트웨어 판매에는 맞춤 연동으로 Paddle
용도가 Paddle의 정책에 맞는 경우, 저희 개발자가 맞춤형 API 연동으로 연결해 드립니다. 페이지의 Paddle.js 체크아웃, 검증된 웹훅 엔드포인트, 고객별 결제 기록까지 포함됩니다. 작업은 시작 전에 견적을 드립니다.
또는 소스 코드로 직접 구축
PHPTRAVELS는 자체 호스팅 방식이며 전체 소스 코드가 함께 제공되므로, 귀사 개발자가 예약 엔진과 나란히 구독용 Paddle을 추가할 수 있습니다. 라이선스별 포함 내용은 가격 페이지에 정리되어 있습니다.
예약 결제 준비 완료
PHPTRAVELS에 이미 연결된 결제 게이트웨이
여행자와 에이전트 결제에는 이 게이트웨이들을 바로 쓸 수 있습니다. 결제 사업자에서 계정을 열고, 관리자 화면에 키를 입력하고, 테스트한 뒤 라이브로 전환하면 됩니다. 목록은 연동 디렉터리의 실시간 목록입니다.
Stripe연동 가이드
PayPal연동 가이드
xMoney
Fawaterk
Cashfree
Paystack
Flutterwave
Adyen
MyFatoorah
SSLcommerz
Razorpay- 모든 연동
하위 에이전트는 B2B 에이전트 지갑을 통해 선불 잔액이나 한도로 결제할 수도 있으며, 이 경우 게이트웨이가 전혀 필요하지 않습니다.
기본 제공 커넥터로는 지원하지 않습니다. Paddle은 PHPTRAVELS 결제 게이트웨이 목록에 없습니다. 자사 소프트웨어 구독 판매처럼 용도가 Paddle의 정책에 맞는다면 맞춤 연동으로 추가하거나, 포함된 소스 코드 위에서 귀사 개발자가 구축할 수 있습니다.
Paddle은 소프트웨어, SaaS, 디지털 상품을 위한 머천트 오브 레코드이므로, 항공권, 호텔, 투어에는 일반적으로 맞지 않습니다. 여행 예약에 쓰기 전에 Paddle의 이용 정책을 확인하세요. 대부분의 여행 기업은 Stripe, PayPal, Adyen 또는 지역 게이트웨이 같은 결제 게이트웨이로 예약 대금을 받습니다.
고객에게 법적으로 판매하는 회사입니다. 판매세나 VAT의 징수와 납부, 청구서 발행, 환불과 차지백 처리를 책임지며, 고객의 명세서에도 이 회사가 표시됩니다. Paddle을 쓰면 Paddle이 그 역할을 맡고 귀사에 대금을 지급합니다.
게이트웨이는 결제만 대신 처리하고, 판매자는 계속 귀사이므로 세금과 분쟁 업무도 귀사의 몫입니다. Paddle은 스스로 판매자가 되어 소프트웨어 판매에서는 그 업무가 사라지지만, 판매할 수 있는 상품에는 제한이 생깁니다.
여행 상품이 아니라 자사 소프트웨어를 판매할 때입니다. 예약 도구, API, 플러그인, 화이트라벨 포털처럼 여행사가 구독으로 비용을 내는 것이 해당합니다. 이때 Paddle이 청구하고 국가별 세금도 처리합니다.
Paddle은 트랜잭션 완료나 구독 갱신 같은 이벤트를 등록한 URL로 보냅니다. 각 요청에는 타임스탬프와 해시가 담긴 Paddle-Signature 헤더가 있으며, 서버는 엔드포인트의 시크릿 키로 이를 검증한 뒤에 처리합니다.
네. Paddle에는 자체 계정, API 키, 가격, 테스트 카드를 갖춘 별도의 샌드박스 환경이 있습니다. 그곳에서 구축하고 테스트한 다음, 설정을 라이브 환경으로 옮기세요.
네, 서로 분리된 두 흐름으로 운영하면 됩니다. 예약 엔진은 기본 제공 게이트웨이로 여행자 결제를 받고, Paddle은 자사 소프트웨어 구독을 청구합니다. 판매마다 알맞은 세무 처리를 하도록 기록은 따로 관리하세요.