결제와 쇼핑몰

용도: Stripe가 호스팅하는 결제 페이지에서 받는 일회성 결제와 구독이에요. 구매자가 내 앱에 카드 번호를 입력하는 일은 없어요.

연결 방식: Set up Stripe 버튼이에요. Stripe가 제공하는 양식을 작성하고 돌아오면 되고, 키는 보이지 않아요. 먼저 앱을 게시하세요. Stripe는 실제 사이트를 확인하고, 아직 제작 중인 사이트는 거절하기 때문이에요. 신분증과 은행 계좌를 요구해요. 키를 대신 쓸 수도 있어요. 내 Stripe API 키에 있는 공개 키(pk_로 시작해요)와 시크릿 키(sk_로 시작해요), 그리고 웹훅 서명 시크릿(whsec_로 시작해요)이에요.

키를 붙여 넣은 경우에만: Stripe 카드에는 Stripe에 추가할 웹훅 주소가 복사 버튼과 함께 표시돼요. 이벤트 checkout.session.completed, checkout.session.async_payment_succeeded에 대해 추가하세요. 버튼으로 연결하면 따로 설정할 웹훅은 없어요.

이렇게 요청하세요:

• “코스용 Buy now 버튼을 추가해 주세요”
• “월간 요금제와 Manage billing 버튼을 추가해 주세요”
• “My orders 페이지를 추가해 주세요”

일어나는 일: 주문은 Stripe가 결제가 완료됐다고 알려 줄 때 기록되고, Manage의 Payments에 표시돼요. 온라인 스토어를 보세요.

제한: 앱이 할 수 있는 일은 결제를 시작하고, 그 결과를 다시 읽고, 가격 목록을 읽는 것이에요. 환불, 고객, 정산은 앱에서 다룰 수 없어요. 환불은 Manage의 Payments에서 하거나 Stripe에서 하세요. Manage billing은 그 앱에서 무언가를 구매한 적이 있는, 로그인한 사람에게만 작동해요.

용도: Paddle이 판매자로서 판매하는 결제와 구독이에요. VAT와 판매세를 대신 처리해 줘요. 국경을 넘어 판매할 때 쓸 만해요.

연결 방식: 키를 써요. Paddle의 인증 페이지에서 받아요.

• Client-side Token (live_로 시작하고, 샌드박스에서는 test_로 시작해요). 원래 공개해도 되는 값이라 게시된 앱에 포함돼요.
• API Key (pdl_live_apikey_ 또는 pdl_test_apikey_로 시작해요). Setherion의 서버에 보관돼요.
• Webhook Secret (pdl_ntfset_로 시작해요). 선택 사항이에요.

이렇게 요청하세요:

• “Paddle 결제 창을 여는 Subscribe 버튼이 있는 Pro 요금제를 추가해 주세요”
• “결제 창이 열리기 전에 가격과 포함된 내용을 보여 주세요”

작동 방식: 결제 창은 방문자의 브라우저에서 Paddle 자체 오버레이로 열려요. 가격은 Paddle 대시보드에서 만들고, 앱은 pri_ ID로 그 가격을 사용해요. 페이지가 금액을 보내는 일은 없어요. 페이지를 여는 사람은 누구나 그 값을 고칠 수 있기 때문이에요.

제한: 게시된 앱에는 서버가 없어서 API 키는 게시된 앱에서 쓰이지 않아요. test_로 시작하는 토큰은 Paddle 샌드박스에서만 작동해요. Test connection은 Paddle 계정에서 상품 하나를 읽어 와요.

용도: 고정 가격의 상품 하나를 파는 구매 버튼이에요. 가격, 세금, 배송비는 PayPal에 있어서, 페이지를 여는 누구도 결제 금액을 바꿀 수 없어요. 구매자는 PayPal 자체 창에서 PayPal 또는 카드로 결제해요.

연결 방식: 값 두 개예요.

• Client ID: PayPal에서 Pay links and buttons를 열고, 버튼, 그다음 그 코드를 여세요. client-id= 뒤에 오는 값이에요. 원래 공개해도 되는 값이에요.
• Currency: GBP나 EUR 같은 세 글자로, PayPal의 내 버튼과 같게 맞추세요.

먼저 PayPal의 버튼 페이지에서 버튼을 만드세요.

이렇게 요청하세요:

• “프린트 세 점에 각각 PayPal Buy 버튼을 추가해 주세요”
• “상품 페이지의 가격 아래에 PayPal 버튼을 넣어 주세요”

제한: 버튼 하나는 PayPal에서 정한 가격으로 상품 하나를 사요. 장바구니는 없어요. 누군가 결제해도 앱에는 알림이 오지 않아요. PayPal이 나와 구매자에게 이메일을 보내고, 판매는 앱에 기록되지 않아요. 장바구니, 앱에 저장되는 주문, 구독이 필요하다면 대신 Stripe나 Paddle을 연결하세요. 커넥터 페이지에도 같은 설명이 나와요.

용도: 구독 결제예요. Subscribe 버튼은 Chargebee가 호스팅하는 결제 페이지를 열고, Manage billing 버튼은 고객 포털을 열며, 팀은 고객, 구독, 청구서를 볼 수 있어요.

연결 방식: 키를 써요.

• Site name: 대시보드 주소에서 .chargebee.com 앞에 오는 부분이에요. 소문자로 적으세요.
• API key: Chargebee에서 Settings, Configure Chargebee, API Keys, Add API Key 순서로 여세요. Write Key를 고르세요(생성, 조회, 수정은 되고 삭제는 안 돼요). 앱에는 그것으로 충분해요.

