---
title: "청구서 결제 취소"
method: POST
path: "/bill/cancel"
tags: ["청구서 ERP 연동 (취소/조회)"]
---

# 청구서 결제 취소

`POST /bill/cancel`

## Request

- The document declares no server URL.
- Auth: none declared

결제가 완료된 청구서의 결제 상태를 승인 -> 승인취소 처리 합니다.
    결제가 완료되지 않은 청구서는 사용할 수 없습니다.

## Request body

- BillCancelPortRequest
  - `apiKey` string, required: 파트너 연동을 위한 고유키
  - `member` string, required: 파트너 사용자 코드
  - `merchant` string, required: 파트너 매장 코드
  - `bill` CancelBillInfo
    - `billId` string, required: 청구서 ID
    - `price` string, required: 결제 금액
    - `cancelReason` string: 취소사유
    - `hash` string, required: 통신 암호 키 {phone} 값이 설정된 경우 {bill_id} + "," + {phone} + "," + {price} 값으로 Hash 생성 {phone} 값이 설정되어 있지 않은 경우 {bill_id} + "," + {price} 값으로 Hash 생성 SHA-256으로 생성합니다

## Response `200`

성공

- BaseResponseBillCancelPortResponse: 공통 API 응답 포맷 (api.spec: code/message/data)
  - `code` string: 응답 코드
  - `message` string: 응답 메시지
  - `data` BillCancelPortResponse: 청구서 결제 취소 응답
    - `apiKey` string: 파트너 연동을 위한 고유키
    - `member` string: 파트너 매장 코드
    - `merchant` string: 파트너 사용자 코드
    - `billId` string: 청구서 ID
    - `hash` string: 요청 시 전달된 해시값
    - `apprNum` string: 취소 승인 거래번호
    - `apprOriginNum` string: 원거래 승인번호
    - `apprCancelDt` string: 취소 일시 (YYYYMMDDhhmmss)

---

[API](https://skmtc.dev/payssam/apis/payssam-api.md) - [All operations](https://skmtc.dev/payssam/apis/payssam-api/llms.txt) - [OpenAPI document](https://skmtc.dev/payssam/apis/payssam-api/revisions/73517f9ba4e2?raw)