에러

모든 에러는 동일한 형태의 JSON 본문을 반환합니다.

{
  "error": {
    "type": "invalid_request_error",
    "code": "amount_too_small",
    "message": "Amount must be at least 100 (smallest unit).",
    "param": "amount",
    "request_id": "req_abc123"
  }
}

request_id 는 요청별로 고유합니다. ParaSta 지원팀에 문의 시 함께 전달하세요.

에러 타입

`type`	HTTP	의미
`authentication_error`	401	API 키 누락 또는 잘못된 키
`permission_error`	403	키에 해당 작업의 권한이 없음
`invalid_request_error`	400	파라미터 형식 오류
`not_found_error`	404	객체를 찾을 수 없음
`rate_limit_error`	429	요청 과다 — 속도 제한 참조
`idempotency_error`	409	멱등성 키가 다른 파라미터로 재사용됨
`payment_error`	402	결제 거절 (잔액 부족, 네트워크 거절 등)
`network_error`	502 / 504	블록체인 RPC 연결 불가; 멱등성 키와 함께 재시도 가능
`api_error`	5xx	ParaSta 내부 오류; `request_id` 와 함께 신고

에러 처리

4xx 에러는 보통 영구적입니다 — 재시도 전에 요청을 수정하세요.
5xx 와 429 에러는 일시적입니다 — Idempotency-Key 와 함께 지수 백오프로 재시도하세요.
분기 로직에는 error.message 가 아닌 error.code 를 확인하세요 (메시지는 사전 통지 없이 변경될 수 있음).

전체 코드 목록은 레퍼런스 → 에러 코드에서 확인하세요.