현금영수증

현금영수증 발급

post

현금영수증을 발급합니다.

Body

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

traderstringOptional

현금영수증 발급 구분
개인:0, 사업자:1

Example: 0

appr_cash_numstringOptional

현금영수증 발급 승인번호

Example: 1111111

issuance_numberstringOptional

현금영수증 발급 요청 번호
-현금영수증 발급 시 사용

-자진발급시 "0100001234"

Example: 0100001234

post/if/cash-receipt/issue

POST /if/cash-receipt/issue HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 300

{
  "apikey": "partner-api-key",
  "merchant": "partner-merchant-1",
  "member": "partner-user-1",
  "bill": {
    "bill_id": "사업자번호-100000001",
    "hash": "a0213f3f9e45e8540e91a1339e0c5deee2dd27c4cb6b039436538c316bb45fa6",
    "price": "10000",
    "supply_price": "10000",
    "tax": "0",
    "issuance_number": "0100001234",
    "trader": "0"
  }
}

200

성공

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

현금영수증 발급 취소

post

발급된 현금영수증을 발급 취소합니다.

Body

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

traderstringRequired

현금영수증 발급 구분
개인:0, 사업자:1

Example: 0

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

appr_cash_numstringOptional

현금영수증 발급 승인번호

Example: 1111111

post/if/cash-receipt/cancel

POST /if/cash-receipt/cancel HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 227

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

200

성공

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

현금영수증 조회

post

발급된 현금영수증의 정보를 조회합니다.

Body

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

post/if/cash-receipt/read

POST /if/cash-receipt/read 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",
  "info": [
    {
      "appr_price": "10000",
      "appr_supply_price": "10000",
      "appr_tax": "0",
      "appr_num": "8756372",
      "appr_state": "F",
      "appr_dt": "20250105134753",
      "trader": "0",
      "issuance_number": "0100001234"
    }
  ]
}