---
title: "청구서 발송"
method: POST
path: "/if/bill/send"
tags: ["erp-partner-controller"]
---

# 청구서 발송

`POST /if/bill/send`

## Request

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

결제 금액을 결제 고객에게 청구하기 위하여 청구서를 생성하고 결제 고객에게 알림톡으로 청구서를 전송합니다.

## Request body

- ReqSendBill
  - `apikey` string, required: 파트너 연동을 위한 고유키
  - `merchant` string, required: 파트너 매장 코드
  - `member` string, required: 파트너 사용자 코드
  - `bill` Bill: 청구서 정보
    - `bill_id` string, required: 청구서 ID 문자/숫자 20자리 (중복불가) -개발: 사업자번호 + 10자리 자유롭게 사용 -운영: 20자리 자유롭게 사용
    - `bill_issuer` string: 청구서 발급처명 청구서가 발급될 때 노출되는 발급처명을 직접 입력한 값으로 노출하기 위해 사용 -파라미터 전달시 : 세팅한 값이 발급처명으로 노출 -파라미터 미전달시 : 사업장명이 발급처명으로 노출
    - `hash` string, required: 통신 암호 키 {phone} 값이 설정된 경우 {bill_id} + "," + {phone} + "," + {price} 값으로 Hash 생성 {phone} 값이 설정되어 있지 않은 경우 {bill_id} + "," + {price} 값으로 Hash 생성
    - `product_nm` string, required: 청구 사유
    - `message` string: 안내메세지
    - `member_nm` string, required: 고객명
    - `phone` string, required: 고객 전화번호
    - `price` string, required: 결제 금액
    - `expire_dt` string: 유효기간 YYYY-MM-DD 청구서 생성일 자정까지 입력 가능
    - `callbackURL` string, required: 결제 승인 후 결제 상태를 통보받을 파트너사의 URL

## Response `200`

성공

- SendBill
  - `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 생성

---

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