계약 하나로 카드, 계좌이체, 토스페이를 받습니다. 계약에 포함되면 삼성페이, 애플페이, 페이코도 같은 결제창에 나옵니다.
포트원 콘솔의 전자결제 신청이나 tosspayments.com에서 토스페이먼츠 온라인 결제를 신청하세요. 카드, 계좌이체와 함께 토스페이, 삼성페이, 애플페이, 페이코 등 원하는 간편결제를 고르세요.
카드사는 승인 전에 운영 중인 앱을 확인합니다. 토스페이먼츠는 지금 바로 살 수 있는 상품 1개 이상, 결제 금액과 같은 상품 가격, 배송 안내와 환불 정책, 사업자등록번호, 통신판매업 신고번호, 고객센터 연락처를 요구합니다. 빠진 것이 있으면 Insight에게 추가해 달라고 하세요.
토스페이먼츠 개발자센터(developers.tosspayments.com)에 로그인해 내 개발정보 → API 키로 이동하세요. 라이브 상점의 상점아이디(MID), 클라이언트 키, 시크릿 키를 확인하세요. 라이브 키는 live_로 시작합니다. 같은 화면에서 API 버전을 2022-07-27로 설정하세요.
포트원 콘솔에서 결제 연동 → 연동 관리 → 채널 관리로 이동하세요. 연동 모드를 실연동으로 바꾸고 토스페이먼츠와 결제 모듈을 고른 뒤 다음을 누르세요. 채널 이름을 정하고 MID, 클라이언트 키, 시크릿 키를 입력한 다음 과세구분을 고르고 저장하세요.
채널 목록에 새 채널이 채널 키와 함께 표시됩니다. channel-key-로 시작하는 채널 키를 복사하세요.
토스페이먼츠에 자동결제를 계약에 추가해 달라고 요청하세요. 승인되면 같은 방법으로 정기결제용 실연동 채널을 하나 더 추가하고 그 채널 키도 복사하세요.
프로젝트에서 결제 → 연결로 이동해 채널 키를 결제 채널에 붙여넣으세요. 정기결제 채널이 있다면 결제수단 더 보기를 열고 두 번째 채널 키를 정기결제 채널에 붙여넣으세요. 마지막으로 연결을 누르세요.
간편결제는 토스페이먼츠 계약에 포함된 것만 나옵니다. 토스페이먼츠에 계약 추가를 요청하세요.
카드사 심사가 아직 진행 중일 수 있습니다. 토스페이먼츠에 따르면 심사는 계약 완료 후 최대 10~14영업일이 걸리고, 연휴가 끼면 더 걸릴 수 있습니다.
채널에 테스트 키(test_)가 아니라 라이브 키(live_)를 넣었는지, 개발자센터의 API 버전이 2022-07-27인지 확인하세요.
메인 가이드의 테스트 단계처럼 테스트 모드로 채널을 추가하세요. 테스트 키로는 간편결제가 작동하지 않을 수 있습니다.