주문 목록 조회
GET /v2/invoices 로 워크스페이스의 주문 목록을 상태, 입금 기한, 출처, 만든 날짜로 걸러 조회해요.
GET /v2/invoices
워크스페이스의 주문을 최신순으로 조회해요. 계좌를 제한한 API 키로는 허용된 계좌의 주문만 나와요.
쿼리 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
offset |
integer | 예 | 건너뛸 항목 수예요. 0 이상이에요. |
limit |
integer | 예 | 가져올 항목 수예요. 1~100이에요. |
search |
string | 주문 ID나 주문번호(1043, #1043), 카페24나 식스샵 주문번호가 같거나, 입금자명이나 이메일에 검색어가 들어간 주문을 찾아요. 대소문자를 구분하지 않아요. 숫자가 3자리 이상이면 전화번호에서도 찾고, 하이픈은 무시해요. |
|
status |
string | PENDING, PAID, EXPIRED, CANCELED 중에서 골라요. 여러 개를 쉼표로 이어 보낼 수 있어요. |
|
due |
string | 결제 대기 주문을 입금 기한(KST)으로 걸러요. TODAY(오늘), TOMORROW(내일), LATER(모레 이후), NONE(기한 없음) 중 하나예요. 이 값을 보내면 PENDING 주문만 나와요. |
|
source |
string | API, DASHBOARD, CSV, CAFE24, SIXSHOP, GODOMALL 중에서 골라요. 여러 개를 쉼표로 이어 보낼 수 있어요. |
|
createdBy |
string | 만든 주체로 걸러요. SYSTEM, 계정 ID(acc_...), API 키 ID(apk_...) 중 하나예요. |
|
dateFrom |
string | 이 날짜(KST)부터 만든 주문만 조회해요. YYYY-MM-DD |
|
dateTo |
string | 이 날짜(KST)까지 만든 주문만 조회해요. 그날도 포함해요. YYYY-MM-DD |
아직 입금받을 수 있는 주문만 보려면 status=PENDING을 쓰세요. 입금 기한이 지난 주문은 1분 안에 EXPIRED로 바뀌어요.
요청 예시
curl "https://api.paysync.kr/v2/invoices?offset=0&limit=20&status=PAID&dateFrom=2026-04-01" \
-H "Authorization: Bearer $PAYSYNC_API_KEY"const params = new URLSearchParams({ offset: "0", limit: "20", status: "PAID", dateFrom: "2026-04-01" });
const res = await fetch(`https://api.paysync.kr/v2/invoices?${params}`, {
headers: { Authorization: `Bearer ${process.env.PAYSYNC_API_KEY}` },
});
const { items, totalItems } = await res.json();import os
import requests
res = requests.get(
"https://api.paysync.kr/v2/invoices",
headers={"Authorization": f"Bearer {os.environ['PAYSYNC_API_KEY']}"},
params={"offset": 0, "limit": 20, "status": "PAID", "dateFrom": "2026-04-01"},
)
print(res.json())응답
items는 주문 객체 배열이에요. 목록에는 history가 없어요. totalItems는 조건에 맞는 전체 주문 수예요.
{
"code": "10001",
"items": [
{
"id": "ivc_a1b2c3d4e5f6g7h8i9j0k1l2",
"number": 1043,
"status": "PAID",
"customer": { "name": "홍길동", "email": "hong@example.com", "phoneNumber": "01012345678" },
"amount": 50000,
"paidAmount": 50000,
"amountDiff": null,
"bankAccountIds": [],
"cashReceipt": null,
"metadata": { "orderId": "ORDER-2026-0001" },
"source": "API",
"createdBy": { "type": "API_KEY", "accountId": null, "apiKeyId": "apk_k3l4m5n6o7p8q9r0s1t2u3v4", "name": "쇼핑몰 서버" },
"shopOrder": null,
"guideUrl": "https://paysync.kr/pay/Xk2f9QaB7cLmN4pR8sTvW1yZ3dE6gH0j",
"guideEmailSentAt": null,
"createdAt": 1777346055,
"updatedAt": 1777346412,
"expiresAt": 1777432455,
"paidAt": 1777346412,
"paidTrigger": "AUTOMATIC_MATCHING",
"paidBy": { "type": "SYSTEM", "accountId": null, "apiKeyId": null, "name": null },
"matchedTransactionId": "trx_m1n2o3p4q5r6s7t8u9v0w1x2",
"canceledAt": null,
"cancelReason": null,
"canceledBy": null,
"expiredAt": null,
"reopenedAt": null
}
],
"totalItems": 57
}
오류
| HTTP | code |
발생 조건 |
|---|---|---|
| 401 | 290006 |
API 키가 올바르지 않아요. |
| 403 | 40001 |
limit이 100을 넘어요. |
| 422 | 30001 |
offset이 없거나 0보다 작아요. |
| 422 | 30002 |
limit이 없거나 0 이하예요. |
| 422 | 30004 |
dateFrom이나 dateTo가 YYYY-MM-DD 형식이 아니에요. |
| 422 | 30005 |
dateFrom이 dateTo보다 늦어요. |
| 422 | 220012 |
status 값이 목록에 없어요. |
| 422 | 220013 |
source 값이 목록에 없어요. |
| 422 | 220017 |
due 값이 목록에 없어요. |
| 422 | 220019 |
createdBy 값이 올바르지 않아요. |