사용자가 결제할 수 있도록 하려면 네이티브 결제 통합을 구현해야 합니다. 여기에는 Google이 서버를 사용하여 결제 절차를 프로그래매틱 방식으로 관리할 수 있는 표준 REST API를 만드는 작업이 포함됩니다. 이 방법을 사용하면 사용자에게 가장 원활한 환경을 제공할 수 있습니다. 처음에는 Google에서 구매자의 사용자 인터페이스를 렌더링하며, 향후 더 많은 에이전트 경험을 지원할 계획입니다.
결제 절차
네이티브 통합을 사용하려면 Google에서 호출하여 결제 세션을 만들고 관리할 수 있는 RESTful API를 빌드해야 합니다.
전체 흐름은 다음과 같습니다.
- 결제 세션 빌드: 사용자와 선택적으로 에이전트가 세션에 상품을 추가하는 루프에 있습니다.
- Google UI로 핸드오프: 사용자가 에이전트를 확인하기로 결정하면 (참여한 경우) 제어를 Google UI에 전달합니다 (결제 세션 데이터 전달).
- 수동 결제: 이제 사용자는 Google UI와만 상호작용하여 민감한 주문 처리 및 결제 세부정보를 입력하고 주문을 제출합니다. 에이전트는 이 부분에 관여하지 않으므로 결정론이 보장됩니다.
- 완료 및 반환: Google UI에 주문을 확인하는 '감사합니다' 페이지가 표시됩니다. 선택적으로 사용자를 상담사로 다시 리디렉션할 수 있습니다. 상담사는 이미 구매 완료 알림을 받았을 수 있습니다.
결제 세션 상태 수명 주기
사용자가 결제 흐름을 진행하면 현재 상태를 반영하도록 결제 세션 status을 업데이트해야 합니다. 세션은 다음 수명 주기를 거칩니다.
incomplete: 세션이 생성될 때의 초기 상태입니다. 이는 필수 정보 (예: 배송 방법, 세금 또는 사용자 세부정보)가 누락되었거나 계산되지 않았음을 나타냅니다.ready_for_payment: 사용자가 배송 주소를 업데이트하고 판매자가 배송 옵션과 총계를 계산한 후 결제 수단이 확정되기 전에 사용할 상태입니다.ready_for_complete: 결제 수단이 선택되고 모든 주문 세부정보가 검증된 후 전체 결제 객체 하이드레이션 중에 사용할 상태입니다.completed: 결제를 성공적으로 처리하고 주문을 완료한 후 반환되는 최종 상태입니다.canceled: 결제 세션이 중단된 경우 반환되는 상태입니다.error: 복구할 수 없는 비즈니스 로직 오류로 인해 결제가 차단되는 경우 반환되는 상태입니다. 이 상태는 UCP 버전2026-04-08이상에서 사용할 수 있습니다.
다중 상품 결제 절차:
이제 Google에서는 단일 결제 세션에서 여러 고유 광고 항목을 지원합니다. 일반적인 흐름은 다음과 같습니다.
- 사용자가 UCP 지원 인터페이스에서 결제를 시작합니다 (예: 제품에서 '지금 구매'를 클릭).
line_items배열의 모든 고유 항목을 포함하여POST /checkout-sessions호출이 이루어집니다.line_items배열에는 결제되는 각 고유 상품에 대한 별도의 객체가 포함됩니다.- 사용자는
PUT /checkout-sessions/{id}호출을 사용하여 결제 수단, 주문 처리 세부정보를 업데이트하거나 할인을 적용할 수 있습니다. - 사용자가 'GPay로 결제' 버튼을 클릭하면
POST /checkout-sessions/{id}/complete호출이 이루어집니다.
인증
API 키 및 OAuth 2.0과 같은 지원되는 인증 방법을 비롯하여 Native Checkout API 엔드포인트를 보호하는 방법에 관한 자세한 내용은 인증 및 보안 가이드를 참고하세요.
개발자 도구
Native Checkout API 구현을 지원하기 위해 범용 커머스 프로토콜 GitHub 저장소에서 다음 리소스를 확인할 수 있습니다.
- UCP GitHub 저장소: 기본 저장소에서 포괄적인 문서, 사양, 커뮤니티 리소스를 살펴보세요.
- SDK: 소프트웨어 개발 키트를 사용하여 통합을 가속화하세요. 다음과 같은 언어별 SDK를 사용할 수 있습니다.
적합성 테스트: 적합성 테스트 모음을 사용하여 UCP 사양에 대해 API 엔드포인트를 검증합니다.
이렇게 하면 구현이 필수 표준 및 동작을 충족하는지 확인할 수 있습니다.
이러한 도구를 사용하여 개발 및 테스트 프로세스를 간소화하는 것이 좋습니다.
서비스 수준 목표
다음 서비스 수준 목표 (SLO)는 네이티브 결제 REST API 엔드포인트에 적용됩니다. Google과 통합하는 비즈니스는 API 성능 및 가용성에 관한 이러한 목표를 충족해야 합니다.
| 엔드포인트 | 가용성 | 지연 시간 (50번째 백분위수) | 지연 시간 (95번째 백분위수) |
|---|---|---|---|
POST /checkout-sessions(만들기) |
>= 95% | 1초 이하 | 4초 이하 |
PUT /checkout-sessions/{id} (업데이트) |
>= 95% | 1초 이하 | 5초 이하 |
POST /checkout-sessions/{id}/complete (완료) |
>= 95% | 6초 이하 | 10초 이하 |
50번째 백분위수 지연 시간은 요청의 50% 이상이 이 시간 내에 완료될 것으로 예상됨을 나타냅니다. 95번째 백분위수 지연 시간은 요청의 95% 이상이 이 시간 내에 완료될 것으로 예상됨을 나타냅니다.
다음 단계
UCP 버전의 결제 API 페이로드 및 기술 구현 세부정보를 확인하세요.
서드 파티 서비스 제공업체로 통합하는 경우 UCP 결제 서비스 설정으로 이동하여 판매자 프로필을 호스팅하고 계정 관계 핸드셰이크를 구성합니다.