본문으로 건너뛰기
페이싱크 개발자센터
Esc
↑↓이동↵열기⌘J미리보기
이 페이지에서

주문 결제 완료 처리

POST /v2/invoices/{id}/mark-paid 로 입금 매칭 없이 주문을 결제 완료로 바꿔요.

POST /v2/invoices/{id}/mark-paid

현금으로 받았거나 다른 수단으로 결제된 주문을 결제 완료로 바꿔요. 결제 대기(PENDING)와 만료(EXPIRED) 주문을 바꿀 수 있어요. 입금이 자동으로 매칭된 주문은 이미 결제 완료라서 호출할 필요가 없어요.

요청 본문은 없어요. paidAmount는 주문 금액과 같게 기록하고, matchedTransactionId는 null이에요.

호출하면 이런 일이 함께 일어나요.

  • invoice.paid 웹훅이 paidTrigger: "API_CALL"로 가요. v1 웹훅에는 trigger: "API_CALL"로 가요.
  • 주문에 cashReceipt가 있으면 현금영수증을 자동 발급해요.
  • 카페24 연동으로 만든 주문이면, 쇼핑몰 설정에 따라 카페24 주문도 입금 확인 상태로 바꿔요.
  • 식스샵 프로 연동으로 만든 주문이면, 쇼핑몰 설정에 따라 식스샵 주문도 결제 완료로 바꿔요.

구매자에게 가는 결제 완료 메일은 보내지 않아요. 결제 완료 메일은 입금이 매칭됐을 때만 보내요.

v1 API는 주문 결제 완료 처리 (v1)를 참고하세요. 경로가 /mark-as-paid에서 /mark-paid로 바뀌었어요.

경로 파라미터

파라미터 타입 설명
id string 결제 완료로 바꿀 주문 ID예요. ivc_로 시작해요.

요청 예시

curl -X POST https://api.paysync.kr/v2/invoices/ivc_a1b2c3d4e5f6g7h8i9j0k1l2/mark-paid \
  -H "Authorization: Bearer $PAYSYNC_API_KEY"
const res = await fetch(`https://api.paysync.kr/v2/invoices/${invoiceId}/mark-paid`, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PAYSYNC_API_KEY}` },
});
const { code, data } = await res.json();
import os
import requests

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

응답

status가 PAID로 바뀐 주문 객체가 와요.

{
  "code": "10001",
  "data": {
    "id": "ivc_a1b2c3d4e5f6g7h8i9j0k1l2",
    "number": 1043,
    "status": "PAID",
    "amount": 50000,
    "paidAmount": 50000,
    "paidAt": 1777350000,
    "paidTrigger": "API_CALL",
    "paidBy": { "type": "API_KEY", "accountId": null, "apiKeyId": "apk_k3l4m5n6o7p8q9r0s1t2u3v4", "name": "쇼핑몰 서버" },
    "matchedTransactionId": null,
    "...": "..."
  }
}

오류

HTTP code 발생 조건
401 290006 API 키가 올바르지 않아요.
403 80002 API 키의 계좌 범위 밖의 주문이에요.
403 290007 읽기 전용 API 키예요.
404 20014 주문이 없어요.
409 220011 이미 결제 완료됐거나 취소된 주문이에요.
422 220001 주문 ID 형식이 틀렸어요.

이 페이지가 도움이 되었나요?