개발 연동을 위한 API 키 확인하기

by 토스페이먼츠

API 키 (결제연동 키) 확인 방법

먼저, 상점관리자에 접속하여 좌측 하단의 개발자 센터를 클릭해주세요.

그럼 아래처럼 API키를 확인할 수 있는데요, 두 가지 부분에서 유의가 필요해요.

1️⃣ 테스트/라이브 선택하기

필요에 따라 테스트키나 라이브 키를 발급 받을 수 있어요.

테스트 키는 실제로 결제가 나지 않아 연동 과정에서 사용하면 유용하고, 개발자센터 좌측 메뉴의 테스트 결제내역에서 확인할 수 있어요. 라이브 키는 라이브 배포할 때 사용해 주세요.

⚠️ 주의할 점

  • 테스트 API에서는 추가계약한 간편결제 수단이 확인 불가해요
  • 라이브 API에서는 심사완료된 결제수단만 확인 가능하며, 심사가 완료되지 않은 카드사일 경우 결제가 실패 될 수 있어요.

2️⃣ 연동할 MID 조정하기

계약완료된 아이디인지 확인해주세요

심사중, 계약취소된 아이디가 기본값인 경우가 있어요. 상점관리자>이용정보에서 상점아이디 계약 상태를 확인하여 계약완료인 아이디인지 확인해주세요.

키인, 빌링 등 추가 계약을 하셨을 경우 주의해주세요

만약 일반 결제가 아닌 키인이나 빌링, 브랜드페이 등을 추가로 계약하면 해당 결제 서비스에 대한 상점아이디와 키 세트가 새로 발급돼요. 해당 부분 연동시 새로 계약한 아이디가 맞는지 확인해주세요.

Q. 결제위젯을 사용하는데, MID는 어떻게 조정해야하나요? 결제위젯일 경우, 개발자센터가 아닌 상점관리자 내에서 조정이 필요해요. 먼저, 좌측 메뉴중 결제 UI 설정을 클릭해주세요. 아래 사진처럼 이미 결제위젯을 설정하셨을 경우, 이용서비스 우측의 버튼을 클릭해주세요.

그 다음으로, 위 안내 드린 두 가지 사항을 유의하여 실사용 할 상점아이디로 변경해주세요.

개발 연동 관련 더 궁금한 점이 있으시다면? 아래 연락망으로 문의해 주세요.

☎️ 고객 센터 - 기술 지원 : 1544-7772 (내선 2번-4번)

📩 메일 문의 : techsupport@tosspayments.com

💻 디스코드 문의 : https://developers.tosspayments.com/go/techchat

Writer 이현지

    의견 남기기
    토스페이먼츠

    고객사의 성장이 곧 우리의 성장이라는 확신을 가지고 더 나은 결제 경험을 만듭니다. 결제가 불편한 순간을 기록하고 바꿔갈게요.

    연관 콘텐츠