토스페이연동 관련 문의

개발
,
1

개발환경

  • react, react-router v7 (webview 방식)
  • @apps-in-tossapps-in-tossapps-in-tossapps-in-toss/web-framewo@toss-@tosse@toss-design-systemesign-systemign-systemk 1.1.0
  • @toss-@toss-design-systemesign-system/mobile 2.1.0
  • @toss-design-system/mobile-ait 2.1.0

토스페이 간편결제 관련 계약 완료 메일을 받고,
관련 결제 API Key 를 전달 받았습니다.

문제사항

  1. 앱인토스 개발 가이드에 명시 된 대로 콘솔의 연동키 등록 시 전달받은 API 키와 테스트용 API 키를 등록하면
    Internal Server Error 가 발생합니다.
    1. 더불어 (당연하게도) 앱인토스 가이드 내의 결제 생성 요청 시, “토스페이 청약이 되어 있지 않습니다” 오류를 반환합니다.
  2. 개발 가이드 참조 문의
    1. 해당 메일에서 가이드 URL 을 https://docs-pay.toss.im/guide/create 로 전달 받았습니다.
    2. 현재 앱인토스 개발 가이드인 개발하기 | 앱인토스 개발자센터 를 참고하여
      개발을 진행중에 있는데, 가이드 내용이 서로 상이합니다.
      1. 위 두 API 명세의 엔드포인트가 서로 다르며, 앱인토스 개발 가이드의 결제 생성부터 결제 실행까지 그 어느부분에도 발급받은 API 키에 대한 내역이 없습니다.

위와 같이, 전달받은 API 키 및 테스트 키를 앱인토스 콘솔에서 등록이 불가한 상황이며,

개발 시 어느 가이드를 참조하여 진행해야 하는건가요?

토스페이 가이드와 앱인토스의 토스페이 연동 가이드의 엔드포인트와 요청정보 설명이 상이한 상황인데,

토스페이 가이드의 엔드포인트로 결제 생성을 진행 후,
다시 앱인토스 가이드의 SDK 를 이용한 결제 인증을 진행하고,
다시 토스페이 가이드의 엔드포인트로 승인처리를 해야 하는건가요?

2
  1. 콘솔에서 Internal Server Error 가 발생하시는걸까요? appName 알려주실 수 있을까요?
  2. 메일 내용 수정 요청할게요. 앱인토스 개발자센터 가이드를 보시고 개발해주셔야 합니다.
3

네. 콘솔에서 Internal Server Error 발생합니다.

스크린샷 2025-09-16 17.47.33
스크린샷 2025-09-16 17.47.331007×359 53.3 KB

AppName 은 minda 입니다.

4

해당 오류 때문에 “토스페이 청약이 되어 있지 않습니다” 오류가 반환되나 봅니다

얼른 수정하고 말씀드릴게요.

5

@minda-martine 님, 조치 완료되었습니다.

다시 한번 key 등록을 부탁드립니다.

6

@seonjeong 님 정상적으로 api key 등록 확인하였습니다.

개발 테스트에서 토스페이 결제 연동도 정상적으로 처리되는 것 확인하였습니다.

감사합니다.

1개의 좋아요