Google Pay API를 사용한 가맹점 주도 거래에 대한 새로운 개선 사항
Source: Google Developers Blog
Google Pay API의 새로운 향상 기능
우리는 Google Pay API에 대한 새로운 향상 기능을 발표하게 되어 기쁩니다. 이번 업데이트를 통해 가맹점이 시작하는 거래(MIT)에 대한 유연성과 제어력을 더욱 높일 수 있게 되었습니다. 이러한 업데이트를 통해 개발자는 구독, 연기 결제, 자동 충전 등 다양한 사용 사례에 대해 원활하고 안전한 결제 경험을 제공할 수 있습니다.
Google Pay API는 기존에도 가맹점이 시작하는 거래를 지원했지만, 기존 사양은 주로 즉시 고객이 시작하는 거래(CIT)를 위해 설계되었습니다. 따라서 향후 청구에 대한 가맹점의 의도를 API 요청에 완전히 반영하기 어려웠습니다.
새로운 향상 기능을 통해 이제 향후 결제 조건을 명확히 정의할 수 있어 사용자에게 투명성을 제공하고 처리 과정을 원활하게 만들 수 있습니다. 이번 업데이트는 세 가지 주요 MIT 카테고리에 초점을 맞추고 있습니다:
- 반복 거래: 구독이나 사용자가 정기적으로 청구되는 모든 시나리오에 이상적입니다. 소개 기간, 청구 빈도(일간, 주간, 월간, 연간), 고정 또는 변동 금액, 반복 기간 등을 지정할 수 있습니다.
- 연기 거래: 호텔 예약이나 사전 주문과 같이 결제 승인은 미리 이루어지지만 실제 청구는 미래의 특정 시점에 이루어지는 상황에 유용합니다. 이제 연기 청구의 정확한 날짜와 시간을 지정할 수 있습니다.
- 자동 충전 거래: 사용자의 계정 잔액이 일정 임계값 이하로 떨어질 때 자동으로 충전되는 서비스에 적합합니다. 최소 잔액 트리거와 충전 금액을 정의할 수 있습니다. 참고: 청구 계약에 따라 사용자를 청구하는 책임은 여전히 가맹점에 있습니다.
개발자 및 사용자에게 제공되는 혜택
- 투명성 향상: 사용자는 Google Pay 인터페이스에 표시되는 향후 결제 일정에 대해 더 명확히 이해할 수 있습니다.
- 유연성 강화: 즉시 결제 외에도 다양한 청구 모델을 지원합니다.
- 거절 감소: 거래를 상점 주도형으로 명확히 표시하고 토큰 업데이트 메커니즘을 활용하면 결제 거절을 줄일 수 있습니다.
- 보안 토큰 관리:
tokenUpdateUrl은 카드 만료와 같은 결제 자격 증명 업데이트 알림을 받아 정기 결제 서비스가 중단되지 않도록 도와줍니다. - 미래 대비 및 규정 준수: Google Pay는 올바른 토큰 유형을 제공하여 최적의 거래 성능을 보장하고 향후 네트워크 요구 사항을 충족합니다.
Source: …
주요 API 변경 사항
새로운 사용 사례를 지원하기 위해 PaymentDataRequest에 새로운 객체들을 도입했습니다:
recurringTransactionInfo– 정기 결제 일정에 대해 설명합니다.deferredTransactionInfo– 향후 일회성 결제에 대한 세부 정보를 제공합니다.automaticReloadTransactionInfo– 잔액 기반 자동 충전을 구성합니다.
이 객체들을 사용하면 향후 거래에 대한 세부 정보를 구체적으로 제공할 수 있습니다. 예를 들어 recurringTransactionInfo 내에서는 다음과 같이 지정할 수 있습니다:
introductoryPeriodInfo– 체험 기간 또는 특별 소개 가격에 대한 세부 정보.recurrenceItems– 각각 고유한 가격, 상태, 기간을 가진 하나 이상의 정기 기간을 설명하는 배열.price– 고정된 경우 전체 정기 결제에 대한 총 금액.managementUrl– 사용자가 정기 결제를 관리할 수 있는 링크.tokenUpdateUrl– Google이 토큰 수명 주기 이벤트 알림을 전송하는 웹훅 URL.
예시: 간단한 월간 구독
{
"apiVersion": 2,
"apiVersionMinor": 0,
"allowedPaymentMethods": [
{
"type": "CARD"
// ... other card parameters
}
],
"recurringTransactionInfo": {
"label": "Monthly Subscription",
"transactionId": "SUB12345",
"recurrenceItems": [
{
"label": "Regular Charge",
"price": "9.99",
"priceStatus": "FINAL",
"recurrencePeriod": {
"unit": "MONTH",
"count": 1
}
}
],
"managementUrl": "https://example.com/subscriptions",
"tokenUpdateUrl": "https://example.com/api/token-updates"
}
}시작하기
These new Merchant Initiated Transaction features are now available. We encourage you to review the updated API reference documentation for complete details on the new objects and properties.
We believe these enhancements will empower developers to build even more robust and user‑friendly payment solutions with the Google Pay API.