01고객 동의
명확한 목적을 가진 액세스
고객은 계정을 연결하는지, AI를 사용하는지 또는 구매를 승인하는지 이해합니다.
다음 상황에서 이를 검증할 수 있습니다.
권한 흐름을 구축하십시오 토큰과 작업은 의도된 계정과 범위를 사용합니다.
SHAREAI로 빌드하기
ShareAI로 결제, 동의에서 결제까지
고객에게 AI 사용, 선택적 요금 및 각 구매에 대한 명확한 선택권을 제공하십시오. 고객이 이해하고 제어할 수 있는 결제 여정을 구축하십시오.
당신이 설계할 경험
ShareAI로 결제명확한 액세스. 수락된 조건. 확인된 구매.
구현하기
설명하고 검증할 수 있는 결제 흐름.
제품과 구현 모두에서 권한, 수락된 조건 및 확인된 결제를 명확히 유지하십시오.
02수락된 조건
따를 수 있는 계약
이해할 수 있는 제안을 게시하고 각 고객이 수락한 버전을 추적하십시오.
다음 상황에서 이를 검증할 수 있습니다.
제안 및 계약 정의 새로운 조건은 기존 고객을 조용히 이동시키지 않습니다.
03확인된 결제
배송 전에 확인
의도된 구매를 하나 생성하고, 결제 상태를 확인한 후 이를 이행하십시오.
다음 상황에서 이를 검증할 수 있습니다.
결제 흐름을 구축하십시오 재시도, 취소, 결제 거부 및 제한이 처리됩니다.
편집기로 가져가기
에이전트와 함께 빌드하세요.
구현 목표, 필요한 입력 및 승인 확인이 포함된 전체 가이드를 복사하세요. 코드 예제, 표 및 문서 링크를 함께 유지하세요.
전체 가이드구현 컨텍스트검증 확인
필요한 형식으로 프로젝트 준비 완료.
업데이트됨
참조를 수동으로 복사하기
고객이 무엇을 결제하는지 선택하십시오
계정 연결, AI 사용 결제 및 제품 구매 확인을 구분할 수 있습니다.
귀하가 작업할 위치 귀하의 제품 → 결제 경험
Pay with ShareAI은 고객이 선택한 ShareAI 계정을 애플리케이션에서 사용할 수 있도록 합니다. 두 가지 별개의 청구 흐름이 있습니다: 승인된 권한 하에서 고객이 자금을 지원하는 AI 요청과 고객이 체크아웃에서 확인하는 제품 구매. 선택적 Builder 마크업은 AI 사용에 대한 추가 계약입니다.
| 고객 작업 | 발생하는 일 | 필요한 접근 권한 |
|---|---|---|
| 지갑 연결 | 선택한 계정과 승인된 약관에 대한 권한을 생성합니다. Connect를 클릭해도 제품이 구매되지 않습니다. | openid 귀하의 앱이 사용하는 기능을 포함하여. |
| AI 요청 보내기 | 승인된 계정의 사용 가능한 AI 크레딧과 승인된 사용 약관을 사용합니다. | 적용 가능한 추론 액세스; monetization_gateway 승인된 Builder 마크업 조건에 대해. |
| 제품 구매 확인 | 승인된 확인 후에만 특정 구매 금액이 차감됩니다. | payments 그리고 성공적인 결제 요청. |
JamZY · 약속 참조 애플리케이션 스크린샷 확대 ↗
- 예약 유형과 기간을 선택하세요.
- 사용 가능한 데모 슬롯을 선택하세요.
- 선택적으로 AI 어시스턴트를 사용하려면 ShareAI을(를) 연결하세요.
- AI는 이 명시적 작업 후에만 실행됩니다. 예약만으로는 ShareAI을(를) 호출하지 않습니다.
JamZY의 약속 샘플은 AI 사용 경로를 보여줍니다. 이는 상점 결제가 없으며, 결제 범위를 요청하지 않으며, 연결이 구독을 구매한다고 주장하지 않습니다. 별도의 경험을 추가할 때 나머지 챕터를 사용하십시오.
계속할 준비가 되었을 때
귀하의 버튼과 제품 복사본은 고객이 연결 중인지, AI를 사용 중인지 또는 구매를 확인 중인지 여부를 나타냅니다.
고객의 권한을 얻으십시오
작업에 계정을 사용하기 전에 의도된 결제 계정으로부터 권한을 얻으십시오.
귀하가 작업할 위치 콘솔 → 사용 사례 → 고객 권한 부여
- 애플리케이션을 생성하고 온보딩, 공개 정보 및 플랫폼 콜백을 완료하십시오. 콘솔에서 관련 사용 사례를 활성화하십시오.
- Builder 마크업에 대해 액세스 요청을 완료하고 필요한 경우 승인을 기다리십시오. 구매의 경우 Pay with ShareAI을 활성화하고 구독에서 필요한 결제-액세스 계약을 구성하십시오.
- Authorization Code + S256 PKCE를 통해 활성화된 범위를 요청하십시오. 제품 체크아웃에는
payments, 네트워크 비용의 AI에는inference, 승인된 AI 마크업에는monetization_gateway를 사용하십시오. 애플리케이션이 실제로 사용하는 기능만 요청하십시오. - 고객이 올바른 개인 또는 조직 계정을 선택하고 표시된 약관을 승인하도록 하십시오. 추가 범위 또는 변경된 약관은 다시 권한 부여가 필요하며, 새로 고침은 이를 부여하지 않습니다.
사용 사례 스크린샷 확대 ↗
- ShareAI으로 로그인 구성을 설정합니다.
- 고객이 자금을 지원하는 사용을 활성화합니다.
클라이언트 ID는 플랫폼을 식별합니다. 액세스 토큰은 승인된 고객 권한을 나타냅니다. 계약 버전은 청구 약관을 기록합니다. 이들 중 어느 것도 특정 제품 결제가 확인되었음을 증명하지 않습니다.
계속할 준비가 되었을 때
토큰은 의도된 고객에게 속하며, 수행하려는 작업에 대한 권한을 포함합니다.
제안에서 AI 요금을 설명하십시오
고객이 검토하고 승인할 수 있는 명확한 사용 약관을 게시하십시오.
귀하가 작업할 위치 애플리케이션 → 구독
구독에서 명확하게 이름이 지정된 제안을 생성하고 추가 AI 요금을 설명하십시오. 구독 ID는 생성되며, 읽기 전용이고 귀하의 애플리케이션에 범위가 지정됩니다. 이러한 제안은 앱의 플랫폼 클라이언트 전반에 공유되므로, 웹과 Android에 대해 별도의 상업적 제안을 유지하지 않습니다.
구독 · 개요 스크린샷 확대 ↗
- 자체 편집기에서 제안을 생성하세요.
구독 · 제안 편집기 스크린샷 확대 ↗
- 고객 대상 제안 이름을 사용하세요.
- 이 제안에 대한 AI
surcharge을(를) 설정하세요.
Estimate를 사용하여 선택한 모델의 네트워크 비용, 추가 요금 및 빌더 수익을 비교하십시오. 검토된 초안을 다음 계약 버전으로 게시하십시오. 고객은 권한 부여 중 해당 버전을 승인합니다. 게시된 제안은 승인된 고객 계약과 동일하지 않습니다.
제품 payments만 필요한 경우, Builder 마크업을 새로 만들지 말고 사용 가능한 무료 결제-액세스 계약 흐름을 사용하십시오. 고정 구독 가격 및 간격은 현재 사용-제안 편집기로 구성되지 않습니다; AI 제안을 자동 반복 청구로 해석하지 마십시오.
계속할 준비가 되었을 때
귀하의 오퍼는 AI 비용에 추가되는 내용을 정확히 설명합니다. 고객 동의 화면에는 동일한 게시된 약관이 표시됩니다.
세부 정보가 필요하신가요?변경 불가능한 청구 계약 ↗
고객이 새로운 조건을 선택할 수 있도록 하십시오
각 계정이 수락한 약관을 추적하면서 새 계약을 도입하게 됩니다.
귀하가 작업할 위치 구독 → 계약
다음 계약 초안에서 변경 사항을 준비하십시오. 기존 권한은 고객이 대체 계약을 수락할 때까지 수락된 구독 및 버전을 유지합니다. 모든 계정이 최신 버전을 사용한다고 가정하지 말고 구독 개요에서 계정 수와 분포를 비교하십시오.
구독 · 계약 스크린샷 확대 ↗
- 게시된 계약 버전을 검토하세요.
변경 사항을 고객에게 알리고 필요한 경우 새 버전을 수락하도록 동의 흐름을 통해 안내하십시오. 새로 고침된 토큰은 동의를 생성할 수 없습니다. 수락된 계약을 유지하는 것이 기본 전환입니다. 추가 작업 전에 새 약관에 대한 동의를 요구하도록 선택하면 고객이 새 약관을 승인할 때까지 기존 액세스가 의도적으로 중단됩니다. 게시 전에 해당 영향을 검토하십시오. 허용된 감소는 수락된 계약의 규칙을 따라야 하며, 요금 인상은 고객의 승인이 필요합니다.
애플리케이션 수준 보기와 ID 경계를 분리하십시오. 상업적 개요가 애플리케이션 전체를 집계하더라도 플랫폼별 고객 식별자는 클라이언트 컨텍스트에 범위가 지정된 상태로 유지됩니다.
계속할 준비가 되었을 때
각 계정이 어떤 계약을 수락했는지 식별하고 다음 계약으로 이동하는 방법을 설명할 수 있습니다.
구매를 확인한 후 이를 이행하십시오
하나의 의도된 구매를 생성하고 확인을 얻은 후 결제를 확인한 다음 배송하십시오.
귀하가 작업할 위치 귀하의 백엔드 → ShareAI 체크아웃 → 결제 확인
이 장에서는 별도의 제품 구매를 포함한 약속 예제를 확장합니다. 결제를 활성화하고 해당 범위로 고객 토큰을 얻은 후에만 실행하십시오. 주문 및 결제 상태를 귀하의 백엔드에 유지하십시오.
# Real payment request: use scoped test access and an intentional amount.
curl --fail-with-body 'https://api.shareai.now/api/v1/console/builder/payments' \
-H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: YOUR_UNIQUE_ORDER_REFERENCE' \
--data '{"title":"JamZY appointment preparation pack","amount":"1.00"}'- 반환된 결제 ID와 체크아웃 URL을 주문과 함께 저장하십시오. 정확한 소수점 금액 문자열을 사용하고 부동 소수점 금액 계산을 피하십시오.
- 반환된 체크아웃 URL을 엽니다. ShareAI는 구매 및 지불자를 표시합니다. 고객은 귀하의 앱을 승인한 계정을 사용하여 확인해야 합니다. 체크아웃을 열어도 금액이 차감되지 않습니다.
- 동일한 고객 권한으로 API에서 결제를 읽습니다. 상태가 'paid'로 확인된 후에만 주문을 이행하십시오.
- 동일한 idempotency 키로 동일한 의도된 구매를 다시 시도하십시오. 다른 구매는 새 키가 필요합니다. 변경된 조건에 대해 키를 재사용하지 마십시오.
curl --fail-with-body --get \
'https://api.shareai.now/api/v1/console/builder/payments' \
-H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
--data-urlencode "id=$SHAREAI_PAYMENT_ID"| 결제 상태 | 귀하의 제품이 수행해야 할 작업 |
|---|---|
| 대기 중 | 고객 확인이 여전히 필요함을 표시하십시오. 아직 이행하지 마십시오. |
| 지급받고 | 서버의 주문과 대조한 후 한 번만 이행하십시오. |
| 거부됨 | 결정을 존중하고 고객이 다른 구매를 시도할지 선택하도록 하십시오. |
| 만료됨 | 고객이 다시 시도하려는 경우 새 idempotency 키로 새 요청을 생성하십시오. |
신뢰할 수 있는 API에서 반환된 checkout URL만 사용하고, 통합의 허용된 목적지 정책에 따라 이를 검증하십시오. 앱으로 돌아가는 성공 메시지는 결제 증거가 아닙니다. 결제자는 자신의 Builder 계정에서 구매할 수 없습니다.
기존의 고정 가격 구독 계약을 지원하는 경우, 결제 API는 명시적으로 확인된 기간 동안 해당 계약의 승인된 조건을 사용할 수 있습니다. 임의로 생성된 반복 가격을 보내거나 새로운 기간을 조용히 청구하지 마십시오. JamZY의 다운로드 가능한 약속 샘플은 해당 확장을 구현하지 않습니다.
계속할 준비가 되었을 때
백엔드에서 결제가 확인될 때까지 주문은 전달되지 않으며, 확인 흐름을 반복해도 동일한 주문을 두 번 전달하거나 청구할 수 없습니다.
세부 정보가 필요하신가요?결제 엔드포인트 & 응답 참조 ↗
고객이 결제 문제를 복구할 수 있도록 돕습니다
중복 청구나 예상치 못한 계정 변경 없이 신용 한도와 연결 해제를 처리하십시오.
귀하가 작업할 위치 귀하의 애플리케이션 → 청구 복구
AI 사용과 제품 구매는 서로 다른 적격 크레딧 규칙을 가집니다. 계정에는 제품 결제에 사용할 수 없는 AI 적격 크레딧이 있을 수 있습니다. API 오류와 고객 청구 목적지를 사용하여 자금 부족 및 애플리케이션별 지출 한도를 처리하십시오.
고객에게 선택한 결제 계정, 실패한 작업 및 크레딧이나 한도를 관리할 경로를 보여주십시오. 고객은 자신의 한도를 제어하며, 앱 소유자는 이를 올릴 수 없습니다. 청구를 성공시키기 위해 조직 계정에서 개인 계정으로 조용히 전환하지 마십시오.
고객 스크린샷 확대 ↗
- 고객 관리는 애플리케이션에 대해 통합됩니다.
연결 해제는 관련 권한을 취소하고 로컬 세션을 지워야 합니다. 이는 향후 승인된 요청을 중단하며, 이미 확인된 구매를 취소하거나 별도의 유료 약정을 자동으로 취소하지 않습니다. 새로 고침 실패, 권한 취소 및 결제 만료는 별도의 복구 메시지가 필요합니다.
계속할 준비가 되었을 때
크레딧 부족 및 한도 오류는 고객에게 정보를 제공하고 제어권을 유지하며, 중복 주문이나 결제자 변경이 발생하지 않도록 합니다.
전체 결제 여정을 확인하십시오
플랫폼을 게시에 포함하기 전에 성공 경로와 실패 사례를 테스트하십시오.
귀하가 작업할 위치 OAuth 설정 → 검증
애플리케이션 전체 테스터 명단과 Builder와 다른 적격 결제 계정을 사용하십시오. 대기 중인 초대를 포함하여 최대 다섯 개의 테스터 자리가 있습니다. 게시에 포함된 모든 플랫폼에 대해 실제 엔드포인트 및 범위 검증을 완료하십시오.
웹 · 검증 스크린샷 확대 ↗
- Console은 실제 엔드포인트 성공을 기록합니다.
- 요청된 모든 범위는 또한 실행되어야 합니다.
- 승인된 권한 및 취소된 권한을 테스트하고, 선택된 고객/계정 경계를 확인하십시오.
inference또는monetization_gateway에 대한 성공적인 범위 지정 AI 요청과payments에 대한 성공적인 결제 API 호출을 테스트하십시오. 결제 요청은 차감 없이 보류 중일 수 있습니다; 전체 체크아웃 테스트는 명시적 확인 및 결제를 추가로 검증합니다.- 중복 요청, 거부 및 만료된 checkout, 적격 크레딧 부족, 계정 지출 한도, 만료된 토큰, 새로 고침 회전 및 취소된 권한을 테스트하십시오.
- 고객, 구독 및 분석에서 결과 고객, 승인된 조건 및 귀속된 활동을 확인하십시오. 민감한 자격 증명 및 내부 조직 ID가 고객 UI에 표시되지 않도록 확인하십시오.
- 구성 및 기록된 검사가 통과된 플랫폼만 포함하십시오. 완료되지 않은 플랫폼은 제외하거나 제거한 후, Dashboard에서 앱을 제출하십시오.
계속할 준비가 되었을 때
귀하의 통합은 승인된 액세스, 승인된 약관, 요청된 결제 및 확인된 결제를 구분하며, 각각의 실패 경로를 처리합니다.
조직 검증 및 프로그램 액세스
프로그램 등록을 소유할 개인 또는 조직 계정을 신청 전에 선택하세요. 조직은 검증 전에 신청서를 제출할 수 있지만, 직원 승인만으로는 접근이 활성화되지 않습니다. Console의 온보딩 체크리스트에서 조직 이메일 및 회사 검증을 완료하세요. 승인된 조직은 두 가지 검증이 완료될 때까지 "검증 대기 중" 상태로 유지됩니다. Builder, Provider 및 Creator 프로그램은 이 규칙을 따릅니다.
Monetization Gateway 가격 책정 보기 · ShareAI for Startups을 탐색하세요 · 범위 및 권한
권한 및 승인된 조건
귀하의 공개 약관, 개인정보 보호정책 및 삭제 지침은 애플리케이션과 일치해야 하며 로그인 없이 접근 가능해야 합니다. ShareAI 프로그램 수락, Monetization Gateway 승인, 고객의 OAuth 권한 및 승인된 청구 계약은 별도의 결정 사항입니다. 새로 고침은 권한을 추가하거나 새로운 상업적 조건을 수락할 수 없습니다.
기존 통합을 위해 레거시 surcharge 범위가 여전히 허용됩니다. 새로운 예제는 monetization_gateway을 사용합니다. surcharge_bps 및 surcharge_percentage와 같은 기존 와이어 필드는 변경하지 마십시오.
Monetization Gateway 가격 책정 보기 · ShareAI for Startups을 탐색하세요 · 범위 및 권한
게이트웨이 비용 및 Startup 지원
표준 요금은 5%의 Builder 마크업입니다. AI 네트워크 비용의 €2.00와 10% 마크업에 대해 고객은 €2.20를 지불합니다. ShareAI는 €0.01의 €0.20 마크업을 받습니다. Builder는 Event Ingestion 이전에 €0.19를 보유합니다.
매달 첫 번째 1,000 정산된 Production Monetization Gateway 요청은 Builder 계정 전체에서 무료로 제공됩니다 (UTC 기준). 추가 요청은 적격 할인 적용 전 €0.04당 1,000의 비용이 발생합니다. 하나의 정산된 요청은 하나의 이벤트를 생성합니다.
Pay with ShareAI 단독으로, inference-전용 접근, 일반 계정 API 키 및 스테이징 또는 테스트 트래픽은 Monetization Gateway 이벤트 수집 비용이 발생하지 않습니다.
ShareAI for Startups는 승인된 애플리케이션에 대한 실제 ShareAI 비용에 대해 공유 월간 할당을 제공합니다. 현재 Launch, Growth 및 Momentum 등급은 월별로 €1,000, €5,000, €10,000를 나열합니다. 동일한 예산은 ShareAI의 비율 비용과 Builder 마크업 및 청구 가능한 이벤트 수집을 함께 포함합니다. 이는 총 마크업 할당, 별도의 무료 이벤트 할당량 또는 무료 AI inference가 아닙니다. 계정의 첫 번째 1,000 무료 이벤트는 이를 소비하지 않습니다.
남은 이벤트 수집 비용은 요청의 새로운 Builder 수익에서 지불되며, 이후 사용 가능한 Builder AI 수익 및 제한 없는 AI 크레딧에서 지불됩니다. 고객 AI 비용 및 제품 payments는 별도로 유지됩니다.
ShareAI는 고정 기간 동안 또는 변경될 때까지 애플리케이션별 비용 또는 비용 지원을 승인할 수 있습니다. Console에서 애플리케이션의 현재 가격 및 특별 프로그램을 검토하여 승인된 조건, 유효성 및 소비된 할당량을 확인하십시오. 등급 변경 또는 가격 재정의는 애플리케이션의 월간 사용량을 초기화하지 않습니다.
Launch는 ShareAI로 로그인 옵션을 유지합니다. Growth 및 Momentum은 이를 요구하며, Momentum은 애플리케이션 하단에 공식 ShareAI for Startups 배지를 추가로 요구합니다. ShareAI는 배지를 주간으로 확인합니다. 요구 사항을 우회하려는 시도가 확인되면 Startup Program에서 강등, 제거 또는 Marketplace에서 철회될 수 있습니다.
엔터프라이즈 요율은 ShareAI 팀이 Builder 계정을 위해 맞춤형 제안을 동의한 후 구성됩니다. 할당된 비율 및 이벤트 요율은 향후 요청에 적용됩니다.
Monetization Gateway 가격 책정 보기 · ShareAI for Startups을 탐색하세요 · 범위 및 권한