주문 결제 완료 처리
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 형식이 틀렸어요. |