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

주문 목록 조회

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 값이 올바르지 않아요.

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