현금영수증 재발급

POST /v2/cash-receipts/{id}/reissue 로 발급에 실패한 현금영수증을 식별번호를 고쳐 다시 발급해요.

POST /v2/cash-receipts/{id}/reissue

발급에 실패한(FAILED) 원본 현금영수증을 다시 발급해요. 식별번호나 종류를 고쳐서 보내면 새 ID로 현금영수증을 만들어요. 금액, 구매자 이름, 연결된 주문은 원본을 그대로 써요.

새 현금영수증의 reissuedFromId에는 원본 ID가, 원본의 reissuedToId에는 새 ID가 들어가요. 원본 하나는 한 번만 재발급할 수 있어요.

경로 파라미터

파라미터	타입	설명
`id`	string	발급에 실패한 원본 현금영수증 ID예요. `crt_`로 시작해요.

요청 본문

필드	타입	설명
`identifier`	string	새 식별번호예요. 형식은 현금영수증 발급과 같아요. `selfIssued`가 `true`가 아니면 필수예요.
`type`	string	새 종류예요. `PERSONAL` 또는 `CORPORATE`예요. 빼면 원본 종류를 써요.
`selfIssued`	boolean	`true`면 자진발급으로 다시 발급해요.

요청 예시

curl -X POST https://api.paysync.kr/v2/cash-receipts/crt_b2c3d4e5f6g7h8i9j0k1l2m3/reissue \
  -H "Authorization: Bearer $PAYSYNC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "identifier": "01012345678" }'

const res = await fetch(`https://api.paysync.kr/v2/cash-receipts/${cashReceiptId}/reissue`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PAYSYNC_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ identifier: "01012345678" }),
});
const { code, data } = await res.json();

import os
import requests

res = requests.post(
    f"https://api.paysync.kr/v2/cash-receipts/{cash_receipt_id}/reissue",
    headers={"Authorization": f"Bearer {os.environ['PAYSYNC_API_KEY']}"},
    json={"identifier": "01012345678"},
)
print(res.json())

응답

새로 만든 현금영수증 객체가 와요.

{
  "code": "10001",
  "data": {
    "id": "crt_d4e5f6g7h8i9j0k1l2m3n4o5",
    "kind": "ORIGINAL",
    "status": "PENDING",
    "identifier": "01012345678",
    "reissuedFromId": "crt_b2c3d4e5f6g7h8i9j0k1l2m3",
    "...": "..."
  }
}

오류

HTTP	`code`	발생 조건
401	`290006`	API 키가 올바르지 않아요.
403	`290007`	읽기 전용 API 키예요.
404	`20015`	현금영수증이 없어요.
409	`240005`	사업자 정보를 등록하지 않았어요.
409	`240007`	발급에 실패한 원본이 아니거나 이미 재발급했어요.
422	`30007`	JSON 본문을 읽을 수 없어요.
422	`240001`	현금영수증 ID 형식이 틀렸어요.
422	`240002`	`type`이 올바르지 않거나, `CORPORATE`로 자진발급하려고 했어요.
422	`240003`	`identifier`가 없거나 종류에 맞지 않아요.
422	`240008`	팝빌이 다시 거절했어요. `data`에 `status`가 `FAILED`인 새 현금영수증이 와요.