법인 신용카드 연동

## 이 연동으로 보이는 것 - 법인카드 **사용 내역** (일자 · 가맹점 · 금액) - 카드별 사용액 집계 - 법인카드 화면 상세, 재무 화면 반영 - 여러 카드사를 각각 등록 가능 ## ⚠️ 시작 전 확인 이 연동은 **카드사 홈페이지 로그인 ID 와 비밀번호를 서비스에 등록**해야 합니다. 반드시 **재무 담당자와 내부 승인 절차를 거쳐** 진행하세요. 권장 사항: - 개인 명의가 아닌 **법인 공용 계정** 사용 - 결제·한도 변경 권한이 없는 **조회 전용 계정**을 만들 수 있으면 그것을 사용 - 카드사가 비밀번호 주기적 변경을 강제하면, 변경 후 **즉시 재등록** 자격증명 보관 방식은 [자격증명 보관과 보안](/news/guide/integration-security)에 있습니다. ## 지원 카드사 | 카드사 | 상태 | |---|---| | **롯데카드** | ✅ 동작 확인됨 | | 신한 · KB국민 · 현대 · 삼성 · BC · 우리 · 하나 | 지원 목록에 포함 (환경에 따라 확인이 필요할 수 있습니다) | > 롯데카드 외 카드사에서 등록이 실패하면 [문의](/news/guide/contact)해 주세요. > 카드사별 로그인 요건이 자주 바뀝니다. ## 사전 준비물 ### 1단계 — 연동 서비스 기본 정보 (워크스페이스당 한 번) 법인 은행 계좌와 **같은 기본 정보를 공유**합니다. 이미 계좌를 연동했다면 이 단계는 생략됩니다. | 항목 | |---| | Client ID (UUID 형식) | | Client Secret | | RSA Public Key (base64) | ### 2단계 — 카드사별 등록 | 항목 | 비고 | |---|---| | **카드사 선택** | 위 목록 | | **로그인 ID** | 카드사 **홈페이지** ID | | **비밀번호** | 카드사 홈페이지 비밀번호 | | 사업자등록번호 | 선택 — 10자리 숫자, 하이픈 제외 | | **롯데 회원 구분** | 롯데카드 선택 시에만 표시 | ### 롯데카드 회원 구분 롯데카드는 로그인 유형을 함께 지정해야 합니다. | 구분 | 언제 | |---|---| | **법인관리자** | 법인 전체 카드를 관리하는 계정 (기본값) | | 개별카드 회원 | 개인에게 배정된 카드 하나만 보는 계정 | | 공용카드 회원 | 부서 공용카드 계정 | 법인 전체 사용 내역을 보려면 **법인관리자** 계정으로 등록하세요. ## 연동 절차 1. **설정 → 데이터 연동** 탭 2. (기본 정보가 없으면) **Codef 연동** 기본 정보 먼저 저장 3. **Codef 연동 → 법인 신용카드** 클릭 4. **카드사** 선택 5. **로그인 ID** · **비밀번호** 입력 6. (롯데카드면) **회원 구분** 선택 7. (선택) 사업자등록번호 입력 8. **등록** 여러 카드사를 쓰면 카드사별로 반복합니다. ## 확인 방법 1. 등록 목록에 카드사와 등록일이 표시되는지 2. **법인카드** 화면에 사용 내역이 나오는지 3. 카드사 홈페이지 이용 내역과 같은 기간을 비교 ## 카드 금액이 나중에 바뀌는 이유 카드 데이터는 **승인 → 매입 확정** 두 단계를 거칩니다. | 단계 | 시점 | |---|---| | 승인 | 결제 즉시 | | 매입 확정 | 가맹점 청구 후 며칠 뒤 | 따라서 **최근 며칠 금액은 계속 변합니다.** 확정 금액이 필요한 보고에는 최소 며칠 지난 구간을 쓰세요. 이는 정상 동작입니다. ## 자주 나는 오류 | 증상 | 원인 | 대응 | |---|---|---| | 로그인 실패 | 카드사 홈페이지 **비밀번호 변경** | 새 비밀번호로 재등록 | | 로그인 실패 | **계정 잠김** (로그인 실패 누적) | 카드사 홈페이지에서 잠김 해제 후 재등록 | | 로그인 실패 | 홈페이지 계정이 아닌 앱 전용 계정 | 홈페이지 로그인 계정으로 재시도 | | 등록은 되는데 내역이 없다 | 롯데카드 **회원 구분** 이 개별/공용 | **법인관리자** 로 재등록 | | 일부 카드만 보인다 | 계정에 배정된 카드만 조회됨 | 법인관리자 계정 사용 | | 금액이 홈페이지와 다르다 | 승인/매입 시점 차이 | 며칠 뒤 재확인 | | 특정 카드사만 실패 | 카드사 로그인 요건 변경 | [문의](/news/guide/contact) | ## 정기 점검 | 주기 | 확인 | |---|---| | 매주 | 최근 사용 내역이 갱신되는지 | | 비밀번호 변경 직후 | **즉시 재등록** | | 담당자 교체 시 | 공용 계정으로 이전 | ## 제약 - 카드사가 비밀번호 변경을 강제하면 그때마다 재등록이 필요합니다 - 조회 가능한 기간은 카드사 정책을 따릅니다 - 최근 며칠 금액은 매입 확정 전이라 변동합니다 - 롯데카드 외 카드사는 환경에 따라 확인이 필요할 수 있습니다 ## 관련 문서 - [법인 은행 계좌 연동](/news/guide/codef-bank) — 기본 정보를 공유합니다 - [재무제표 업로드](/news/guide/financial-statements) - [자격증명 보관과 보안](/news/guide/integration-security)