이 페이지는
@whop/elements@1.10.0 및 @whop/elements-react@1.10.0을 다룹니다.v1.0.0부터 지원.
엘리먼트를 마운트하지 않고 이
계정이 지갑을 제공하고, 기기가 지원하며, 이 페이지의 오리진이 계정에 대해 승인된 경우 각 지갑의 사용 가능 여부를 반환합니다(자사 whop.com 페이지는 사전 승인되어 있습니다. 판매자 페이지는 Domains API를 통해 해당 도메인에 Apple Pay가 준비되어 있어야 하며, 그곳에서 Google Pay를 제공하는 것은 Google Pay API 서비스 약관의 적용을 받습니다). 페이지 자체가 iframe 안에 있는 경우, 브라우저가 노출하면 Apple Pay는 대신 최상위 페이지의 도메인을 확인합니다. WebKit이 아닌 브라우저의 Apple Pay는 데스크톱 iPhone 핸드오프 흐름이므로 해당 브라우저의 모바일 기기에서는 사용할 수 없다고 보고됩니다. iOS 브라우저의 네이티브 Apple Pay는 영향을 받지 않습니다.
이 인스턴스의
구매자가 배송 주소를 선택했습니다(승인 전에는 일부가 가려져 도시, 주, 우편번호, 국가만 포함됩니다. Apple Pay는 미국 ZIP 코드를 다섯 자리로 줄이고 캐나다 또는 영국 우편번호의 마지막 세 글자를 제거합니다). 해당 주소와 선택된 배송 옵션(구매자가 다른 옵션을 선택하기 전까지는 첫 번째 옵션)에 대한 합계로 응답하세요.
구매자가 배송 옵션을 선택했거나 Apple Pay가 선택된 옵션을 다시 알렸습니다. 주소 변경에 모두 응답하고 대기 중인 것이 없으면 Apple Pay는 여전히 선택된 옵션에 대해 이를 실행합니다. 선택된 옵션을 제외한 응답 후에는 실행되지 않으며, 이 경우 이벤트 없이 첫 번째 옵션이 선택되므로, 응답하는 모든 합계는 선택된 옵션의 가격을 반영해야 합니다. 즉 구매자가 다른 옵션을 선택하기 전까지는 첫 번째 옵션, 응답이 그
구매자가 일부가 가려진 청구지 주소(도시, 주, 우편번호, 국가만)와 함께 카드를 선택했습니다. 청구에 세금이 부과되는 주소를 기준으로 합계를 다시 책정하세요. Apple Pay는 구매자가 카드를 선택할 때, Google Pay는 시트가 열릴 때와 구매자가 카드를 바꿀 때마다 이를 실행합니다. 최소 화폐 단위로
구매자가 결제 수단을 선택했습니다. 신용카드 추가 요금처럼 해당 결제 수단에 맞게 합계를 다시 책정하세요. Apple Pay는 구매자가 카드를 선택할 때, Google Pay는 시트가 열릴 때와 구매자가 카드를 바꿀 때마다 이를 실행하며, 각각 해당 카드의
구매자가 시트의 프로모션 필드(
구매자가 결제를 승인했으며, 아직 확인 토큰은 존재하지 않습니다. 먼저 승인하거나 거부하려면 구독하세요. 시트는 응답을 기다리며, 핸들러가 없으면 토큰이 즉시 생성됩니다. 이벤트는 결제자, 결제 수단(일부가 가려진 청구지 주소와
시트가 확인 토큰을 생성했으며, 시트가 닫힌 후에 수신됩니다.
구매자가 시트를 닫았거나 PayPal을 닫았습니다. 구독 해제 함수를 반환합니다.
Payments 리소스를 생성합니다. 바닐라에서는 whop.payments.paymentRequest.create({ … }), React에서는 useWhop().payments.paymentRequest.create({ … })를 사용합니다.옵션
이 값들을whop.payments.paymentRequest.create({ … })에 전달하세요.API의
enabled, disabled, include_platform_defaults 형식으로 된 결제 수단 필터입니다. canMakePayment()가 보고하는 지갑을 좁힙니다. disabled는 유형을 제거하고, enabled는 제공되는 유형을 복원하며, include_platform_defaults: false는 활성화된 유형만 남깁니다. 계정이 제공하지 않는 결제 수단을 추가하지는 않습니다. PayPal은 paypal 유형을 따릅니다. v1.9.0부터 지원.시트에 결제자의 전화번호를 요청하며, 결과의
payer.phone으로 전달됩니다. 이 번호를 제공한 연락처의 국가 기준으로 파싱되면 E.164 형식이고, 그렇지 않으면 지갑이 제공한 그대로입니다. payer.country는 청구지 국가입니다. Google Pay는 시트가 이미 요청하는 청구지 주소를 통해 이를 수집합니다. PayPal은 연락처 섹션을 통해 수집하며 전화번호가 없는 계정은 거부합니다. 기본값은 false입니다.시트에 배송 주소를 요청합니다(제공된 경우
shippingOptions도 표시). PayPal은 세금이 계산되는 기준 주소이므로 항상 주소를 요청하며, 이 옵션이 설정된 경우에만 이를 shipping으로 반환합니다. 기본값은 false입니다.시트 자체의 프로모션 코드 필드를 제공하고
onPromoCodeChange에 응답합니다. Apple Pay는 Apple Pay 버전 12를 지원하는 기기(iOS 15 및 macOS 12)에서 필드를 표시하고, Google Pay는 계정의 Google Pay 설정이 오퍼를 허용하는 곳에서 표시합니다. 다른 기기에서는 필드 없이 시트가 열립니다. 기본값은 false입니다. v1.5.0부터 지원.appliedPromoCode의 효과를 설명하는 문구로, Google Pay에서 코드 옆에 표시됩니다. Apple Pay의 쿠폰 필드에는 설명 문구가 없습니다. v1.5.0부터 지원.Apple Pay 시트에 사용할 계정의 ISO 3166-1 alpha-2 국가 코드입니다. 생략하면 계정에 게시된 등록 국가를 사용합니다. 둘 다 없으면 시트는 기본적으로
US를 사용합니다.requestShipping이 설정된 경우 시트가 제공하는 배송 옵션입니다. 표시 전용이므로 변경 핸들러에서 amount를 업데이트하세요. 시트는 첫 번째 옵션이 선택된 상태로 열리며 이에 대해 onShippingOptionChange를 실행하지 않으므로, amount에 이미 해당 가격이 포함되어 있어야 합니다. 나중에 update()로 변경할 수 있습니다.메서드
리소스에서 호출합니다.canMakePayment
계정이 지갑을 제공하고, 기기가 지원하며, 이 페이지의 오리진이 계정에 대해 승인된 경우 각 지갑의 사용 가능 여부를 반환합니다(자사 whop.com 페이지는 사전 승인되어 있습니다. 판매자 페이지는 Domains API를 통해 해당 도메인에 Apple Pay가 준비되어 있어야 하며, 그곳에서 Google Pay를 제공하는 것은 Google Pay API 서비스 약관의 적용을 받습니다). 페이지 자체가 iframe 안에 있는 경우, 브라우저가 노출하면 Apple Pay는 대신 최상위 페이지의 도메인을 확인합니다. WebKit이 아닌 브라우저의 Apple Pay는 데스크톱 iPhone 핸드오프 흐름이므로 해당 브라우저의 모바일 기기에서는 사용할 수 없다고 보고됩니다. iOS 브라우저의 네이티브 Apple Pay는 영향을 받지 않습니다. order는 브라우저에서 어떤 시트가 네이티브인지에 따라 지갑의 순위를 매기므로(Safari에서는 Apple Pay가 먼저, 그 외에는 Google Pay가 먼저, PayPal은 마지막) 익스프레스 버튼을 가장 적합한 순서로 쌓을 수 있습니다. payPal은 계정이 이 통화로 PayPal을 제공하고, 금액이 PayPal 한도 내이며, 요청이 결제자의 전화번호를 요구하지 않고(off_session 요청은 $0일 수 있으며, 이 경우 청구 없이 PayPal을 저장합니다), PayPal의 스크립트가 이 페이지에서 로드되며, 이 페이지의 오리진이 다른 지갑과 마찬가지로 계정에 대해 승인된 경우 PayPal을 보고합니다. Content Security Policy가 있는 페이지는 PayPal의 호스트를 허용해야 하며, contentSecurityPolicy()에 포함되어 있습니다. 이미 PayPal 자체의 v5 JavaScript SDK를 로드하는 페이지는 payPal: false를 보고합니다. 나열한 지갑만 확인하려면 types를 전달하세요. show(type)에는 해당 지갑이 확인되어 있어야 합니다. wallets는 사용 가능한 각 지갑의 공식 버튼 이미지(light 및 dark 색상과 이미지)를 담고 있습니다. 이 메서드는 show()를 준비합니다. 항상 먼저 await하세요.매개변수반환값 Promise<WalletAvailability>이 브라우저에서 어떤 시트가 네이티브인지에 따라 순위가 매겨진 지갑 목록입니다. WebKit에서는 Apple Pay가 먼저, 그 외에는 Google Pay가 먼저, PayPal은 마지막이므로 익스프레스 버튼을 가장 적합한 순서로 쌓을 수 있습니다. 사용자가 지정한 사용 가능 여부(미리보기)와 이 기능 이전의 통신에서는 없습니다. payment-request의 WalletSheetType이 아닌 인라인 유니온입니다. 해당 모듈이 이미 이 모듈을 가져오기 때문입니다.
show
canMakePayment()를 await한 후, 누르는 동작 안에서 동기적으로 선택한 지갑을 엽니다. Apple은 제스처 스택 안에서 세션을 생성하도록 요구하며, PayPal은 그곳에서 창을 엽니다. 데스크톱에서는 팝업이며, 팝업이 차단되거나 모바일인 경우 PayPal의 페이지 내 창입니다. 페이지에서 이미 이메일을 수집했다면 email을 전달하세요. 지갑은 이를 사용하고 다시 묻지 않습니다. requestPayerEmail: false인 경우 이메일 전달이 필수이며, 확인 토큰에는 이메일이 필요하므로 이메일이 없으면 지갑이 열리지 않습니다. 시트가 열려 있는 동안 update()는 예외를 발생시키므로, 변경하려면 변경 이벤트에 응답하세요. 사용자 활성화 중에 동기적으로 호출하세요. 브라우저는 비동기 단계를 거치면 활성화를 취소하므로 선행 작업은 먼저 await하세요.매개변수반환값 Promise<PaymentRequestResult>phone은 연락처의 국가 기준으로 파싱되면 E.164 형식이고, 그렇지 않으면 제공된 그대로입니다. PayPal은 requestPayerPhone인 경우에만 전화번호를 제공하며, 전화번호가 없는 계정은 거부합니다. country는 모든 시트가 수집하는 청구지 국가입니다.변경 이벤트가 전달하는 일부 가려진 주소와 달리 확인 토큰이 담는 전체 청구지 주소이며, 지갑이 제공하지 않은 경우
null입니다. Apple Pay와 Google Pay는 카드의 청구지 주소를 제공합니다. PayPal에서는 구매자가 PayPal에서 선택한 주소, 즉 합계에 세금이 부과된 주소입니다.requestShipping이 설정되지 않은 경우 null입니다. option은 선택된 배송 옵션입니다. 구매자가 다른 옵션을 선택하기 전까지는 첫 번째 옵션이며, 응답이 선택된 id 없이 옵션을 교체하면 다시 첫 번째 옵션이 됩니다. Apple Pay와 Google Pay는 옵션이 제공될 때마다 이를 설정하며, PayPal은 설정하지 않습니다.update
이 인스턴스의 amount, lineItems, shippingOptions를 변경합니다. 다른 모든 옵션은 create() 시점에 고정되므로, 변경하려면 새 인스턴스를 생성하세요.매개변수이벤트
아래 이벤트를 구독합니다. 각 메서드는 구독 해제 함수를 반환합니다.onShippingAddressChange
구매자가 배송 주소를 선택했습니다(승인 전에는 일부가 가려져 도시, 주, 우편번호, 국가만 포함됩니다. Apple Pay는 미국 ZIP 코드를 다섯 자리로 줄이고 캐나다 또는 영국 우편번호의 마지막 세 글자를 제거합니다). 해당 주소와 선택된 배송 옵션(구매자가 다른 옵션을 선택하기 전까지는 첫 번째 옵션)에 대한 합계로 응답하세요. shippingOptions는 옵션을 교체합니다(빈 목록은 아무것도 변경하지 않습니다). 선택된 옵션은 응답이 그 id를 유지하는 동안 선택된 상태로 남습니다. 응답이 이를 제외하면 onShippingOptionChange 없이 첫 번째 옵션이 선택되므로, 그 옵션의 가격을 책정하세요. 응답의 모든 오류는 이후 해당 주소에 대한 응답이 이를 해제할 때까지 주소에 남습니다. field(city, state, postal_code, country)를 지정한 오류는 Apple Pay에서 해당 필드를 표시하며, Google Pay는 메시지만 표시합니다. 주소에 오류가 남아 있는 동안에는 결제가 거부됩니다. 배송할 수 없는 주소는 field 없이 shipping_address_unserviceable 오류로 거부하세요. Apple Pay, Google Pay, PayPal에서 25초 이내에 응답하지 않은 핸들러는 예외를 발생시킨 핸들러와 마찬가지로 주소를 실패시키며, 이후의 응답은 무시됩니다. PayPal은 구매자가 선택한 주소로 이를 실행하며, field를 지정한 오류는 PayPal 내에서 주소의 해당 부분을 거부합니다. 이벤트마다 updateWith(…)를 정확히 한 번 호출하세요. 호출하기 전에 예외를 발생시키거나 거부되는 핸들러는 해당 업데이트를 즉시 실패시킵니다. 구독 해제 함수를 반환합니다.onShippingOptionChange
구매자가 배송 옵션을 선택했거나 Apple Pay가 선택된 옵션을 다시 알렸습니다. 주소 변경에 모두 응답하고 대기 중인 것이 없으면 Apple Pay는 여전히 선택된 옵션에 대해 이를 실행합니다. 선택된 옵션을 제외한 응답 후에는 실행되지 않으며, 이 경우 이벤트 없이 첫 번째 옵션이 선택되므로, 응답하는 모든 합계는 선택된 옵션의 가격을 반영해야 합니다. 즉 구매자가 다른 옵션을 선택하기 전까지는 첫 번째 옵션, 응답이 그 id를 유지하는 동안은 선택한 옵션, 응답이 이를 제외하면 다시 첫 번째 옵션입니다. 금액 전용 계약입니다. updateWith는 amount/lineItems/shippingOptions/errors를 전달합니다. errors가 포함된 응답은 구매자가 핸들러가 허용하는 옵션을 선택할 때까지 해당 옵션을 거부합니다. Apple Pay에는 배송 옵션용 오류 슬롯이 없으므로 응답에 무엇이 포함되든 마지막으로 허용된 합계를 유지하며, 구매자가 결제를 탭하면 첫 번째 오류의 메시지가 표시됩니다. Google Pay는 옵션을 선택할 때 메시지를 표시합니다. Apple Pay, Google Pay, PayPal에서 25초 이내에 응답하지 않은 핸들러는 예외를 발생시킨 핸들러와 마찬가지로 옵션을 거부하며, 이후의 응답은 무시됩니다. 이벤트마다 updateWith(…)를 정확히 한 번 호출하세요. 호출하기 전에 예외를 발생시키거나 거부되는 핸들러는 해당 업데이트를 즉시 실패시킵니다. 구독 해제 함수를 반환합니다.onBillingAddressChange
구매자가 일부가 가려진 청구지 주소(도시, 주, 우편번호, 국가만)와 함께 카드를 선택했습니다. 청구에 세금이 부과되는 주소를 기준으로 합계를 다시 책정하세요. Apple Pay는 구매자가 카드를 선택할 때, Google Pay는 시트가 열릴 때와 구매자가 카드를 바꿀 때마다 이를 실행합니다. 최소 화폐 단위로 updateWith({ amount }), 현재 합계를 유지하려면 updateWith({}), 카드를 거부하려면 updateWith({ errors })로 응답하세요. 모든 이벤트에는 정확히 한 번 응답해야 합니다. 예외를 발생시키거나, 거부되거나, 10초 이내에 응답하지 않는 핸들러는 카드를 거부하므로 구매자는 다른 카드를 선택하게 됩니다. Apple Pay와 Google Pay에서는 같은 선택이 이어서 paymentMethodChange를 실행하며, 둘 다 응답되면 시트가 한 번 업데이트됩니다. PayPal은 구매자가 PayPal에서 선택하는 각 배송 주소로 이를 실행하며, 이 주소가 토큰의 청구 및 세금 부과 기준이 되고, 여기서의 거부는 PayPal 내에서 해당 주소를 거부합니다. 이벤트마다 updateWith(…)를 정확히 한 번 호출하세요. 호출하기 전에 예외를 발생시키거나 거부되는 핸들러는 해당 업데이트를 즉시 실패시킵니다. 구독 해제 함수를 반환합니다.onPaymentMethodChange
구매자가 결제 수단을 선택했습니다. 신용카드 추가 요금처럼 해당 결제 수단에 맞게 합계를 다시 책정하세요. Apple Pay는 구매자가 카드를 선택할 때, Google Pay는 시트가 열릴 때와 구매자가 카드를 바꿀 때마다 이를 실행하며, 각각 해당 카드의 billingAddressChange 직후에 실행됩니다. paymentMethod.type은 card입니다. paymentMethod.card는 구매자가 승인하기 전에 지갑이 카드에 대해 알려 주는 정보를 담습니다. Apple Pay는 funding을 보고하고(Apple은 보통 그때까지 네트워크를 공개하지 않습니다), Google Pay는 network를 보고합니다. paymentMethod.billingAddress는 카드의 일부가 가려진 청구지 주소입니다. 다시 책정하려면 updateWith({ amount, lineItems }), 현재 합계를 유지하려면 updateWith({}), 결제 수단을 거부하려면 updateWith({ errors })로 응답하세요. shippingOptions는 무시됩니다. Apple Pay는 카드의 청구 연락처(지정된 경우 해당 field)에 거부를 표시하고 구매자가 다른 결제 수단을 선택할 때까지 결제 버튼을 보류합니다. Google Pay는 카드에 메시지를 표시하고 구매자가 허용되는 카드를 선택할 때까지 해당 카드에서의 결제 탭을 거부합니다. 거부된 카드는 이 응답이나 그 billingAddressChange 응답이 어떤 가격을 책정했든 합계를 그대로 둡니다. 모든 이벤트에는 정확히 한 번 응답해야 합니다. 예외를 발생시키거나, 거부되거나, 10초 이내에 응답하지 않는 핸들러는 결제 수단을 거부합니다. 각 시트는 구매자가 결제하기 전에 응답을 기다립니다. PayPal은 이를 실행하지 않습니다. 이벤트마다 updateWith(…)를 정확히 한 번 호출하세요. 호출하기 전에 예외를 발생시키거나 거부되는 핸들러는 해당 업데이트를 즉시 실패시킵니다. 구독 해제 함수를 반환합니다.onPromoCodeChange
구매자가 시트의 프로모션 필드(requestPromoCode)에 코드를 입력하거나, 변경하거나, 제거했습니다. 새 합계로 코드를 적용하려면 updateWith({ amount }), 현재 합계로 적용하려면 updateWith({}), 그 자리에서 거부하려면 updateWith({ error })로 응답하세요. 제거는 code가 null인 상태로 도착하며 같은 방식으로 응답합니다. 적용된 코드를 교체하면 제거가 먼저 오지 않고 새 코드와 함께 하나의 이벤트로 도착하며, 거부된 새 코드는 적용된 코드를 그대로 둡니다. shippingOptions가 선택된 옵션을 제외하면 onShippingOptionChange 없이 첫 번째 옵션이 선택되므로, 그 옵션의 가격을 책정하세요. appliedDescription은 Google Pay에서 코드의 설명 문구를 표시합니다. Apple Pay의 쿠폰 필드에는 설명 문구가 없으므로 구매자가 반드시 봐야 하는 내용은 항목 레이블에 넣으세요. 예외를 발생시키거나, 거부되거나, 10초 이내에 응답하지 않는 핸들러는 코드를 거부합니다. 이벤트마다 updateWith(…)를 정확히 한 번 호출하세요. 호출하기 전에 예외를 발생시키거나 거부되는 핸들러는 해당 업데이트를 즉시 실패시킵니다. 구독 해제 함수를 반환합니다.onPaymentAuthorization
구매자가 결제를 승인했으며, 아직 확인 토큰은 존재하지 않습니다. 먼저 승인하거나 거부하려면 구독하세요. 시트는 응답을 기다리며, 핸들러가 없으면 토큰이 즉시 생성됩니다. 이벤트는 결제자, 결제 수단(일부가 가려진 청구지 주소와 displayName의 Visa 1234 같은 지갑 자체 레이블 포함), 배송 주소와 옵션, 구매자가 승인한 합계와 항목을 담고 있습니다. 토큰을 생성하려면 respondWith({ approved: true })로 응답하세요. 그러면 show()와 onConfirmationToken이 평소처럼 토큰을 전달합니다. 거부하려면 respondWith({ approved: false, message })로 응답하세요. 토큰은 생성되지 않으며, Apple Pay와 Google Pay는 시트에 message를 표시하고, 구매자는 무언가를 변경하여 다시 결제하거나 시트를 닫을 수 있습니다. PayPal은 메시지를 표시할 수 없으므로 거부하면 시도가 종료됩니다. show()는 payment_request_refused로 거부되며, 구매자는 PayPal을 다시 누를 수 있습니다. 모든 이벤트에는 정확히 한 번 응답해야 하며, approved: true만 토큰을 생성합니다. 예외를 발생시키거나, 거부되거나, 25초 이내에 응답하지 않는 핸들러는 결제를 거부하며, 이는 Apple Pay와 Google Pay가 자체 30초 제한 전에 거부를 표시할 수 있을 만큼 이른 시점입니다. 이벤트마다 respondWith(…)를 정확히 한 번 호출하세요. 호출하기 전에 예외를 발생시키거나 거부되는 핸들러는 해당 업데이트를 즉시 실패시킵니다. 구독 해제 함수를 반환합니다.onConfirmationToken
시트가 확인 토큰을 생성했으며, 시트가 닫힌 후에 수신됩니다. show()가 반환하는 결과와 같습니다. 구독 해제 함수를 반환합니다.onCancel
구매자가 시트를 닫았거나 PayPal을 닫았습니다. 구독 해제 함수를 반환합니다.Content Security Policy
이 리소스는 프레임이 아닌 페이지에서 실행됩니다. Content Security Policy가 있는 페이지에는 다음 소스가 필요합니다.@whop/elements의 contentSecurityPolicy()는 이 표의 모든 소스를 반환합니다. 샌드박스 소스는 environment: "sandbox"일 때 적용됩니다.
