사용자가 결제할 수 있도록 하려면 네이티브 결제 통합을 구현해야 합니다. 여기에는 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과 같은 지원되는 인증 방법을 비롯하여 네이티브 결제 API 엔드포인트를 보호하는 방법에 관한 자세한 내용은 인증 및 보안 가이드를 참고하세요.
개발자 도구
네이티브 결제 API 구현을 지원하기 위해 Universal Commerce Protocol GitHub 저장소에서 다음 리소스를 찾을 수 있습니다.
- UCP GitHub 저장소: 포괄적인 문서, 사양, 커뮤니티 리소스를 보려면 기본 저장소 를 살펴보세요.
- SDK: 소프트웨어 개발 키트를 사용하여 통합을 가속화합니다. 다음과 같은 언어별 SDK를 사용할 수 있습니다.
규정 준수 테스트: 규정 준수 테스트 도구 모음을 사용하여 API 엔드포인트가 UCP 사양을 준수하는지 확인합니다.규정 준수 테스트 도구 모음
이렇게 하면 구현이 필요한 표준 및 동작을 충족할 수 있습니다.
이러한 도구를 사용하여 개발 및 테스트 절차를 간소화하는 것이 좋습니다.
서비스 수준 목표
다음 서비스 수준 목표 (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 페이로드 및 기술 구현 세부정보를 확인합니다.