---
title: "청구서 발송"
method: POST
path: "/bill"
tags: ["청구서 발송/파기"]
---

# 청구서 발송

`POST /bill`

## Request

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

결제 금액을 결제 고객에게 청구하기 위해 청구서를 생성하고
    sendType에 따라 청구서를 발송합니다.

    발송방식 sendType
    TALK : 생성된 청구서를 결제선생이 발송하는 방식
    URL : 생성된 청구서의 URL을 전달하는 방식

## Request body

- BillRequest: 청구서 생성 요청 (sendType=TALK: 카카오톡 발송 / sendType=URL: URL만 응답)
  - `apiKey` string, required: 파트너 연동을 위한 고유키
  - `member` string, required: 파트너 사용자 코드
  - `merchant` string, required: 파트너 매장 코드
  - `bill` CreateBillInfo
    - `billId` string, required: 청구서 ID
    - `sendType` 'TALK' | 'URL', required: 발송 방식: TALK (카카오톡 발송) 또는 URL (URL만 응답)
    - `billIssuer` string: 청구서 발급처명
    - `productName` string, required: 청구 사유
    - `price` string, required: 결제 금액
    - `supplyPrice` string: 공급가액
    - `tax` string: 세액
    - `memberName` string, required: 고객명
    - `phone` string, required: 고객 전화번호
    - `message` string: 안내메세지
    - `expireDt` string: 유효기간 YYYY-MM-DD
    - `hash` string, required: 통신 암호 키 {phone} 값이 설정된 경우 {bill_id} + "," + {phone} + "," + {price} 값으로 Hash 생성 {phone} 값이 설정되어 있지 않은 경우 {bill_id} + "," + {price} 값으로 Hash 생성 SHA-256으로 생성합니다
    - `callbackUrl` string, required: 결제 완료 콜백 URL
    - `pageRedirectUrl` string: 결제 완료 후 리다이렉트 URL (sendType=URL 인 경우에만 활성화)

## Response `200`

성공

- BaseResponseBillResponse: 공통 API 응답 포맷 (api.spec: code/message/data)
  - `code` string: 응답 코드
  - `message` string: 응답 메시지
  - `data` BillResponse: 청구서 생성 응답
    - `apiKey` string, required: 파트너 연동을 위한 고유키
    - `member` string, required: 파트너 사용자 코드
    - `merchant` string, required: 파트너 매장 코드
    - `billId` string: 청구서 ID
    - `hash` string: 요청 시 전달된 해시값
    - `shortUrl` string: 생성된 청구서 단축 URL

---

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