Microsoft 상업용 마켓플레이스에서의 SaaS 주문 처리 API
SaaS 처리 API를 사용하면 ISV(독립 소프트웨어 공급업체)라고도 하는 게시자가 Microsoft AppSource, Azure Marketplace 및 Azure Portal에서 SaaS 애플리케이션을 게시하고 판매할 수 있습니다. 이러한 API를 사용하면 ISV 애플리케이션이 직접, 파트너 주도(재판매인) 및 현장 주도의 모든 상거래 지원 채널에 참여할 수 있습니다. 이러한 API와 통합하는 것은 파트너 센터에서 거래 가능한 SaaS 제품을 만들고 게시하기 위한 요구 사항입니다.
SaaS 처리 API에 대해 알아보려면 다음 문서도 읽어보는 것이 좋습니다.
API 흐름
ISV는 ISV와 Microsoft 모두에 대해 동일한 구독 상태를 유지하려면 SaaS 서비스 코드에 추가하여 다음 API 흐름을 구현해야 합니다.
- 방문 페이지 흐름: Microsoft는 게시자의 SaaS 제품이 마켓플레이스의 고객이 구매했음을 게시자에 알렸습니다.
- 정품 인증 흐름: 게시자는 새로 구매한 SaaS 계정이 게시자 쪽에서 구성되었음을 Microsoft에 알렸습니다.
- 업데이트 절차: 구매한 플랜의 변경 또는 구매한 좌석 수 또는 둘 다.
- 흐름일시 중단 및 복구: 고객의 결제 방법이 더 이상 유효하지 않은 경우 구매한 SaaS 제품을 일시 중단합니다. 결제 방법 문제가 해결되면 일시 중단된 제품을 복구할 수 있습니다.
- 웹후크 흐름: Microsoft는 Microsoft 측에서 고객이 실행한 SaaS 구독 변경 및 취소에 대해 게시자에게 알립니다.
구매한 SaaS 구독 취소의 경우 Microsoft 쪽에서 고객이 수행할 수 있으므로 통합은 선택 사항입니다.
SaaS 처리 API와의 올바른 통합은 다음을 확인하는 데 중요합니다.
- 게시자의 SaaS 제품을 구매한 최종 고객은 Microsoft에서 올바르게 청구됩니다.
- 최종 고객은 마켓플레이스에서 구매한 SaaS 구독을 구매, 구성, 사용 및 관리하는 올바른 사용자 환경을 얻게 됩니다.
이러한 API를 사용하면 게시자의 제품이 모든 상거래 사용 채널에 참여할 수 있습니다.
- 직접적
- 파트너 주도(재판매인, 클라우드 솔루션 공급자 [CSP])
- 현장 주도
CSP(재판매인) 시나리오에서 CSP는 최종 고객을 대신하여 SaaS 제품을 구매합니다. 고객은 SaaS 제품을 사용해야 하지만 CSP는 다음 작업을 수행하는 엔터티입니다.
- 고객에게 요금을 청구
- 구독 플랜 변경/구매한 좌석 수 변경
- 구독을 취소합니다.
게시자는 이 시나리오에 대해 API 호출 흐름을 다르게 구현할 필요가 없습니다.
자세한 내용은 CSP(클라우드 솔루션 공급자)참조하세요.
중요하다
SaaS 처리 API 버전 1은 더 이상 사용되지 않습니다. 대신 V2를 사용합니다. V1은 현재 기존 게시자를 위해만 유지 관리되고 있으며 V1에 대한 설명서는 더 이상 사용할 수 없습니다. 액세스해야 한다고 생각되면 saas-api-v1@microsoft.com이메일을 보낼 수 있습니다.
메모
SaaS 처리 API는 게시자의 백 엔드 서비스에서만 호출됩니다. 게시자의 웹 페이지에서 직접 API와의 통합은 지원되지 않습니다. 서비스-서비스 인증 흐름만 사용해야 합니다.
관련 콘텐츠
- 아직 등록하지 않은 경우 Microsoft Entra Application 등록하기설명한 대로 Azure Portal SaaS 애플리케이션을 등록합니다.
- 그런 다음 개발을 위해 이 인터페이스의 최신 버전을 사용하십시오: SaaS 처리 구독 API v2 그리고 SaaS 처리 작업 API v2.
비디오 자습서