주문 단건 조회

GET /v1/invoices/{id} 로 주문 하나의 상세 정보를 조회해요.

GET /v1/invoices/{id}

주문 ID로 주문 하나를 조회해요. 결제 여부는 paid로 확인해요. 결제 완료를 바로 알아야 한다면 폴링보다 invoice.paid 웹훅을 쓰세요.

경로 파라미터

요청 예시

curl https://api.paysync.kr/v1/invoices/ivc_a1b2c3d4e5f6g7h8i9j0k1l2 \
  -H "Authorization: Bearer $PAYSYNC_API_KEY"

const res = await fetch(`https://api.paysync.kr/v1/invoices/${invoiceId}`, {
  headers: { Authorization: `Bearer ${process.env.PAYSYNC_API_KEY}` },
});
const { code, data } = await res.json();

import os
import requests

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

응답

{
  "code": "OK",
  "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
  }
}

주문 객체

만료된 주문도 paid: false로 조회돼요. 만료 여부는 expiresAt과 현재 시각을 비교해서 판단하세요.

오류