응답 형식

모든 응답은 UTF-8 인코딩의 JSON 본문으로 반환됩니다.

성공 응답

성공 응답은 요청한 리소스를 나타내는 키(예: charge, webhook)로 감싸서 반환됩니다.

{
  "charge": {
    "id": "chg_example123",
    "amount": 10000,
    "status": "pending",
    "requested_at": "2026-08-15T03:00:00Z"
  }
}

멱등 응답

동일한 요청이 이미 처리된 경우, 일부 엔드포인트는 idempotent_replay 필드를 포함한 응답을 반환합니다. 이 필드가 true이면 새 리소스가 생성되지 않고 기존 처리 결과가 반환된 것입니다.

{
  "charge": {
    "id": "chg_example123",
    "status": "approved"
  },
  "idempotent_replay": true
}

오류 응답

오류 응답은 항상 다음 두 필드를 포함합니다.

• error: 프로그램에서 분기 처리할 수 있는 오류 코드 문자열
• message: 사람이 읽을 수 있는 오류 설명

{
  "error": "invalid_bearer_token",
  "message": "invalid API key"
}

필드 네이밍 규칙

모든 필드명은 snake_case를 사용합니다. 예: requested_at, expires_at, monthly_limit.