통합 결제 설정

기업 그룹(UserGroup)에 통합 결제를 설정하면, 사용 중인 모든 구독 요금이 주 단위 또는 월 단위로 정산되어 한 번에 청구됩니다.

통합 결제 특징

상품별로 청구 주기(주/월)를 설정할 수 있으며, 설정된 주기에 따라 통합 청구됩니다.
통합 결제는 후불로 청구되기 때문에 별도의 리스크 관리가 필요합니다.
구매 한도 설정을 통해 리스크를 관리할 수 있습니다.

결제일 권장 값

월 결제일: 1~21일 사이를 권장합니다. (권장: 1, 5, 10, 13, 18, 21)
주 결제일: 토요일, 일요일은 지원하지 않습니다. (1:월, 2:화, 3:수, 4:목, 5:금)

PUT

https://api.bootapi.com/v1/user-groups/:user_group_id/aggregate-transaction

SDK 설치

Server

서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.

SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.

API 요청

Server

통합 결제 설정 정보를 담아 PUT 요청을 보냅니다.

요청 필드

use_subscription_aggregate_transactionboolean통합 결제 사용 여부
subscription_month_dayinteger월 단위 결제일 (1~21 권장)
subscription_week_dayinteger주 단위 결제일 (1:월 ~ 5:금)

응답 처리

Server

성공 시 설정된 통합 결제 정보가 반환됩니다.

응답 필드

use_subscription_aggregate_transactionboolean통합 결제 사용 여부
subscription_month_dayinteger월 단위 결제일
subscription_week_dayinteger주 단위 결제일
http_statusintegerHTTP 상태 코드

에러 코드

USER_GROUP_NOT_FOUND

그룹을 찾을 수 없습니다.

user_group_id를 확인하거나 그룹 목록에서 조회하세요.

USER_GROUP_NOT_AUTHORIZED

그룹에 대한 접근 권한이 없습니다.

토큰의 권한을 확인하거나 admin 권한으로 재시도하세요.

언어

const { BootpayCommerce } = require('@bootpay/backend-js'); const commerce = new BootpayCommerce({    client_key: '{client_key}',    secret_key: '{secret_key}',    mode: 'development' // 또는 'production'}); const userGroupId = '67e2052b03d0cb4e4117b0af';const response = await commerce.userGroup.aggregateTransaction(userGroupId, {    use_subscription_aggregate_transaction: true,    subscription_month_day: 15,  // 매월 15일    subscription_week_day: 3     // 매주 수요일});console.log(response);