MonstarX에서 Paddle 사용하기

Q: 키에는 어떤 권한이 필요한가요?

product.read, customer.read, transaction.read, subscription.read입니다. MonstarX가 읽지 않았으면 하는 항목은 빼도 됩니다. 그 목록은 조회에 실패할 뿐입니다.

Q: 키가 거부된 이유는 무엇인가요?

대개 다른 환경의 키이기 때문입니다. pdl_sdbx_ 키는 샌드박스, pdl_live_ 키는 프로덕션을 선택해야 합니다. 만료되었거나 폐기된 키도 거부됩니다.

핵심 요약백엔드 → 클라우드의 Paddle 행에서 샌드박스 또는 프로덕션을 고르고 Paddle API 키를 붙여 넣으세요. 그러면 MonstarX 에이전트가 Paddle의 제품, 고객, 거래, 구독을 읽을 수 있습니다. 실제 상품 목록과 일치하는 요금 페이지를 만들 때 유용합니다. 읽기만 하며, Paddle의 어떤 것도 바꾸지 않습니다.

상품, 고객, 구독을 조회합니다.

유형: 업무 도구 · API 키
카테고리: 결제와 청구
연결 방법: API 키

Paddle은 소프트웨어와 디지털 상품을 대신 판매하고 결제, 세금, 구독을 처리해 주는 서비스입니다. API 키(소프트웨어가 내 계정을 쓸 수 있게 해 주는, 비밀번호 같은 코드)로 Paddle 계정을 연결하면 MonstarX 에이전트(대화를 나누는 AI)가 작업하면서 상품 목록과 결제 데이터를 읽을 수 있습니다. 실제 상품으로 요금 페이지를 만들거나, 구독자가 어떤 요금제를 쓰는지 정리하는 식입니다.

이 커넥터는 업무 도구입니다. MonstarX가 사용자를 대신해 Paddle을 읽습니다. 만드는 앱에는 키가 전달되지 않습니다. 앱에서 결제를 받으려면 Stripe를 참고하세요.

MonstarX는 무엇을 할 수 있나요?

MonstarX가 할 수 있는 일	언제
제품 목록 보기	모든 모드
고객 목록 보기	모든 모드
거래 목록 보기	모든 모드
구독 목록 보기	모든 모드

목록은 한 번에 20개씩(최대 30개) 가져오고, MonstarX가 다음 페이지를 넘겨 가며 더 볼 수 있습니다. 다음 작업은 하지 않습니다: 제품, 가격, 고객, 거래, 구독, 환불 등 어떤 항목의 생성·변경·취소.

시작하기 전에

Paddle 계정이 필요합니다. 샌드박스 계정에는 테스트 데이터가, 라이브 계정(MonstarX에서는 프로덕션)에는 실제 데이터가 있습니다. 두 계정은 서로 별개이고 키도 따로 있습니다.
MonstarX 프로젝트의 소유자여야 합니다. 도구를 연결하거나 연결 해제할 수 있는 사람은 소유자뿐입니다.

키 발급받기

Paddle(연결하려는 샌드박스 또는 라이브 계정)에서 Developer Tools > Authentication으로 이동해 API keys 탭을 여세요.
New API key를 클릭하고 MonstarX처럼 이름을 붙이세요.
읽기 권한 product.read, customer.read, transaction.read, subscription.read를 주세요. MonstarX에는 이것만 있으면 되고, 쓰기 권한은 절대 쓰지 않습니다.
만료일을 정하고(Paddle 기본값은 90일) 저장한 뒤 키를 복사하세요. 샌드박스 키는 pdl_sdbx_apikey_, 라이브 키는 pdl_live_apikey_로 시작합니다.

Paddle 공식 가이드: Create and manage API keys

MonstarX에서 연결하기

프로젝트를 열고 상단 바에서 백엔드를 클릭한 다음 클라우드를 클릭하세요.
커넥터까지 스크롤해 Paddle을 찾고 연결을 클릭하세요.
키에 맞게 샌드박스 또는 프로덕션을 고르고, 키 입력란에 키를 붙여 넣은 뒤 연결을 클릭하세요.
MonstarX가 Paddle에서 키를 확인합니다. 확인되면 행에 샌드박스에 연결됨 또는 프로덕션에 연결됨이 표시됩니다. 키와 환경이 맞지 않으면 Paddle이 키를 거부하고, 아무것도 저장되지 않습니다.

MonstarX에 사용 요청하기

입력 예시	결과
“내 Paddle 제품을 읽고, 그 요금제와 이름으로 요금 페이지를 만들어 주세요.”	MonstarX가 제품 목록을 보고, 만들기 모드에서 그 내용으로 페이지를 만듭니다.
“Paddle에서 활성 구독이 몇 개이고, 각각 어떤 요금제인가요?”	구독 목록을 넘겨 보며 대화에 정리해 줍니다.
“최근 Paddle 거래 20건을 보고 어떤 제품이 가장 잘 팔리는지 알려 주세요.”	거래 내역을 읽고 답합니다.

보안과 개인정보 보호

MonstarX에만 보관됩니다. 키는 암호화되어 MonstarX 서버에 저장됩니다. 앱 코드에 기록되거나 앱에 전달되는 일은 없습니다.
읽기 전용입니다. MonstarX는 Paddle에 목록만 요청합니다. 키에 읽기 권한만 주면 키가 유출되더라도 결제 정보를 바꿀 수 없습니다.
기밀 데이터로 다룹니다. 고객과 결제 정보는 비공개 정보이자 참고할 정보로만 다루고, 지시로 따르지 않습니다.
언제든 연결 해제할 수 있습니다. 백엔드클라우드에서 Paddle 옆의 연결 해제를 클릭하고 이 프로젝트에서 Paddle 연결을 해제할까요?를 확인하세요. MonstarX는 키를 삭제합니다. 더 이상 필요 없다면 Paddle에서도 키를 폐기하세요.

알아 두면 좋은 점

앱을 만드는 동안에는 샌드박스로 시작하고, 나중에 전환하세요. 연결을 해제한 뒤 라이브 키로 다시 연결하면 됩니다.
Paddle에서 키가 만료되면 MonstarX의 요청이 실패합니다. 새 키를 만들고 다시 연결하세요.
한 프로젝트에는 한 번에 Paddle 계정 하나만 연결할 수 있습니다.

자주 묻는 질문

이 연결로 앱에서 Paddle 결제를 받을 수 있나요?

아니요. 이 연결은 MonstarX 에이전트가 Paddle 데이터를 읽게 해 줍니다. 앱에서 결제를 받으려면 MonstarX의 Stripe 커넥터를 쓰세요. 다른 결제 서비스라면 키를 백엔드 → 시크릿에 추가하고 MonstarX에 기능을 만들어 달라고 요청하세요.

키에는 어떤 권한이 필요한가요?

product.read, customer.read, transaction.read, subscription.read입니다. MonstarX가 읽지 않았으면 하는 항목은 빼도 됩니다. 그 목록은 조회에 실패할 뿐입니다.

MonstarX가 환불하거나 구독을 취소할 수 있나요?

아니요. 제품, 고객, 거래, 구독 목록을 보는 것만 할 수 있습니다.

키가 거부된 이유는 무엇인가요?

대개 다른 환경의 키이기 때문입니다. pdl_sdbx_ 키는 샌드박스, pdl_live_ 키는 프로덕션을 선택해야 합니다. 만료되었거나 폐기된 키도 거부됩니다.