Live API Key 사용 시 Flutter 결제수단 선택 후 화면이 흰색으로 표시되는 문제
안녕하세요, 토스페이먼츠 기술지원팀 담당자님.
현재 Flutter 애플리케이션에 토스페이먼츠 결제 연동을 진행하고 있습니다.
Test API Key로는 모든 기능이 정상적으로 동작하며, 위젯 로딩부터 결제수단 선택, 결제 진행까지 문제없이 처리됩니다.
하지만 Live API Key로 전환 후 다음과 같은 문제가 발생하고 있습니다.
🔧 문제 상황
Payment Widget 자체는 정상적으로 로드됨
결제수단 목록(Toss Pay, Payco, 카드 등)도 정상 출력됨
그러나 어떤 결제수단을 선택하더라도 화면이 완전히 흰색으로 변하며
결제 페이지(WebView)가 전혀 표시되지 않음
Flutter 콘솔/로그에도 별다른 에러가 출력되지 않음
실제 결제 페이지로 넘어가지 못함
같은 코드에서 Test Key는 100% 정상 작동,
Live Key 사용 시에만 위 현상이 발생합니다.
해당 현상을 보여주는 영상도 함께 첨부했습니다.
🔑 사용 중인 실서비스 정보
상점 ID(MID): hilolmngaf
Client Key: [LIVE_CLIENT_KEY]
Secret Key: [LIVE_SECRET_KEY]
❓ 문의 사항
해당 Live API Key가 정상적으로 활성화된 상태인지 확인 가능할까요?
(실 결제 사용을 위해 추가 승인 절차가 필요한지 궁금합니다.)
저희 상점 ID(hilolmngaf)에 모든 결제수단(Toss pay, Payco, 카드 등)이 정상적으로 활성화되어 있는지 확인 부탁드립니다.
Flutter/WebView 환경에서 등록해야 하는 Redirect URL 또는 허용 도메인이 있는지 궁금합니다.
특정 설정 미비로 인해 결제 페이지가 흰 화면으로 뜨는 경우가 있는지요?
저희 측에서 사용 중인 Live Client Key / Secret Key 구성이 정상적인지 검토 부탁드립니다.
Test 환경에서는 완벽히 정상 작동하고 있어, 현재 실서비스 API Key 관련 문제로 판단됩니다.
서비스 오픈이 가까운 상황이라 빠른 확인 부탁드립니다.
감사합니다.
11 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
영상 첨부가 안되었는데 첨부 바랍니다
일단 계약 자체는 문제가 없습니다.
혹시 플러터 웹뷰에서 특정 도메인만 뜨도록 하신건 아닌지 확인부탁드립니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
안녕하세요,
orderId 형식에 대해 질문이 있습니다.
문서에서 orderId는 "충분히 무작위한 값을 생성해서 각 주문마다 고유한 값"이라고 되어 있는데요,
orderId를 정수(int) 타입으로 보낼 수 있나요?
아니면 문자열 형식으로 변환해야 하나요? (예: "WaTix6ZlktlYX9AQfk4Eg")
저희는 현재 정수형 orderId를 사용하고 있어서, API에 전송하기 전에 다른 형식으로 변환해야 하는지 확인하고 싶습니다.
답변 부탁드립니다.
정수형이면 1,2,3,4 이렇게 올리시나요?
우선 1개 Mid에서는 무조건 Unique해야합니다.
추가로 전역으로도 unique하면 추후 관리에 유리한면도 있습니다. (로그 확인 등 요청할 때)
뒤에는 선택이어서, unique한 데이터로만 올리면 된다고 이해해주시면 됩니다.
안녕하세요! 결제 승인(confirm) 시 오류가 발생하여 도움 요청드립니다.
POST /v1/payments/confirm 호출 시 다음 오류가 발생합니다:
code: INVALID_UNREGISTERED_SUBMALL
message: "등록되지 않은 서브몰입니다."
저희 가맹점은 서브몰을 사용하지 않습니다.
가맹점 ID: hilolmngaf
API에서 왜 서브몰 모드로 인식되는지 확인해주시고,
서브몰 설정을 비활성화해 주실 수 있을까요?
등록되지 않은 서브몰입니다 오류는 카드사 심사가 되지 않았을대 발생하는 에러입니다.
그런데 hilolmngaf 에서 INVALID_UNREGISTERED_SUBMALL 이 오류가 발생된건 확인이 안되는데요.
주문번호를 알려주실수 있을까요?
네, 오류가 발생한 주문 정보는 아래와 같습니다:
orderId: cf65dbaab3b147129812abfb47b5492a
paymentKey: hilol20251128212128Cf2j3
amount: 200
요청 시간:
2025-11-28 21:22:52
응답 오류:
code: INVALID_UNREGISTERED_SUBMALL
message: "등록되지 않은 서브몰입니다."
결제 생성은 정상적으로 되지만,
/v1/payments/confirm 호출 시에만 오류가 발생합니다.
가맹점 ID: hilolmngaf
11월 28일이시군요.그 이후에 카드사 심사가 완료된것 같은데요.
지금 다시 결제 시도해 보실수 있을까요?