계약 생성

post

https://public-api-service.dev.iamport.co/platform/contracts

새로운 계약을 생성합니다.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

계약 객체 생성을 위한 입력 정보

string

name

string

required

memo

string

platformFee

object

required

수수료 계산 방식을 특정하기 위한 입력 정보

정률 수수료를 설정하고 싶은 경우 fixedRate 필드에, 정액 수수료를 설정하고 싶은 경우 fixedAmount 필드에 값을 명시해 요청합니다.
두 필드 모두 값이 들어있지 않은 경우 요청이 거절됩니다.

settlementCycle

object

required

플랫폼 정산 주기 입력 정보

platformFeeVatPayer

string

enum

required

금액 부담 주체

플랫폼에서 발생한 결제 수수료, 부가세 등 금액을 부담하는 주체를 나타냅니다.

Allowed:

subtractPaymentVatAmount

boolean

required

Responses

`InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우

계약 생성

`InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우

`UnauthorizedError`: 인증 정보가 올바르지 않은 경우

`PlatformNotEnabledError`: 플랫폼 기능이 활성화되지 않아 요청을 처리할 수 없는 경우

`PlatformContractAlreadyExistsError`

200성공 응답으로 생성된 계약 객체가 반환됩니다.

400 InvalidRequestError: 요청된 입력 정보가 유효하지 않은 경우

401 UnauthorizedError: 인증 정보가 올바르지 않은 경우

403 PlatformNotEnabledError: 플랫폼 기능이 활성화되지 않아 요청을 처리할 수 없는 경우

409 PlatformContractAlreadyExistsError

`InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우

`UnauthorizedError`: 인증 정보가 올바르지 않은 경우

`PlatformNotEnabledError`: 플랫폼 기능이 활성화되지 않아 요청을 처리할 수 없는 경우

`PlatformContractAlreadyExistsError`