connectbase-client 3.51.0 → 3.52.0

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.52.0] - 2026-07-22
+
+### Added — Paddle(MoR) 임베디드 결제 타입
+
+앱 임베디드 결제·구독 응답에 Paddle(Merchant of Record) 프로바이더 타입을 추가했다. 서버가
+Paddle 트랜잭션을 만들어 반환하면, 앱에서 Paddle.js 오버레이 checkout 을 띄워 결제받을 수 있다
+(결제 확정의 원천은 서버 webhook). 기존 toss/stripe/payapp/paypal 사용에는 영향 없는 **순수 additive** 변경.
+
+- `PaymentProvider` 유니온에 `"paddle"` 추가.
+- `PreparePaymentResponse` — `paddle_transaction_id`, `paddle_client_token`, `paddle_environment`(sandbox|production), `paddle_checkout_url` 필드 추가.
+- `ConfirmPaymentRequest` — `paddle_transaction_id` 필드 추가(트랜잭션 상태 확인용).
+- `SubscriptionResponse` — `provider` 에 `paddle` 포함, `paddle_transaction_id`/`paddle_client_token`/`paddle_environment`/`paddle_checkout_url` 추가. (부수적으로 누락됐던 `paypal` provider 값도 정합.)
+- `CreateSubscriptionRequest` — `paddle_price_id`(Paddle 카탈로그 recurring price ID) 필드 추가.
+
 ## [3.50.0] - 2026-07-18
 
 ### Added — 파일 업로드 진행률 콜백 (`cb.storage.uploadFile` onProgress)

package/dist/index.d.mts

@@ -5173,7 +5173,7 @@ declare class OAuthAPI {
     } | null>;
 }
 
-type PaymentProvider = "toss" | "stripe" | "payapp" | "paypal";
+type PaymentProvider = "toss" | "stripe" | "payapp" | "paypal" | "paddle";
 type PaymentStatus = "pending" | "ready" | "in_progress" | "done" | "canceled" | "partial_canceled" | "aborted" | "expired" | "failed";
 interface PreparePaymentRequest {
     amount: number;
@@ -5200,6 +5200,10 @@ interface PreparePaymentResponse {
     payapp_mul_no?: string;
     paypal_approve_url?: string;
     paypal_order_id?: string;
+    paddle_transaction_id?: string;
+    paddle_client_token?: string;
+    paddle_environment?: string;
+    paddle_checkout_url?: string;
 }
 interface CreateCheckoutSessionRequest {
     amount: number;
@@ -5226,6 +5230,7 @@ interface ConfirmPaymentRequest {
     amount: number;
     stripe_payment_intent_id?: string;
     paypal_order_id?: string;
+    paddle_transaction_id?: string;
 }
 interface ConfirmPaymentResponse {
     payment_id: string;
@@ -7284,6 +7289,8 @@ interface CreateSubscriptionRequest {
     customer_phone?: string;
     /** payapp 정기결제 만료일 yyyy-mm-dd (미입력시 +10년) */
     expire_date?: string;
+    /** paddle 필수: Paddle 카탈로그의 recurring price ID (pri_*) */
+    paddle_price_id?: string;
     /** 메타데이터 */
     metadata?: Record<string, unknown>;
 }
@@ -7293,11 +7300,19 @@ interface SubscriptionResponse {
     /** 구독 ID (문자열) */
     subscription_id: string;
     /** 결제 프로바이더 */
-    provider?: "toss" | "stripe" | "payapp" | "paypal";
+    provider?: "toss" | "stripe" | "payapp" | "paypal" | "paddle";
     /** payapp: 카드등록+1회차 결제창 URL. 이 URL로 사용자를 redirect 시킨다 (위젯 불필요) */
     payapp_pay_url?: string;
     /** paypal: 구독 승인+결제수단 등록 URL. 이 URL로 사용자를 redirect 시킨다 (위젯 불필요) */
     paypal_approve_url?: string;
+    /** paddle: Paddle.js Checkout.open({transactionId})로 오버레이. 확정은 웹훅이 SoT */
+    paddle_transaction_id?: string;
+    /** paddle: Paddle.js 초기화용 client-side token */
+    paddle_client_token?: string;
+    /** paddle: sandbox | production */
+    paddle_environment?: string;
+    /** paddle: 호스티드 결제 페이지 URL (fallback) */
+    paddle_checkout_url?: string;
     /** 플랜 이름 */
     plan_name: string;
     /** 플랜 설명 */

package/dist/index.d.ts

@@ -5173,7 +5173,7 @@ declare class OAuthAPI {
     } | null>;
 }
 
-type PaymentProvider = "toss" | "stripe" | "payapp" | "paypal";
+type PaymentProvider = "toss" | "stripe" | "payapp" | "paypal" | "paddle";
 type PaymentStatus = "pending" | "ready" | "in_progress" | "done" | "canceled" | "partial_canceled" | "aborted" | "expired" | "failed";
 interface PreparePaymentRequest {
     amount: number;
@@ -5200,6 +5200,10 @@ interface PreparePaymentResponse {
     payapp_mul_no?: string;
     paypal_approve_url?: string;
     paypal_order_id?: string;
+    paddle_transaction_id?: string;
+    paddle_client_token?: string;
+    paddle_environment?: string;
+    paddle_checkout_url?: string;
 }
 interface CreateCheckoutSessionRequest {
     amount: number;
@@ -5226,6 +5230,7 @@ interface ConfirmPaymentRequest {
     amount: number;
     stripe_payment_intent_id?: string;
     paypal_order_id?: string;
+    paddle_transaction_id?: string;
 }
 interface ConfirmPaymentResponse {
     payment_id: string;
@@ -7284,6 +7289,8 @@ interface CreateSubscriptionRequest {
     customer_phone?: string;
     /** payapp 정기결제 만료일 yyyy-mm-dd (미입력시 +10년) */
     expire_date?: string;
+    /** paddle 필수: Paddle 카탈로그의 recurring price ID (pri_*) */
+    paddle_price_id?: string;
     /** 메타데이터 */
     metadata?: Record<string, unknown>;
 }
@@ -7293,11 +7300,19 @@ interface SubscriptionResponse {
     /** 구독 ID (문자열) */
     subscription_id: string;
     /** 결제 프로바이더 */
-    provider?: "toss" | "stripe" | "payapp" | "paypal";
+    provider?: "toss" | "stripe" | "payapp" | "paypal" | "paddle";
     /** payapp: 카드등록+1회차 결제창 URL. 이 URL로 사용자를 redirect 시킨다 (위젯 불필요) */
     payapp_pay_url?: string;
     /** paypal: 구독 승인+결제수단 등록 URL. 이 URL로 사용자를 redirect 시킨다 (위젯 불필요) */
     paypal_approve_url?: string;
+    /** paddle: Paddle.js Checkout.open({transactionId})로 오버레이. 확정은 웹훅이 SoT */
+    paddle_transaction_id?: string;
+    /** paddle: Paddle.js 초기화용 client-side token */
+    paddle_client_token?: string;
+    /** paddle: sandbox | production */
+    paddle_environment?: string;
+    /** paddle: 호스티드 결제 페이지 URL (fallback) */
+    paddle_checkout_url?: string;
     /** 플랜 이름 */
     plan_name: string;
     /** 플랜 설명 */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "connectbase-client",
-	"version": "3.51.0",
+	"version": "3.52.0",
 	"description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
 	"repository": {
 		"type": "git",