취소 요청 승인 | Bootpay 커머스 매뉴얼

취소 요청을 승인해 환불과 상태 전이를 같은 흐름으로 끝내요.

고객 또는 시스템이 요청한 결제 취소 요청을 관리자가 승인하는 API예요. 승인이 완료되면 실제 결제 취소 처리가 진행돼요.

API 엔드포인트

PUThttps://api.bootapi.com/v1/order/cancel/:id/approveBasic Auth

이 API는 관리자(supervisor) 권한이 필요해요. 일반 사용자 토큰으로는 호출할 수 없어요.

요청 파라미터

파라미터	타입	필수	설명
`order_cancel_request_history_id`	String	필수	취소 요청 고유 번호 (URL 파라미터)
`message`	String	선택	관리자 승인 메시지 (내부 관리용)

코드 예제

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

const commerce = new BootpayCommerce({
    client_key: '{client_key}',
    secret_key: '{secret_key}'
});

const response = await commerce.orderCancel.approve({
    order_cancel_request_history_id: '687a1b2c3d4e5f6789012345',
    message: '취소 요청이 승인되었습니다.'
});
console.log(response);javascript

from bootpay_backend.commerce import BootpayCommerce

commerce = BootpayCommerce('{client_key}', '{secret_key}')
response = commerce.order_cancel.approve({
    'order_cancel_request_history_id': '687a1b2c3d4e5f6789012345',
    'message': '취소 요청이 승인되었습니다.'
})
print(response)python

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi('{client_key}', '{secret_key}');
$response = $commerce->orderCancel->approve([
    'order_cancel_request_history_id' => '687a1b2c3d4e5f6789012345',
    'message' => '취소 요청이 승인되었습니다.'
]);
print_r($response);php

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

TokenPayload tp = new TokenPayload("{client_key}", "{secret_key}");
BootpayStore commerce = new BootpayStore(tp);
HashMap<String, Object> params = new HashMap<>();
params.put("order_cancel_request_history_id", "687a1b2c3d4e5f6789012345");
params.put("message", "취소 요청이 승인되었습니다.");

HashMap<String, Object> response = commerce.orderCancel.approve(params);
System.out.println(response);java

commerce = BootpayStore::Api.new('{client_key}', '{secret_key}')
response = commerce.order_cancel_approve(
  order_cancel_request_history_id: '687a1b2c3d4e5f6789012345',
  message: '취소 요청이 승인되었습니다.'
)
puts responseruby

import "github.com/bootpay/backend-go/v2"

commerce := bootpay.NewCommerceApi("{client_key}", "{secret_key}")
response, err := commerce.OrderCancel.Approve(bootpay.OrderCancelApproveParams{
    OrderCancelRequestHistoryId: "687a1b2c3d4e5f6789012345",
    Message:                     "취소 요청이 승인되었습니다.",
})
fmt.Println(response)go

using Bootpay.Commerce;

var commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
var response = await commerce.OrderCancel.Approve(new {
    order_cancel_request_history_id = "687a1b2c3d4e5f6789012345",
    message = "취소 요청이 승인되었습니다."
});
Console.WriteLine(response);csharp

응답

성공 응답

{
  "id": "687a1b2c3d4e5f6789012345",
  "order_id": "68707c59b0eacea5cd974efd",
  "status": 1,
  "approved_at": "2025-07-11T03:30:00Z",
  "approved_message": "취소 요청이 승인되었습니다."
}json

에러 코드

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

코드	메시지	대처 방법
`ORDER_CANCEL_REQUEST_NOT_FOUND`	취소 요청 정보가 없어요.	cancel_request_id를 확인해요
`ORDER_CANCEL_REQUEST_REJECT_UNABLE`	이미 취소가 처리 되었거나 혹은 다른 상태로 변경되어 취소 요청 철회가 불가능한 요청이에요.	요청 상태를 확인해요

승인이 완료되면 PG사를 통해 실제 결제 취소가 진행돼요. 환불은 영업일 기준 3~5일 이내 처리돼요.