개발자센터

토스페이먼츠 설정

토스페이먼츠 PG설정 방법을 안내합니다.

토스페이먼츠 신 모듈 연동 안내

포트원 토스페이먼츠 연동은 토스페이먼츠의 API 버전에 따라 신 모듈(2022-07-27) / 구 모듈(1.4) 연동 방식을 제공하고 있습니다. 연동하는 가맹점 입장에서는 구 모듈과 신 모듈의 서비스 차이점은 존재하지 않으나, 원활한 기술 지원 및 더 나은 연동 경험을 위해 신 모듈로 연동하시는 것을 권장드립니다.

일반결제 및 정기결제 (신 모듈)

토스페이먼츠 API 버전 설정

API 버전을 다르게 설정하면 결제 승인 / 실패 시 실제 응답과 다른 응답을 받아볼 수 있으니 반드시 API 버전을 2022-07-27로 맞춰주시기 바랍니다

테스트 환경 구성 방법

  1. 포트원 관리자 콘솔 로그인
  2. 결제 연동테스트 연동 관리
  3. 결제 대행사 설정에서 토스페이먼츠 / 토스페이먼츠 선택 후 오른쪽 + 추가 버튼 클릭
  1. 테스트 연동 정보 확인 후 오른쪽 하단 저장 버튼 클릭
  • 토스페이먼츠 일반결제 테스트 iamporttest_3
  • 토스페이먼츠 정기결제 테스트 iamporttest_4
테스트 환경 상세 설정 예시
테스트 환경 상세 설정 예시
  1. 등록 완료 후, 결제 요청 SDK의 PG 파라미터에 tosspayments.PG상점아이디를 입력
    • 토스에서 직접 계약 후 발급받은 상점아이디의 테스트 API 키로 진행해주세요.
      토스페이먼츠 개발자센터의 공용 테스트 API 키를 사용하시면 에러가 발생합니다.

실 환경 구성 방법

  1. 포트원 관리자 콘솔 로그인

  2. 결제 연동실 연동 관리

  3. 결제 대행사 설정에서 토스페이먼츠 / 토스페이먼츠 선택 후 오른쪽 + 추가 버튼 클릭

  4. 실 연동 정보 입력 후 오른쪽 하단 저장 버튼 클릭

  5. 등록 완료 후, 결제 요청 SDK의 PG 파라미터에 tosspayments.실연동상점아이디를 입력

인증 결제 (구 모듈)

테스트 환경 구성 방법

  1. 포트원관리자콘솔 -> 결제연동 -> 테스트 연동관리 -> 토스페이먼츠 -> (구)토스페이먼츠 -> 추가
  2. 자동으로 설정된 테스트 MID 확인후 저장 선택
결제연동 -> 테스트 연동관리 -> 토스페이먼츠 -> (구)토스페이먼츠 -> 추가
결제연동 -> 테스트 연동관리 -> 토스페이먼츠 -> (구)토스페이먼츠 -> 추가
자동으로 설정된 테스트 MID 확인후 저장
자동으로 설정된 테스트 MID 확인후 저장

실 환경 구성 방법

  1. 결제연동 -> 실 연동관리 선택
  2. 토스페이먼츠 -> (구) 토스페이먼츠 선택 -> 추가
  3. 토스페이먼츠와 계약 후 발급된 연동상점정보(MID/ MertKey)를 기재합니다.

발급 MID 방식

포트원을 통한 토스페이먼츠 인증결제를 위해서는 토스페이먼츠 인증결제 MID 발급 요청시 반드시 구 인증 모듈 방식이라고 언급해주셔야 올바른 값을 부여받을 수 있습니다.

토스페이먼츠 -> (구) 토스페이먼츠 선택 -> 추가
토스페이먼츠 -> (구) 토스페이먼츠 선택 -> 추가
토스페이먼츠와 계약 후 발급된 연동상점정보(MID/ MertKey)를 기재
토스페이먼츠와 계약 후 발급된 연동상점정보(MID/ MertKey)를 기재