재개 | Bootpay 커머스 매뉴얼

일시정지된 구독을 재개해요. 재개 후 다음 결제 주기부터 자동 결제가 다시 시작돼요.

API 엔드포인트

POSThttps://api.bootapi.com/v1/order_subscriptions/requests/ing/resumeBasic Auth

요청 파라미터

파라미터	타입	필수	설명
`order_subscription_id`	String	필수	구독 계약 고유 번호
`reason`	String	선택	재개 요청 사유

코드 예제

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.requestResume({
    order_subscription_id: '687a1b2c3d4e5f6789012345',
    reason: '일시정지 사유 해소로 재개 요청'
})
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.request_resume(
    order_subscription_id='687a1b2c3d4e5f6789012345',
    reason='일시정지 사유 해소로 재개 요청'
)
print(response)python

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi("your-commerce-client-key", "your-commerce-secret-key");
$response = $commerce->orderSubscription->requestResume([
    'order_subscription_id' => '687a1b2c3d4e5f6789012345',
    'reason' => '일시정지 사유 해소로 재개 요청'
]);
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);

HashMap<String, Object> params = new HashMap<>();
params.put("order_subscription_id", "687a1b2c3d4e5f6789012345");
params.put("reason", "일시정지 사유 해소로 재개 요청");

String response = commerce.orderSubscription.requestResume(params);
System.out.println(response);java

commerce = BootpayStore::Api.new('your-commerce-client-key', 'your-commerce-secret-key')
response = commerce.order_subscription_request_resume(
  order_subscription_id: '687a1b2c3d4e5f6789012345',
  reason: '일시정지 사유 해소로 재개 요청'
)
puts responseruby

commerce := bootpay.NewCommerceApi("your-commerce-client-key", "your-commerce-secret-key")
response, err := commerce.OrderSubscription.RequestResume(bootpay.OrderSubscriptionRequestResumeParams{
    OrderSubscriptionID: "687a1b2c3d4e5f6789012345",
    Reason:              "일시정지 사유 해소로 재개 요청",
})
fmt.Println(response)go

using Bootpay.Commerce;

var commerce = new BootpayCommerceApi("your-commerce-client-key", "your-commerce-secret-key");
var response = await commerce.OrderSubscription.RequestResume(new {
    order_subscription_id = "687a1b2c3d4e5f6789012345",
    reason = "일시정지 사유 해소로 재개 요청"
});
Console.WriteLine(response);csharp

응답

성공 응답

{
  "id": "687a1b2c3d4e5f6789012345",
  "status": 1,
  "request_type": 2,
  "resumed_at": "2025-08-15T10:00:00Z"
}json

응답 필드 설명

필드	타입	설명
`id`	String	구독 계약 고유 ID
`status`	Integer	변경된 구독 상태 (1: 구독 중)
`request_type`	Integer	요청 타입 (2: 재개)
`resumed_at`	String	재개 시각

에러 코드

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

코드	메시지	대처 방법
`ORDER_SUBSCRIPTION_RESUME_UNABLE`	현재 일시정지 상태가 아니므로 재개할 수 없어요	구독 상태를 확인해요
`SUBSCRIPTION_RESUME_REASON_REQUIRED`	재개 사유를 입력해야 해요.	reason 파라미터를 입력해요

재개는 구독 상태가 일시정지(2)일 때만 가능해요.