ProBid 매뉴얼자주 묻는 질문

자주 묻는 질문 (FAQ) - probid

probid 연동 및 운영 과정에서 자주 접하는 질문에 대한 답변입니다.


Q. Webhook이 도달하지 않거나 지연 수신됩니다.

🚨

수신 서버가 3초 이내에 200 OK 응답을 반환하지 않으면 Webhook 전송은 실패로 처리되며 재시도 메커니즘이 가동됩니다. 수신 서버의 응답 타임아웃 및 네트워크 부하를 가장 먼저 점검해 주십시오.

Webhook이 수신되지 않을 때는 다음 항목을 순차적으로 확인하십시오.

  1. 상태 코드 확인: 수신 서버가 500 Internal Server Error404 Not Found 등을 반환하고 있지는 않은지 액세스 로그를 체크합니다.
  2. Webhook 서버 방화벽: 외부 IP 수신 허용 목록에 probid 전송서버 대역이 등록되어 있는지 확인합니다.
  3. 재시도 로그: 콘솔 내의 Webhook 발송 상세 로그에서 최종 실패 원인을 확인합니다.

Q. PDF 문서에 전자 서명을 추가한 이후 파일 크기가 과도하게 커졌습니다.

전자서명 처리 시 인증서 체인 정보와 타임스탬프(LTV - Long Term Validation) 정보가 파일 내부 메타데이터에 포함되어 생성됩니다. 이는 정상적인 스펙이며 문서당 통상 100KB 내외의 용량이 추가됩니다.

Q. 지원하는 서명 문서 포맷에 제한이 있나요?

현재 공식적으로 지원하는 서명 원본 포맷은 PDF (.pdf) 입니다. 이미지(PNG/JPG)나 Word 파일의 경우 시스템 내부에서 자동으로 PDF 규격으로 변환한 뒤 서명 흐름이 가동됩니다.