조정 항목 삭제 | Bootpay 커머스 매뉴얼

구독 계약에 추가된 회차 금액 조정 항목을 삭제하는 API예요. 특정 조정 항목의 고유 ID를 지정하여 삭제해요.

API 엔드포인트

DELETEhttps://api.bootapi.com/v1/order_subscriptions/:id/adjustments/:adjustment_idBearer Token (supervisor)

이 API는 supervisor 권한이 필요해요. 관리자 토큰으로 요청해요.

조정 항목이 삭제되면 해당 항목이 적용된 회차가 재계산돼요.

요청 파라미터

파라미터	타입	필수	설명
`order_subscription_id`	String	필수	구독 계약 고유 번호 (URL 파라미터)
`order_subscription_adjustment_id`	String	필수	삭제할 조정 항목 고유 번호 (URL 파라미터)

코드 예제

curl -X DELETE "https://api.bootapi.com/v1/order_subscriptions/{order_subscription_id}/adjustments/{adjustment_id}" \
  -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.orderSubscriptionBill.adjustment.delete('687a1b2c3d4e5f6789012345', '6864ec30b0eacea5cd974b20');
console.log(response);javascript

from bootpay_backend.commerce import BootpayCommerce

commerce = BootpayCommerce('{client_key}', '{secret_key}')
response = commerce.order_subscription_adjustment_delete('687a1b2c3d4e5f6789012345', '6864ec30b0eacea5cd974b20')
print(response)python

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
$response = $commerce->orderSubscriptionAdjustmentDelete('687a1b2c3d4e5f6789012345', '6864ec30b0eacea5cd974b20');
print_r($response);php

BootpayCommerceApi commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
HashMap<String, Object> response = commerce.orderSubscriptionAdjustmentDelete("687a1b2c3d4e5f6789012345", "6864ec30b0eacea5cd974b20");
System.out.println(response);java

commerce = BootpayStore::Api.new('{client_key}', '{secret_key}')
response = commerce.order_subscription_adjustment_delete('687a1b2c3d4e5f6789012345', '6864ec30b0eacea5cd974b20')
puts responseruby

commerce := bootpay.NewCommerceApi("{client_key}", "{secret_key}")
response, err := commerce.OrderSubscriptionAdjustmentDelete("687a1b2c3d4e5f6789012345", "6864ec30b0eacea5cd974b20")
fmt.Println(response)go

var commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
var response = await commerce.OrderSubscriptionAdjustmentDelete("687a1b2c3d4e5f6789012345", "6864ec30b0eacea5cd974b20");
Console.WriteLine(response);csharp

응답

성공 응답

{
  "order_subscription_id": "687a1b2c3d4e5f6789012345",
  "order_subscription_adjustments": []
}json

응답 파라미터

파라미터	타입	설명
order_subscription_id	String	구독 계약 ID
order_subscription_adjustments	Array	삭제 후 남은 조정 항목 목록

에러 코드

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

코드	메시지	대처 방법
`SUBSCRIPTION_ADJUSTMENT_NOT_FOUND`	구독결제 조정 정보를 찾을 수 없어요.	adjustment_id를 확인해요
`SUBSCRIPTION_ADJUSTMENT_PAYMENT_COMPLETED`	이미 결제가 완료된 회차예요. 가격조정을 할 수 없어요.	결제 완료된 회차의 조정은 삭제할 수 없어요