Billing(자동결제)breadcrumb빌링키 해지

빌링키 해지

고객의 결제 정보가 변경되었거나, 더 이상 정기결제·자동결제를 사용하지 않는 경우 기존 빌링키를 해지할 수 있어요.
빌링키를 해지하면 해당 빌링키로는 더 이상 결제 요청이 불가능하며, 다시 결제가 필요하다면 새로운 빌링키를 발급받아야 해요.

결제수단이 카드 재발급, 명의 변경, 휴대폰 번호 변경 등으로 바뀐 경우에는
기존 빌링키를 그대로 사용하면 결제가 실패할 수 있으니 사전에 빌링키 해지를 진행하는 것을 권장해요.
빌링키 해지는 Server to Server 방식으로만 요청할 수 있으며, 아래 API를 사용해 Request Body 없이 호출하면 돼요.

인증 방식에 대한 자세한 내용은 [다날 개발자센터 인증 방식 가이드]를 참고해주세요.

언제 사용해야 하나요?

  • 고객의 결제수단 정보가 변경된 경우
    (예: 카드 재발급, 명의 변경, 휴대폰 번호 변경 등)

  • 고객이 정기결제/자동결제를 해지한 경우

  • 더 이상 해당 고객의 결제 정보를 저장·사용하지 않아야 하는 경우

  • 개인정보 보호 및 내부 운영 정책에 따라 기존 결제 정보 삭제가 필요한 경우

기존 빌링키를 해지하지 않고 결제를 시도할 경우, 결제 실패 또는 운영 이슈가 발생할 수 있어요

API 정보

항목값
HTTP MethodDELETE
Endpointhttps://one-api.danalpay.com/v1/billing/{paymentsMethod}/{merchantId}/{billingKey}
인증 방식Basic Auth
Request Content-Typeapplication/json
Request Body없음
* 현재 빌링 서비스를 지원하는 결제수단(paymentsMethod)은 'CARD' 입니다.

요청 방식 안내

  • 본 API는 Server to Server 방식으로만 호출해야 해요.
  • Request Body 없이 호출하며, Path Parameter로 아래 값을 전달이 필요해요.
  • paymentsMethod : 결제수단 (예: CARD)
  • merchantId : 가맹점 ID
  • billingKey : 해지할 빌링키

요청 예시

curl -X DELETE \
https://one-api.danalpay.com/v1/billing/CARD/A12345678/test_billing_key_1234 \
-H "Authorization: Basic dGVzdF9zZWNyZXRfa2V5Og=="

응답 예시

{
  "code" : "SUCCESS",
  "message" : "성공",
  "transactionId" : "04290001234567890",
}

처리 결과

빌링키 해지가 정상적으로 처리되면, 해당 빌링키로는 더 이상 결제 요청이 불가능합니다.
해지 이후 다시 정기결제를 진행하려면 [새로운 빌링키 발급 절차]를 통해 빌링키를 재발급받아야 합니다.

← 이전 단계로 이동

맨 위로