수납 및 결제취소

청구서 결제 취소

post

결제가 완료된 청구서의 결제 상태를 승인 -> 승인취소 처리 합니다. 결제가 완료되지 않은 청구서는 사용할 수 없습니다.

Body

apiKeystring · max: 32Required

파트너 연동을 위한 고유키

Example: partner-api-key

memberstring · max: 60Required

파트너 사용자 코드

Example: partner-user-1

merchantstring · max: 60Required

파트너 매장 코드

Example: partner-merchant-1

Responses

200

성공

application/json

공통 API 응답 포맷 (api.spec: code/message/data)

codestringOptional

응답 코드

Example: 0000

messagestringOptional

응답 메시지

Example: 성공하였습니다.

post/bill/cancel

200

성공

청구서 단건 조회

post

발송된 청구서에 대한 결제 상태를 조회합니다.

appr_state : F(결제완료), W(미결제), C(취소), D(파기)
각 상태는 다음과 같이 변경될 수 있습니다.
1. W(미결제) -> F(결제완료) -> C(취소)
2. W(미결제) -> D(파기)

Body

apiKeystring · max: 32Required

파트너 연동을 위한 고유키

Example: partner-api-key

memberstring · max: 60Required

파트너 사용자 코드

Example: partner-user-1

merchantstring · max: 60Required

파트너 매장 코드

Example: partner-merchant-1

Responses

200

성공

application/json

공통 API 응답 포맷 (api.spec: code/message/data)

codestringOptional

응답 코드

Example: 0000

messagestringOptional

응답 메시지

Example: 성공하였습니다.

post/bill/read

200

성공

이전청구서 발송 및 파기 다음현금 영수증

마지막 업데이트 1개월 전

도움이 되었나요?

POST /bill/cancel HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 242

{
  "apiKey": "partner-api-key",
  "member": "partner-user-1",
  "merchant": "partner-merchant-1",
  "bill": {
    "billId": "사업자번호-100000001",
    "price": 10000,
    "cancelReason": "text",
    "hash": "a0213f3f9e45e8540e91a1339e0c5deee2dd27c4cb6b039436538c316bb45fa6"
  }
}

{
  "code": "0000",
  "message": "성공하였습니다.",
  "data": {
    "apiKey": "abcd1234efgh5678",
    "member": "M0001",
    "merchant": "U0001",
    "billId": "BILL20260420001",
    "hash": "text",
    "apprNum": 30012345,
    "apprOriginNum": 30012300,
    "apprCancelDt": 20260420153012
  }
}

POST /bill/read HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 132

{
  "apiKey": "partner-api-key",
  "member": "partner-user-1",
  "merchant": "partner-merchant-1",
  "bill": {
    "billId": "사업자번호-100000001"
  }
}

{
  "code": "0000",
  "message": "성공하였습니다.",
  "data": {
    "apiKey": "abcd1234efgh5678",
    "billId": "BILL20260420001",
    "apprPayType": 0,
    "apprCardType": "신용",
    "apprDt": 20260420153012,
    "apprOriginDt": 20260419120000,
    "apprPrice": 22000,
    "apprIssuer": "신한카드",
    "apprIssuerCd": "04",
    "apprIssuerNum": "123456******1234",
    "apprAcquirerCd": "04",
    "apprAcquirerNm": "신한카드",
    "apprNum": 30012345,
    "apprOriginNum": 30012300,
    "apprResCd": "0000",
    "apprMonthly": 0,
    "apprState": "F",
    "apprCashNum": 1234567890,
    "apprCashTrader": "personal",
    "apprCashIssuanceNumber": "01012345678",
    "apprCardMerchantNum": "text",
    "catId": "text",
    "dscTxNum": "text",
    "cardType": "text",
    "apprSign": "text",
    "udItem": null
  }
}