---
title: "결제 취소"
method: POST
path: "/if/bill/cancel"
tags: ["erp-partner-controller"]
---

# 결제 취소

`POST /if/bill/cancel`

## Request

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

결제가 완료된 청구서의 결제 상태를 승인 -> 승인취소 처리 합니다.

## Request body

- ReqCancelBill
  - `apikey` string, required: 파트너 연동을 위한 고유키
  - `merchant` string, required: 파트너 매장 코드
  - `member` string, required: 파트너 사용자 코드
  - `bill_id` string, required: 청구서 ID 문자/숫자 20자리 (중복불가) -개발: 사업자번호 + 10자리 자유롭게 사용 -운영: 20자리 자유롭게 사용
  - `hash` string, required: 통신 암호 키 {phone} 값이 설정된 경우 {bill_id} + "," + {phone} + "," + {price} 값으로 Hash 생성 {phone} 값이 설정되어 있지 않은 경우 {bill_id} + "," + {price} 값으로 Hash 생성
  - `price` string, required: 결제 금액

## Response `200`

성공

- CancelBill
  - `code` string: 응답 코드
  - `msg` string: 응답 메세지
  - `apikey` string: 파트너 연동을 위한 고유키
  - `member` string: 파트너 매장 코드
  - `merchant` string: 파트너 사용자 코드
  - `bill_id` string: 청구서 ID 문자/숫자 20자리 (중복불가) -개발: 사업자번호 + 10자리 자유롭게 사용 -운영: 20자리 자유롭게 사용
  - `hash` string: 통신 암호 키 {phone} 값이 설정된 경우 {bill_id} + "," + {phone} + "," + {price} 값으로 Hash 생성 {phone} 값이 설정되어 있지 않은 경우 {bill_id} + "," + {price} 값으로 Hash 생성
  - `appr_num` string: 취소 승인 번호
  - `appr_origin_num` string: 원거래 승인 번호
  - `appr_cancel_dt` string: 취소 일시

---

[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)