---
title: "가상계좌 발급취소 API"
method: DELETE
path: "/vbanks/{imp_uid}"
tags: ["vbanks"]
---

# 가상계좌 발급취소 API

`DELETE /vbanks/{imp_uid}`

발급된 가상계좌(입금이 되기 전)를 말소합니다. <br>
      아직 입금이 되지 않은 가상계좌를 말소시킴으로써 구매자가 실수로 입금하는 경우를 방지하도록 합니다.<br>
      imp_uid가 지정되어야 합니다.(포트원 기획 의도상 동일한 merchant_uid의 입금대기 중인 가상계좌가 N개 존재할 수 있으므로 imp_uid로만 가상계좌 말소가 가능합니다)
      <h4>지원되는 PG사</h4>
      <ul> <li>KG이니시스
      </li> <li>NHN KCP
      </li> <li>토스페이먼츠 - 구모듈
      </li> <li>다날
      </li> <li>나이스페이먼츠
      </li> <li>KICC
      </li> <li>헥토파이낸셜(구 세틀뱅크)
      </li> <li>스마트로 - 구모듈
      </li> <li>토스페이먼츠 - 신모듈
      </li> <li>KSNET
      </li> <li> 스마트로 - 신모듈
      </li> <li>(신) 나이스페이
      </li> <li>웰컴페이먼츠</li></ul>

## Path parameters

- `imp_uid` string, required

## Query parameters

- `pg_api_key` string

## Response `200`

가상계좌 말소 완료

- PaymentResponse — unresolved $ref

## Other responses

- `400` — imp_uid가 누락된 경우/ 가상계좌 결제 건이 아닌 경우 / 가상계좌가 입금대기 상태(ready)가 아닌 경우
- `401` — 인증 Token이 전달되지 않았거나 유효하지 않은 경우
- `404` — 유효하지 않은 imp_uid

---

[API](https://skmtc.net/iamport/apis/rest-api.md) · [All operations](https://skmtc.net/iamport/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iamport/rest-api/revisions/006dfffdec43/schema)
