토스페이먼츠 API 키는 어디서 확인하나요? 결제 연동 전 확인할 사항

토스페이먼츠 결제 연동을 시작하려면 API 키와 상점아이디(MID)를 먼저 확인해야 해요. 키나 아이디를 잘못 설정하면 결제가 정상적으로 진행되지 않을 수 있기 때문이에요.

특히 호스팅 서비스를 이용하지 않고 API를 사용해 직접 연동하는 경우, 상점관리자에서 API 키를 확인하고 실제 연동할 상점아이디가 맞는지 살펴보는 과정이 필요해요.

개발 외주업체와 함께 작업하고 있다면 개발 담당자를 토스페이먼츠 상점관리자에 초대해 필요한 정보를 함께 확인할 수도 있어요.

1. 토스페이먼츠 API 키는 어디서 확인하나요?

토스페이먼츠 상점관리자에 접속한 뒤, 왼쪽 하단의 ‘개발자 센터’를 클릭하면 API 키를 확인할 수 있어요.

API 키를 확인할 때는 테스트용인지 라이브용인지, 그리고 실제로 연동할 상점아이디가 맞는지 함께 살펴봐야 해요.

토스페이먼츠 API 키는 어디서 확인하나요? 결제 연동 전 확인할 사항

개발자 센터에 들어가면 API 키를 확인할 수 있어요. 여기서 아래 두 가지 사항을 꼭 확인해 주세요.

테스트 API 키는 실제 결제가 발생하지 않는 테스트 환경에서 사용하고, 라이브 API 키는 실제 서비스에 배포할 때 사용해요.

결제 연동을 개발하는 단계에서는 테스트 API 키로 결제 요청과 승인 흐름을 확인할 수 있어요. 테스트 결과는 개발자센터의 테스트 결제내역에서 확인할 수 있어요.

실제 서비스를 운영할 때는 라이브 API 키를 사용해야 해요. 다만 라이브 환경에서는 계약과 심사가 완료된 결제수단만 정상적으로 이용할 수 있으므로, 서비스 배포 전에 결제수단별 이용 가능 여부를 확인하는 것이 좋아요.

테스트 API 환경에서는 추가 계약한 일부 간편결제 수단이 표시되지 않을 수 있어요.

또한 라이브 API 환경에서는 심사가 완료된 결제수단만 이용할 수 있어요. 해당 카드사나 결제수단의 심사가 완료되지 않았다면 결제가 실패할 수 있으므로, 실제 서비스에 적용하기 전에 계약 및 심사 상태를 확인해 주세요.

API 키를 확인할 때는 실제로 연동할 상점아이디가 맞는지도 확인해야 해요. 상점아이디의 계약 상태가 완료되지 않았거나, 다른 결제 서비스용 아이디를 선택했다면 예상한 결제 기능이 정상적으로 작동하지 않을 수 있어요.

상점관리자의 ‘이용정보’ 메뉴에서 상점아이디의 계약 상태를 확인해 주세요.

심사 중이거나 계약이 취소된 상점아이디가 기본값으로 선택되어 있을 수도 있어요. 따라서 현재 선택된 아이디가 실제 사용할 상점아이디인지, 계약 상태가 완료인지 확인하는 것이 중요해요.

일반 결제가 아닌 키인, 빌링, 브랜드페이 등 별도의 결제 서비스를 추가 계약했다면 해당 서비스에 맞는 상점아이디와 키 세트가 발급될 수 있어요.

이 경우 일반 결제용 상점아이디와 혼동하지 않도록 주의해야 해요. 연동하려는 결제 서비스에 맞는 상점아이디와 API 키를 선택했는지 확인해 주세요.

결제위젯을 이용한다면 개발자 센터가 아니라 상점관리자의 ‘결제 UI 설정’ 메뉴에서 상점아이디를 확인하고 변경해야 해요.

먼저 상점관리자 왼쪽 메뉴에서 ‘결제 UI 설정’을 선택해 주세요. 이미 결제위젯을 설정했다면 이용서비스 오른쪽의 버튼을 클릭해 설정 화면으로 이동하면 돼요.

이후 앞에서 설명한 것처럼 계약 상태가 완료된 상점아이디인지, 실제 사용할 결제 서비스에 맞는 아이디인지 확인한 다음 변경해 주세요.

상점아이디를 변경한 뒤에는 선택한 아이디가 의도한 결제 서비스와 일치하는지 다시 한번 확인하는 것이 좋아요.

API 키나 상점아이디를 확인했는데도 결제 연동에 문제가 있다면 토스페이먼츠 기술 지원 채널로 문의할 수 있어요.

결제 연동 문제를 문의할 때는 어떤 환경에서 문제가 발생했는지, 테스트용인지 라이브용인지, 어떤 결제수단을 사용했는지 등을 함께 정리하면 원인을 확인하는 데 도움이 돼요. 단, 문의 과정에서도 시크릿 키 등 민감한 인증 정보는 외부에 노출하지 않도록 주의해 주세요.