이렇게 요청하세요:

• “내 Chargebee 요금제로 가격 페이지를 만들고, 각 요금제에 Subscribe 버튼을 추가해 주세요”
• “로그인한 고객을 위한 Manage billing 버튼을 추가해 주세요”
• “내 구독과 미납 청구서를 보여 주는 팀 페이지를 만들어 주세요”

누가 무엇을 할 수 있나요: 방문자는 결제를 시작하거나 고객 포털을 열거나, 가격 페이지를 위해 판매 중인 요금제와 가격을 읽을 수 있어요. 고객, 구독, 청구서, 그리고 요금제와 가격을 바꾸는 것은 내 팀만 할 수 있어요. 팀에 해당하는 계정은 Manage, Cloud, Users 순서로 열어서 표시하세요.

제한: Chargebee Product Catalog 2.0을 사용하므로 요금제는 아이템 가격이에요. 금액은 펜스나 센트 단위로 들어와요. 앱에서는 삭제할 수 없어요. Permissions에서 결제, 포털, 그리고 고객, 구독, 청구서, 요금제, 가격 각각의 읽기와 변경을 따로 끌 수 있어요.

용도: Shopify 스토어를 바탕으로 한 새 쇼핑몰 프런트예요. 상품, 가격, 재고는 Shopify에 그대로 있고, 구매자는 Shopify 자체 결제 페이지에서 결제해요.

연결 방식: 값 두 개예요.

• Store domain: .myshopify.com 주소예요. 쇼핑몰이 고객에게 커스텀 도메인을 보여 주더라도 이 주소를 써야 해요.
• Storefront API token (public): Shopify 관리자 화면에서 Sales channels, Headless, Create storefront 순서로 여세요. 그 스토어프런트의 공개 액세스 토큰을 복사하세요.

Admin API 토큰(shpat_로 시작해요)은 절대 쓰지 마세요. 카드가 거부해요. 이 토큰은 게시된 앱에 포함되어서 누구나 읽을 수 있기 때문이에요.

이렇게 요청하세요:

• “내 Shopify 스토어를 위한 새 쇼핑몰 프런트를 만들고, 홈 페이지에 컬렉션을 보여 주세요”
• “쇼핑하는 사람을 Shopify 결제 페이지로 보내는 장바구니를 추가해 주세요”
• “내 Shopify 상품에 검색과 필터를 추가해 주세요”

권한: Shopify는 달라요. 내 앱은 공개 토큰으로 페이지에서 곧바로 Shopify를 호출하므로, Setherion에는 스위치가 없어요. 제한은 Shopify에서 정하세요. Sales channels, Headless, 내 스토어프런트, Storefront API 옆의 Manage, 그다음 Permissions 순서로 열어요. 이 설정은 Headless 채널의 모든 스토어프런트에 적용돼요.

제한: 재고, 주문, 결제는 Shopify에 그대로 있어요. 상품이 품절이면, 앱은 쇼핑하는 사람을 다음 단계로 보내기 전에 무엇이 바뀌었는지 알려 줘요.

용도: 내 WooCommerce의 실제 상품을 보여 주고, 구매자를 내 결제 페이지로 보내는 쇼핑몰 프런트예요.

연결 방식: 키를 써요.

• Shop address: 쇼핑몰이 운영되는 주소로, 뒤에 /wp-admin이 붙는 그 주소예요.
• Consumer key (ck_로 시작해요)와 Consumer secret (cs_로 시작해요): WooCommerce에서 Settings, Advanced, REST API, Add key 순서로 열고, Permissions를 Read로 설정하세요.

두 키 모두 Setherion의 서버에 보관돼요.

이렇게 요청하세요:

• “내 WooCommerce 상품을 격자로 보여 주고, 각 상품에 Buy 버튼을 달아 주세요”
• “상품마다 사진과 가격이 있는 페이지를 추가해 주세요”

제한: 앱이 읽을 수 있는 것은 상품뿐이에요. 주문과 고객은 거부되므로, 이 연동에는 주문 내역도 고객 계정도 없어요. 구매는 내 쇼핑몰에서 이루어져요. 버튼이 상품을 담은 채로 구매자를 내 결제 페이지로 보내요. 가격은 쇼핑몰이 알려 주는 그대로, 쇼핑몰 자체의 통화로 나와요. Test connection은 상품 하나를 읽어 와요.

용도: 내 PrestaShop의 실제 상품을 보여 주고, 구매자를 내 쇼핑몰의 각 상품 페이지로 보내는 쇼핑몰 프런트예요.

연결 방식: 키를 써요.

• Shop address: 쇼핑몰이 운영되는 주소로, 뒤에 /admin이 붙는 그 주소예요.
• Webservice key: 영문자와 숫자 32자예요. PrestaShop에서 Advanced Parameters, Web service, Add new webservice key 순서로 열고, products의 View (GET) 항목에 체크하세요.

키는 Setherion의 서버에 보관돼요.

이렇게 요청하세요:

• “내 PrestaShop 상품을 사진과 가격과 함께 보여 주세요”
• “각 상품을 내 쇼핑몰의 상품 페이지에 연결해 주세요”

제한: 앱이 읽을 수 있는 것은 상품뿐이에요. 주문과 고객은 거부되고 재고 수량은 확인할 수 없어서, 앱에는 “재고 있음” 표시가 나타나지 않아요. PrestaShop의 가격은 세금이 포함되지 않은 금액이고, 앱도 그렇게 표시해요. 구매자는 장바구니가 아니라 내 쇼핑몰의 상품 페이지로 보내져요.