청구서 발송 및 파기

청구서 발송

post

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

Body

application/json

apikeystring · max: 32Required

파트너 연동을 위한 고유키

Example: partner-api-key

merchantstring · max: 30Required

파트너 매장 코드

Example: partner-merchant-1

memberstring · max: 30Required

파트너 사용자 코드

Example: partner-user-1

Responses

200

성공

application/json

codestringOptional

응답 코드

Example: 0000

msgstringOptional

응답 메세지

Example: 성공하였습니다.

apikeystring · max: 32Optional

파트너 연동을 위한 고유키

Example: partner-api-key

memberstring · max: 30Optional

파트너 매장 코드

Example: partner-merchant-1

merchantstring · max: 30Optional

파트너 사용자 코드

Example: partner-user-1

bill_idstring · max: 20Optional

청구서 ID
문자/숫자 20자리 (중복불가)
-개발: 사업자번호 + 10자리 자유롭게 사용
-운영: 20자리 자유롭게 사용

Example: 사업자번호-100000001

hashstringOptional

통신 암호 키
{phone} 값이 설정된 경우 {bill_id} + "," + {phone} + "," + {price} 값으로 Hash 생성
{phone} 값이 설정되어 있지 않은 경우 {bill_id} + "," + {price} 값으로 Hash 생성

Example: a0213f3f9e45e8540e91a1339e0c5deee2dd27c4cb6b039436538c316bb45fa6

post

/if/bill/send

HTTPcURLJavaScriptPython

POST /if/bill/send HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 451

{
  "apikey": "partner-api-key",
  "merchant": "partner-merchant-1",
  "member": "partner-user-1",
  "bill": {
    "bill_id": "사업자번호-100000001",
    "bill_issuer": "결제선생학원 커스텀지점",
    "hash": "a0213f3f9e45e8540e91a1339e0c5deee2dd27c4cb6b039436538c316bb45fa6",
    "product_nm": "청구 사유",
    "message": "안내메세지",
    "member_nm": "고객명",
    "phone": "01000001234",
    "price": "10000",
    "expire_dt": "2026-01-01",
    "callbackURL": "https://partner.url.com/callback"
  }
}

200

성공

{
  "code": "0000",
  "msg": "성공하였습니다.",
  "apikey": "partner-api-key",
  "member": "partner-merchant-1",
  "merchant": "partner-user-1",
  "bill_id": "사업자번호-100000001",
  "hash": "a0213f3f9e45e8540e91a1339e0c5deee2dd27c4cb6b039436538c316bb45fa6"
}

청구서 파기

post

결제를 진행할 수 없도록 발송된 청구서를 파기합니다. 결제가 승인되기 전에만 파기가 가능하며, 결제가 승인된 후에는 파기할 수 없습니다.

Body

application/json

apikeystring · max: 32Required

파트너 연동을 위한 고유키

Example: partner-api-key

merchantstring · max: 30Required

파트너 매장 코드

Example: partner-merchant-1

memberstring · max: 30Required

파트너 사용자 코드

Example: partner-user-1

bill_idstringRequired

청구서 ID
문자/숫자 20자리 (중복불가)
-개발: 사업자번호 + 10자리 자유롭게 사용
-운영: 20자리 자유롭게 사용

Example: 사업자번호-100000001

hashstringRequired

통신 암호 키
{phone} 값이 설정된 경우 {bill_id} + "," + {phone} + "," + {price} 값으로 Hash 생성
{phone} 값이 설정되어 있지 않은 경우 {bill_id} + "," + {price} 값으로 Hash 생성

Example: a0213f3f9e45e8540e91a1339e0c5deee2dd27c4cb6b039436538c316bb45fa6

pricestringRequired

결제 금액

Example: 10000

Responses

200

성공

application/json

codestringOptional

응답 코드

Example: 0000

msgstringOptional

응답 메세지

Example: 성공하였습니다.

apikeystring · max: 32Optional

파트너 연동을 위한 고유키

Example: partner-api-key

memberstring · max: 30Optional

파트너 매장 코드

Example: partner-merchant-1

merchantstring · max: 30Optional

파트너 사용자 코드

Example: partner-user-1

bill_idstring · max: 20Optional

청구서 ID
문자/숫자 20자리 (중복불가)
-개발: 사업자번호 + 10자리 자유롭게 사용
-운영: 20자리 자유롭게 사용

Example: 사업자번호-100000001

hashstringOptional

통신 암호 키
{phone} 값이 설정된 경우 {bill_id} + "," + {phone} + "," + {price} 값으로 Hash 생성
{phone} 값이 설정되어 있지 않은 경우 {bill_id} + "," + {price} 값으로 Hash 생성

Example: a0213f3f9e45e8540e91a1339e0c5deee2dd27c4cb6b039436538c316bb45fa6

post

/if/bill/destroy

HTTPcURLJavaScriptPython

POST /if/bill/destroy HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 214

{
  "apikey": "partner-api-key",
  "merchant": "partner-merchant-1",
  "member": "partner-user-1",
  "bill_id": "사업자번호-100000001",
  "hash": "a0213f3f9e45e8540e91a1339e0c5deee2dd27c4cb6b039436538c316bb45fa6",
  "price": "10000"
}

200

성공

{
  "code": "0000",
  "msg": "성공하였습니다.",
  "apikey": "partner-api-key",
  "member": "partner-merchant-1",
  "merchant": "partner-user-1",
  "bill_id": "사업자번호-100000001",
  "hash": "a0213f3f9e45e8540e91a1339e0c5deee2dd27c4cb6b039436538c316bb45fa6"
}

청구서 재발송

post

기발송된 청구서를 재발송합니다. 청구 내용은 동일하며 알림톡이 새로 발송되므로 쌤포인트는 차감됩니다.

Body

application/json

apikeystring · max: 32Required

파트너 연동을 위한 고유키

Example: partner-api-key

merchantstring · max: 30Required

파트너 매장 코드

Example: partner-merchant-1

memberstring · max: 30Required

파트너 사용자 코드

Example: partner-user-1

bill_idstringRequired

청구서 ID
문자/숫자 20자리 (중복불가)
-개발: 사업자번호 + 10자리 자유롭게 사용
-운영: 20자리 자유롭게 사용

Example: 사업자번호-100000001

Responses

200

성공

application/json

codestringOptional

응답 코드

Example: 0000

msgstringOptional

응답 메세지

Example: 성공하였습니다.

post

/if/bill/resend

HTTPcURLJavaScriptPython

POST /if/bill/resend HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 124

{
  "apikey": "partner-api-key",
  "merchant": "partner-merchant-1",
  "member": "partner-user-1",
  "bill_id": "사업자번호-100000001"
}

200

성공

{
  "code": "0000",
  "msg": "성공하였습니다."
}