주문 삭제

DELETE /v1/invoices/{id} 로 결제되지 않은 주문을 삭제해요.

DELETE /v1/invoices/{id}

결제되지 않은 주문을 삭제해요. 삭제한 주문에는 입금이 매칭되지 않고, 같은 입금자명과 금액으로 새 주문을 만들 수 있어요. 삭제하면 invoice.deleted 웹훅이 가요.

결제 완료된 주문은 삭제할 수 없어요. 일정 시간이 지나면 자동으로 매칭을 막고 싶다면 주문을 만들 때 expireAfter를 지정하세요.

경로 파라미터

파라미터	타입	설명
`id`	string	삭제할 주문 ID예요. `ivc_`로 시작해요.

요청 예시

curl -X DELETE https://api.paysync.kr/v1/invoices/ivc_a1b2c3d4e5f6g7h8i9j0k1l2 \
  -H "Authorization: Bearer $PAYSYNC_API_KEY"

const res = await fetch(`https://api.paysync.kr/v1/invoices/${invoiceId}`, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.PAYSYNC_API_KEY}` },
});
const { code } = await res.json();

import os
import requests

res = requests.delete(
    f"https://api.paysync.kr/v1/invoices/{invoice_id}",
    headers={"Authorization": f"Bearer {os.environ['PAYSYNC_API_KEY']}"},
)
print(res.json())

응답

{
  "code": "DELETED",
  "data": null
}

오류

HTTP	`code`	발생 조건
401	`NOT_AUTHORIZED`	API 키가 없거나 올바르지 않아요.
403	`INSUFFICIENT_PERMISSIONS`	다른 계정의 주문이거나, API 키의 접근 가능한 계좌 밖의 주문이에요.
403	`INVOICE_ALREADY_PAID`	결제 완료된 주문이에요.
404	`INVOICE_NOT_FOUND`	주문이 없거나 이미 삭제됐어요.
500	`INTERNAL_SERVER_ERROR`	삭제 중 서버 오류가 났어요. 잠시 뒤 다시 시도하세요.