신규 승인 | Bootpay 커머스 매뉴얼

이 페이지는 구독 > 운영 메뉴에 있어요. 승인 대상인 계약이 어떤 플로우로 만들어지는지 맥락이 필요하면 먼저 구독 계약 개요 · 신청 생성을 봐요.

구독 계약을 승인해요. 승인 후 구독이 활성화되고, 설정된 주기에 따라 자동 결제가 시작돼요.

API 엔드포인트

POSThttps://api.bootapi.com/v1/order_subscriptions/:id/approveBasic Auth

요청 파라미터

파라미터	타입	필수	설명
`id`	String	필수	구독 계약 ID 또는 external_uid (URL 경로)

승인 API는 관리자(supervisor) 권한이 필요해요. Commerce API 인증으로 호출해요.

코드 예제

const { BootpayCommerce } = require('@bootpay/backend-js')

const commerce = new BootpayCommerce({
    client_key: 'your-commerce-client-key',
    secret_key: 'your-commerce-secret-key',
    mode: 'production'
})

const response = await commerce.orderSubscription.approve('687a1b2c3d4e5f6789012345')
console.log(response)javascript

from bootpay_backend import BootpayCommerce

commerce = BootpayCommerce(
    client_key='your-commerce-client-key',
    secret_key='your-commerce-secret-key',
    mode='production'
)

response = commerce.order_subscription.approve('687a1b2c3d4e5f6789012345')
print(response)python

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi("your-commerce-client-key", "your-commerce-secret-key");
$response = $commerce->orderSubscription->approve('687a1b2c3d4e5f6789012345');
print_r($response);php

import kr.co.bootpay.store.BootpayStore;
import kr.co.bootpay.store.model.request.TokenPayload;

TokenPayload tp = new TokenPayload("your-commerce-client-key", "your-commerce-secret-key");
BootpayStore commerce = new BootpayStore(tp);

String response = commerce.orderSubscription.approve("687a1b2c3d4e5f6789012345");
System.out.println(response);java

commerce = BootpayStore::Api.new('your-commerce-client-key', 'your-commerce-secret-key')
response = commerce.order_subscription_approve('687a1b2c3d4e5f6789012345')
puts responseruby

commerce := bootpay.NewCommerceApi("your-commerce-client-key", "your-commerce-secret-key")
response, err := commerce.OrderSubscription.Approve("687a1b2c3d4e5f6789012345")
fmt.Println(response)go

using Bootpay.Commerce;

var commerce = new BootpayCommerceApi("your-commerce-client-key", "your-commerce-secret-key");
var response = await commerce.OrderSubscription.Approve("687a1b2c3d4e5f6789012345");
Console.WriteLine(response);csharp

응답

성공 응답

{
  "id": "687a1b2c3d4e5f6789012345",
  "status": 1,
  "approved_at": "2025-07-11T10:30:00Z",
  "service_start_at": "2025-07-11T10:30:00Z"
}json

응답 필드 설명

필드	타입	설명
`id`	String	구독 계약 고유 ID
`status`	Integer	변경된 구독 상태 (1: 구독 중)
`approved_at`	String	승인 일시
`service_start_at`	String	구독 서비스 시작일

에러 코드

인증·권한 관련 에러는 에러 코드표를 참고해요.

코드	메시지	대처 방법
`ORDER_SUBSCRIPTION_NOT_FOUND`	구독결제 건을 찾을 수 없어요.	order_subscription_id를 확인해요
`ORDER_SUBSCRIPTION_REQUEST_UNABLE`	이미 처리 대기 중인 요청이 있어요. 기존 요청을 먼저 취소하거나 처리 완료 후 다시 시도해요	기존 요청을 먼저 처리해요