Base64 문자열을 PDF 파일로 저장하는 방법
API 응답, 인보이스 XML, 이메일 원본에 JVBERi0로 시작하는 긴 텍스트가 있고 그 안의 문서가 필요하다면, 코드를 찾는 법부터 파일을 여는 법까지 차례대로 따라 하세요.
작성자 Metin Ersoy · 2026년 11월 10일 업데이트
Base64 PDF란 무엇이고, 왜 텍스트로 오나요?
Base64는 파일을 영문자, 숫자, 몇 가지 기호만으로 적는 방식입니다. 덕분에 JSON, XML, 이메일처럼 텍스트만 다루는 형식에도 PDF를 담을 수 있습니다. 코드에는 문서가 그대로 복사되어 있어서, 디코딩하면 원본 파일이 바이트 하나까지 똑같이 돌아오고 디지털 서명도 유효한 상태로 남습니다.
주로 이런 곳에서 만나게 됩니다.
- 인보이스·회계 API. 전자 인보이스 플랫폼과 회계 소프트웨어는 인보이스의 PDF 버전을 Base64 필드로 돌려주는 경우가 많습니다. UBL 같은 구조화된 인보이스 XML도 인쇄용 PDF를 같은 방식으로 담을 수 있습니다.
- 배송. 배송을 등록하면 택배사는 보통 운송장을 Base64 PDF로 돌려줍니다.
- 결제·은행. 영수증, 급여 명세서, 거래 내역서 서비스가 문서를 텍스트 필드에 담아 보내기도 합니다.
- 전자 서명·문서 플랫폼. 서명이 끝난 문서가 서명 서비스에서 Base64로 돌아옵니다.
- 이메일 원본. 이메일의 원본 소스에서 PDF 첨부 파일은 Base64 블록으로 저장되어 있습니다.
1. 코드를 찾아 빠짐없이 복사하기
- JSON 응답: PDF가 들어 있는 필드를 찾으세요. 이름은 pdf, content, data, document, file, label 같은 경우가 많고, 값은 JVBERi0로 시작합니다. 따옴표 사이의 내용을 모두 복사하세요. 응답 전체를 복사해도 됩니다. 도구가 JVBERi0로 시작하는 부분을 알아서 찾아냅니다.
- XML 파일: PDF가 담긴 요소(예: EmbeddedDocumentBinaryObject)를 찾아 여는 태그와 닫는 태그 사이의 텍스트를 복사하세요. 줄바꿈이 섞여 있어도 괜찮습니다.
- 이메일 원본: “원본 보기”나 “소스 보기” 같은 메뉴를 여세요. Content-Type: application/pdf 줄과 Content-Transfer-Encoding: base64 줄 아래에 있는 블록이 PDF 첨부 파일입니다. 다음 빈 줄이 나오기 전까지 모두 복사하세요.
- 개발자 도구: 브라우저의 Network(네트워크) 탭에서 응답을 열고 필드를 마우스 오른쪽 버튼으로 클릭한 뒤 “Copy value”(값 복사)를 고르세요. 긴 문자열을 손으로 드래그해 선택하는 것보다 훨씬 확실합니다.
코드가 워낙 길어서 끝부분이 잘리기 쉽습니다. 복사한 뒤에는 붙여 넣은 내용의 끝이 원본과 똑같이 끝나는지 확인하세요.
2. 코드를 변환하고 문서 확인하기
Base64를 PDF로 변환을 열고 “또는 텍스트 입력/붙여 넣기”를 누른 뒤 코드를 붙여 넣으세요. 디코딩이 끝나면 바로 첫 페이지가 나타나고, 그 아래에 페이지 수, PDF 버전, 파일 크기가 표시됩니다. 코드가 .txt 파일에 저장되어 있다면 그 파일을 선택하기만 하면 됩니다.
미리 보기로 다음을 빠르게 확인할 수 있습니다.
- 원하는 문서가 맞나요? 첫 페이지에서 인보이스 번호, 고객 이름, 운송장 정보를 확인할 수 있습니다.
- 페이지 수가 예상과 같나요? 페이지가 모자라면 코드가 일부만 복사된 것입니다.
- 암호가 걸려 있나요? 그렇다면 미리 보기 대신 안내 문구가 나타나며, 파일은 그래도 원래 상태 그대로 저장됩니다.
3. PDF를 저장하고 열기
“PDF 다운로드”를 누르세요. 파일은 아무것도 바뀌지 않은 채 저장되며 어떤 PDF 뷰어에서도 열립니다. 그다음은 필요에 따라 고르면 됩니다. 한 달 치 인보이스를 PDF 합치기로 한 파일에 모으거나, PDF 압축으로 이메일에 첨부할 만큼 용량을 줄이거나, PDF를 JPG로 변환으로 첫 페이지를 이미지로 만들 수 있습니다.
코드의 시작 부분으로 알 수 있는 것
| 코드의 시작 부분 | 안에 든 파일 |
|---|---|
| JVBERi0 | PDF 문서 |
| data:application/pdf;base64, | PDF 문서(데이터 URI) |
| iVBORw0KGgo | PNG 이미지 |
| /9j/ | JPG 사진 |
| UEsDB | ZIP, 워드(.docx), 엑셀(.xlsx) |
| PD94bWwg | XML 텍스트(예: 인보이스 데이터 자체) |
마지막 줄은 전자 인보이스에서 자주 생기는 혼동을 설명해 줍니다. 일부 서비스는 PDF 대신 인보이스 XML을 Base64로 보냅니다. 이 코드를 디코딩하면 문서가 아니라 읽을 수 있는 XML 텍스트가 나옵니다.
자주 하는 실수
코드를 .pdf 확장자의 텍스트 파일로 저장하기. 파일 안에는 여전히 Base64 텍스트가 들어 있어서 PDF 뷰어는 파일이 손상되었다고 표시합니다. 코드를 디코딩해야 합니다.
값보다 더 많이 복사하기. 코드 끝에 “,”나 “status” 같은 글자가 딸려 들어가면 코드가 올바르지 않게 됩니다. 값만 복사하거나 아예 응답 전체를 복사하세요. 도구는 두 경우 모두 코드를 정확하게 뽑아냅니다.
이스케이프된 줄바꿈. JSON 문자열에서는 코드가 76자마다 \n으로 나뉘어 있을 수 있습니다. 이 문자는 PDF의 일부가 아니며, 도구가 자동으로 지워 줍니다.
잘못된 응답. 문서가 아직 준비되지 않았으면 일부 API는 빈 필드나 오류 메시지를 돌려줍니다. 코드가 몇백 자 정도로 아주 짧다면 PDF가 아니라 오류 메시지일 가능성이 큽니다.
개인정보 보호에 관한 참고 사항
Base64는 문서를 보호하지 않으며, 형식만 바꿀 뿐입니다. 인보이스, 계약서, 진단서, 신분증 사본은 파일을 서버로 업로드하는 사이트에서 디코딩하지 마세요. PDFVela 도구는 사용 중인 기기에서 코드를 디코딩하며, 페이지가 열린 뒤에는 인터넷 연결이 끊겨도 계속 작동합니다.
직접 사용해 보시겠어요? 무료이며 파일은 내 기기에만 머뭅니다.
Base64를 PDF로 변환 열기