수수료 계산 | Bootpay 커머스 매뉴얼

구독 해지 전 예상 수수료와 환불 금액을 사전에 조회해요. 실제 해지를 진행하기 전 고객에게 안내하기 위한 용도예요.

API 엔드포인트

GEThttps://api.bootapi.com/v1/order_subscriptions/:order_subscription_id/terminate/calculateBasic Auth

요청 파라미터

파라미터	타입	필수	설명
`order_subscription_id`	String	필수	구독 계약 ID (URL 파라미터)

코드 예제

curl -X GET "https://api.bootapi.com/v1/order_subscriptions/{order_subscription_id}/terminate/calculate" \
  -H "Authorization: Basic {base64(client_key:secret_key)}" \
  -H "Content-Type: application/json"bash

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

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

const response = await commerce.orderSubscription.terminateCalculate('sub_abc123');
console.log(response);javascript

from bootpay_backend.commerce import BootpayCommerce

commerce = BootpayCommerce('{client_key}', '{secret_key}')
response = commerce.order_subscription_terminate_calculate('sub_abc123')
print(response)python

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
$response = $commerce->orderSubscriptionTerminateCalculate('sub_abc123');
print_r($response);php

BootpayCommerceApi commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
HashMap<String, Object> response = commerce.orderSubscriptionTerminateCalculate("sub_abc123");
System.out.println(response);java

commerce = BootpayStore::Api.new('{client_key}', '{secret_key}')
response = commerce.order_subscription_terminate_calculate('sub_abc123')
puts responseruby

commerce := bootpay.NewCommerceApi("{client_key}", "{secret_key}")
response, err := commerce.OrderSubscriptionTerminateCalculate("sub_abc123")
fmt.Println(response)go

var commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
var response = await commerce.OrderSubscriptionTerminateCalculate("sub_abc123");
Console.WriteLine(response);csharp

응답

{
  "id": "sub_abc123",
  "termination_fee": 30000,
  "refund_amount": 45000,
  "remaining_duration": 3,
  "total_paid": 120000,
  "used_amount": 75000
}json

응답 파라미터

파라미터	타입	설명
id	String	구독 계약 ID
termination_fee	Number	예상 해지 수수료
refund_amount	Number	예상 환불 금액
remaining_duration	Integer	남은 회차 수
total_paid	Number	총 납부 금액
used_amount	Number	사용 금액

에러 코드

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

코드	메시지	대처 방법
`ORDER_SUBSCRIPTION_NOT_FOUND`	구독결제 건을 찾을 수 없어요.	order_subscription_id를 확인해요
`SUBSCRIPTION_NOT_ACTIVE`	구독계약이 활성화되지 않은 상태예요. 관리자에 문의해요.	구독 상태를 확인해요

이 API는 조회 전용이에요. 실제 해지는 해지 요청 API를 사용해요.