일본(운영국가 JP) 캠페인의 일본어 전자계약서와 PayPal·일본은행 지급정보

일본 계약서

캠페인 운영 국가가 일본인 경우, 전자계약서가 일본어로 발송되고 지급정보가 PayPal 또는 일본 은행계좌 형태로 입력됩니다. 미국은 영문 계약서, 그 외 국가는 기존 한국어 계약서로 동작합니다.

계약서 언어는 계약 발송 시점에 캠페인 운영 국가(Collab.nation)로 결정되어 계약서에 고정 저장됩니다. 이후 국가 값이 바뀌어도 발송된 계약서의 언어는 변하지 않습니다.

언어 결정 규칙

캠페인 운영 국가 (`nation`)	계약서 언어 (`language`)
`JP` (일본)	`JA` (일본어)
`US` (미국)	`EN` (영어) — 영문 계약서 참고
그 외 모든 국가	`KO` (한국어, 폴백)

기존(레거시) 계약서는 language 값이 비어 있으며 체결 당시 언어(KO 또는 JA)로 고정되어 있습니다.

한국어 계약서와의 차이

구분	한국어(KO)	일본어(JA)
조항	12개 조항	13개 조항 (税金処理 조항 추가)
광고 단가 표기	"만원" 단위	`円` 단위 (예: `5,000,000円`)
지급정보	한국 은행 계좌 필드	PayPal 또는 일본 은행계좌 (토글)
분쟁 관할	ソウル中央地方法院	ソウル中央地方法院 (크로스보더, 동일)
PDF 폰트	NanumGothic	IPAexGothic (일본어)

조회/입력 API는 한국어 계약서와 동일한 엔드포인트를 사용하며, 응답·요청에 아래 필드가 추가됩니다.

지급정보 (`paymentInfo`)

일본어 계약서는 정산 계좌를 결제수단별 구조로 입력받습니다. 크리에이터 정보 입력 요청과 상세 조회 응답 모두 paymentInfo 객체를 사용합니다.

Prop

Type

일본어 계약서에서는 paymentInfo(결제수단 + 해당 payload 전체 필드)가 필수입니다. 선택한 수단의 필수 필드가 누락되면 400 INVALID_DATA로 거부됩니다. 한국어 계약서는 기존 bankName·bankAccountNumber·accountHolderName 필드를 사용하며 paymentInfo를 보내지 않습니다.

입력 요청 예시

{
  "stageName": "yumi",
  "realName": "山田 由美",
  "signerName": "山田 由美",
  "address": "東京都千代田区...",
  "representative": "山田 由美",
  "paymentInfo": {
    "method": "PAYPAL",
    "payload": {
      "holderNameKana": "ヤマダ ユミ",
      "paypalId": "yumi@example.com"
    }
  }
}

{
  "stageName": "yumi",
  "realName": "山田 由美",
  "signerName": "山田 由美",
  "address": "東京都千代田区...",
  "representative": "山田 由美",
  "paymentInfo": {
    "method": "JP_BANK",
    "payload": {
      "holderNameKana": "ヤマダ ユミ",
      "countryCode": "+81",
      "phoneNumber": "09012345678",
      "email": "yumi@example.com",
      "zipCode": "1000001",
      "prefecture": "東京都",
      "city": "千代田区",
      "streetAddress": "1-1-1 〇〇ビル 101",
      "accountType": "普通",
      "bankCode": "0001",
      "branchCode": "001",
      "accountNumber": "1234567"
    }
  }
}

PDF에는 일본어 13개 조항 + 甲/乙 정보 + 선택한 수단의 지급정보 섹션(【支払先情報】)이 일본어로 렌더링됩니다. 입력 값에 한글이 섞이면 일본어 폰트에 한글 글리프가 없어 PDF 생성이 실패할 수 있으니, 일본어/영문/숫자로 입력하세요.

정산 시트

일본(nation=JP) 캠페인의 정산은 한국과 별도 레이아웃으로 처리됩니다 — 다운로드·주간(목요일) 메일·월별 시트 모두 동일 항목을 사용합니다.

엔드포인트: GET /ai/admin/campaigns/{campaignNo}/settlement-export?format=excel|csv (운영국가가 일본이면 자동으로 일본 레이아웃)
통화: 엔화(円) 그대로 — 세금/원천징수 컬럼 없음
지급정보 출처: 계약서의 paymentInfo(PayPal / 일본은행) 항목
주요 컬럼: 캠페인명, 크리에이터명, 이메일, 계약금액(円), 지급방식, 예금주(카나), PayPal ID, 은행코드·지점코드·계좌종별·계좌번호, 주소(우편번호·도도부현·시구정촌·번지), 계약서 PDF 링크, 신분증/서류 링크
CSV/Excel 셀은 수식 인젝션 방지 처리됨

주간(목요일) 메일과 월별 구글시트 전송에도 동일하게 반영됩니다. 주간 메일은 일본 캠페인이면 일본 레이아웃 xlsx가 첨부되고, 월별 시트는 한국 캠페인과 분리된 별도 탭 YYYY-MM (일본) 에 기록됩니다.

일본 계약서

일본 계약서

언어 결정 규칙

한국어 계약서와의 차이

`language` 필드

지급정보 (`paymentInfo`)

PAYPAL 선택 시 payload

銀行口座(JP_BANK) 선택 시 payload

입력 요청 예시

정산 시트

On this page