토스페이 연동 테스트 방식

토스페이 연동 구축 시, 가맹점은 두 가지 방식으로 테스트를 진행할 수 있습니다. 각 방법을 확인한 후, 적합한 방법을 선택하여 테스트를 진행해 주세요.

운영 환경에서 테스트용 API Key를 사용해 테스트 진행

운영 환경에서 테스트용 API Key를 사용해 테스트를 진행한 후, 테스트 완료 시 실거래용 API Key로 교체하여 실제 사용자들에게 서비스를 오픈하는 방식입니다.

• 테스트용 API Key (sk_test_***): 운영 환경에서 테스트 거래로 인식되어 금전 이동이나 정산은 발생하지 않습니다. 예를 들어, 머니/계좌 결제 시 출금이 없고, 카드 결제 시 실제 승인이 이루어지지 않습니다. 하지만 응답은 정상적으로 처리됩니다.
• 실거래용 API Key (sk_live_***): 실제 사용자에게 서비스를 오픈할 때 사용하는 키로, 실제 거래로 인식되어 금전 이동 및 정산이 발생합니다. 테스트 결제 시에는 꼭 당일 취소가 될 수 있도록 처리 부탁드립니다.

개발 환경에서 테스트 후 운영 환경 오픈

개발 환경에서 테스트 진행 후, 운영 환경으로 전환하여 서비스를 오픈하는 방식입니다. 개발 환경에서 테스트를 위해 별도의 개발 API Key가 발급됩니다.

• 테스트용 API Key (sk_test_***): 개발 환경에서 요청이 전달되며, 금전 이동이나 정산은 발생하지 않습니다.
• 실거래용 API Key (sk_live_***): 개발 환경에서 실제 금전 이동이 발생합니다. 예를 들어, 토스 개발계 앱에 등록된 계좌에서 금액이 출금되거나, 카드사 테스트 카드가 등록되고 카드사로부터 응답을 받습니다.

개발 환경 테스트 주의사항

• 사전에 방화벽 등록이 필요하며, 토스 개발계 앱을 별도로 설치해야 합니다.
• 개발 환경 접근은 허용된 IP에서만 가능하므로, 가맹점의 IP 정보를 토스에 전달하여 등록해 주세요.
• 앱 스토어에서 다운로드 가능한 일반 토스 앱이 아닌, 별도의 알파 앱을 사용해야 하므로 설치가 필요한 분의 성명, 이메일 주소, 사용하는 모바일 OS(iOS/AOS) 정보를 전달해 주세요.
• 개발계 쪽은 실제 휴대폰 인증이 진행되지 않으므로, 별도의 인증번호를 발급받으려면 토스 개발계 앱에 가입할 휴대폰 번호를 알려주셔야 합니다.

추가 테스트 방법 안내

운영 환경 테스트 방법

• 계약이 완료된 경우, 가맹점 전용 테스트용 API Key를 사용하여 테스트할 수 있습니다.
• 계약이 완료되지 않아 MID가 발급되지 않은 상태에서 테스트를 원하는 경우, 공용 테스트용 API Key (sk_test_w5lNQylNqa5lNQe013Nq)를 사용할 수 있습니다. 이 키는 운영 환경에서 여러 가맹점이 공용으로 사용하는 테스트 키로, 많은 가맹점의 테스트 거래가 섞일 수 있습니다.
• 테스트 시, 최신 버전의 토스 앱을 사용하고 실제 소유한 개인 카드를 등록한 후 진행해 주세요.

위의 내용을 참고하여, 각 환경에 맞게 안전하고 효율적으로 테스트를 진행해 주시기 바랍니다.