주문 목록 조회

GET /v1/invoices 로 내 계정의 주문 목록을 페이지 단위로 조회해요.

GET /v1/invoices

API 키 계정의 주문을 최신순으로 조회해요. 결제 여부, 만료 여부, 만든 날짜로 거를 수 있어요. 계좌를 제한한 API 키로는 허용된 계좌의 주문만 나와요.

쿼리 파라미터

결제 대기 중이고 아직 입금받을 수 있는 주문만 보려면 paid=false&expired=false를 함께 쓰세요.

요청 예시

curl "https://api.paysync.kr/v1/invoices?offset=0&limit=20&paid=true&dateAfter=2026-04-01" \
  -H "Authorization: Bearer $PAYSYNC_API_KEY"

const params = new URLSearchParams({ offset: "0", limit: "20", paid: "true", dateAfter: "2026-04-01" });
const res = await fetch(`https://api.paysync.kr/v1/invoices?${params}`, {
  headers: { Authorization: `Bearer ${process.env.PAYSYNC_API_KEY}` },
});
const { totalItems, data } = await res.json();

import os
import requests

res = requests.get(
    "https://api.paysync.kr/v1/invoices",
    headers={"Authorization": f"Bearer {os.environ['PAYSYNC_API_KEY']}"},
    params={"offset": 0, "limit": 20, "paid": "true", "dateAfter": "2026-04-01"},
)
print(res.json())

응답

data는 주문 객체 배열이고, totalItems는 조건에 맞는 전체 주문 수예요.

{
  "code": "OK",
  "totalItems": 57,
  "data": [
    {
      "id": "ivc_a1b2c3d4e5f6g7h8i9j0k1l2",
      "issuerId": "acc_x9y8z7w6v5u4t3s2r1q0p9o8",
      "bankAccountIds": [],
      "customer": {
        "name": "홍길동",
        "email": "hong@example.com",
        "phoneNumber": "01012345678"
      },
      "cashReceipt": null,
      "amount": 50000,
      "paid": true,
      "metadata": { "orderId": "ORDER-2026-0001" },
      "issuedAt": "2026-04-28T03:14:15.926Z",
      "expiresAt": "2026-04-29T03:14:15.926Z",
      "deletedAt": null
    }
  ]
}

오류