결제 연동 준비하기

포트원을 이용한 연동 개발이 처음이시라면 아래 안내 사항에 따라 진행하세요.

1. 포트원 회원가입 하기

포트원 관리자 콘솔은 별도 계약 없이 무료로 회원가입이 가능합니다.

로그인 화면 예시
로그인 화면 예시
  • 포트원에서 사용할 이메일 주소 및 비밀번호를 입력한 후 [가입]을 눌러주세요.
회원가입 화면 예시
회원가입 화면 예시
  • 가입 완료 후 입력하신 이메일로 인증 메일이 발송됩니다. 메일 인증 전까지 로그인이 불가능하오니 꼭 인증 후 로그인을 시도해 주세요.
인증 메일 내용 예시
인증 메일 내용 예시

메일을 받지 못하신 경우 스팸메일함을 확인해주세요.


2. 전자결제 신청하기

비지니스 정보(사업자 정보) 등록 후 이용할 결제대행사 및 결제수단 신청합니다.

  • 로그인 후 [홈]화면에서 왼쪽 상단에 [전자결제 신청]을 클릭해 주세요.
  • 약관 동의 후 [시작하기!]를 클릭해 주세요.
약관동의 화면 예시
약관동의 화면 예시
  • [비지니스 인증] 정보를 단계에 따라 입력합니다.
  • [전자결제 신청] 정보를 단계에 따라 선택합니다.

아직 전자결제 신청 전이라면 상세 가이드를 참고하여 전자결제를 신청해보세요! → 전자결제 신청 상세 가이드 바로가기

전자결제 신청 전 테스트를 하고싶으신 분은 아래 결제대행사 채널 설정하기를 참고하신 후 테스트 환경으로 채널 추가하여 테스트를 진행하실 수 있습니다.

3. 결제대행사 채널 설정하기

결제 연동 시 사용할 결제대행사 채널을 추가합니다.

  • 관리자 콘솔 화면에서 [결제 연동] → [연동 관리] → [채널 관리] 메뉴에서 연동하고자 하는 결제대행사 및 결제 모듈을 선택하여 채널을 추가합니다.

3-1. 연동 방법

테스트 환경 채널 연동 방법

  1. 연동 모드를 테스트로 변경해 주세요.
  2. 사용할 결제대행사를 선택해 주세요.
  1. 연동할 결제방식 및 결제수단에 따라 결제 모듈을 선택해 주세요.
  2. 다음 버튼을 클릭해 주세요.
  1. 채널 이름은 원하시는 이름으로 입력해 주세요. 채널 이름은 채널 목록에 표시되므로 사용자가 구분할 수 있는 값으로 입력하여 사용해 주세요. ex) KCP 정기결제용 (공용 테스트 채널이 제공되는 결제대행사의 경우 MID 선택 시 자동으로 표시됩니다.)

  2. 채널 속성은 기본적으로 결제가 선택됩니다. 본인인증 용도로 채널을 연동하시는 경우 본인인증을 선택해 주세요.

  3. 테스트 용도로 발급 받은 상점 아이디를 직접 입력하시거나, 제공되는 다른 공용 상점아이디를 선택합니다.

  4. 추가로 입력해야 하는 정보는 결제대행사별로 상이하며, 직접 발급받은 테스트 상점아이디를 이용하시는 경우 필수 입력 항목을 확인하여 올바르게 입력해 주세요.

  5. 과세구분을 선택해 주세요. 과세 혹은 면세 설정 시 [결제사 정산] 메뉴에서 부가세 신고 참고 자료용 데이터에 적용됩니다.

  6. 저장버튼을 눌러 채널을 추가를 완료합니다.

채널 등록 시 결제대행사별 저장하는 파라미터가 다릅니다. 파라미터 정보 확인은 하단의 [결제대행사별 연동 정보 확인하기]를 확인해주세요.

3-2. 결제대행사별 연동 정보 확인하기

결제대행사

간편결제 직연동

해외 결제대행사

4. 포트원 연동정보 확인하기

포트원을 이용한 결제 연동 시 필요한 연동정보를 확인합니다.

  • 관리자 콘솔 화면에서 [결제 연동] → [연동 관리] → [식별코드·API Keys] 메뉴에서 [V1 API]를 선택하여 고객사 식별코드, REST API Key, REST API Secret을 확인할 수 있습니다.

고객사 식별코드란?

  • 포트원 가입 시 사용자에게 자동으로 생성되는 고유값입니다.
  • 결제창 연동 시 사용되며, 결제 호출 시 [객체 초기화]에 사용됩니다.
  • 기술 문의 시 해당 값을 공유해 주시면 빠르게 문제 해결을 도와드릴 수 있습니다.

REST API Key, REST API Secret란?

  • V1 API 호출 시 사용되는 Access Token을 발급할 때 사용되는 값입니다.
  • REST API Secret은 재발급이 가능하며, 재발급 즉시 기존의 Secret은 사용이 불가능합니다.

REST API Key, REST API Secret 결제 거래 건을 컨트롤할 수 있는 민감 정보로 외부로 유출되지 않도록 주의가 필요합니다.