create
suspend fun createPlatformPartner(id: String? = null, name: String, contact: CreatePlatformPartnerBodyContact, account: CreatePlatformPartnerBodyAccount, defaultContractId: String, memo: String? = null, tags: List<String>, type: CreatePlatformPartnerBodyType, userDefinedProperties: PlatformProperties? = null): CreatePlatformPartnerResponse
파트너 생성
새로운 파트너를 생성합니다.
Parameters
id
파트너에 부여할 고유 아이디
고객사 서버에 등록된 파트너 지칭 아이디와 동일하게 설정하는 것을 권장합니다. 명시하지 않는 경우 포트원이 임의의 아이디를 발급해드립니다.
name
파트너 법인명 혹은 이름
contact
파트너 담당자 연락 정보
account
정산 계좌
파트너의 사업자등록번호가 존재하는 경우 명시합니다. 별도로 검증하지는 않으며, 번호와 기호 모두 입력 가능합니다.
default
기본 계약 아이디
이미 존재하는 계약 아이디를 등록해야 합니다.
memo
파트너에 대한 메모
총 256자까지 입력할 수 있습니다.
tags
파트너에 부여할 태그 리스트
최대 10개까지 입력할 수 있습니다.
type
파트너 유형별 추가 정보
사업자/원천징수 대상자 중 추가할 파트너의 유형에 따른 정보를 입력해야 합니다.
user
사용자 정의 속성
Throws
요청이 거절된 경우
요청된 입력 정보가 유효하지 않은 경우
파트너 계좌 검증 아이디를 이미 사용한 경우
파트너 계좌 인증이 실패한 경우
파트너 계좌 검증 아이디를 찾을 수 없는 경우
PlatformContractNotFoundError
지원 되지 않는 통화를 선택한 경우
플랫폼 기능이 활성화되지 않아 요청을 처리할 수 없는 경우
PlatformPartnerIdAlreadyExistsError
사용자 정의 속성이 존재 하지 않는 경우
인증 정보가 올바르지 않은 경우
API 응답이 알 수 없는 형식인 경우