미니앱 소유계정과 토스페이 계약 계정이 다를경우- 개발에서 정산부분이 막힙니다. 도와주세요

이 글의 성격은 무엇인가요?

질문 / 문제 해결

내용을 설명해주세요

[문의] 앱인토스 partner 미니앱 토스페이 checkoutPayment 네이티브 오류 (계정/가맹점 연결 관련)

안녕하세요. 비게임 partner(WebView) 미니앱에서 토스페이 결제 연동 중 checkoutPayment 호출 시 네이티브 오류가 발생해 문의드립니다.

■ 미니앱 / 계정 구조

  • 미니앱 appName: cleanbutler (깔끔집사)
  • 미니앱 소유(콘솔) 계정/워크스페이스: caretips@extreet.co.kr — 앱 출시도 이 계정
  • 토스페이 가맹점·계약·가맹점 키 발급 계정: super222hj@gmail.com (위 워크스페이스에 멤버로 추가하여 토스페이 심사·계약 진행, 회사 가맹점 등록)
  • 발급받은 가맹점 키를 caretips@ 계정의 미니앱 콘솔에 API 키로 등록한 상태
  • (미니앱을 super222hj@ 계정으로 이관하려 했으나 이관이 되지 않아 멤버 추가로 우회한 상황입니다)

■ 정상 동작하는 부분

  • mTLS 인증서 설정 완료, 서버-서버 호출 정상
  • 토스 로그인(appLogin) → login-me로 userKey 정상 수신
  • make-payment 서버 호출 성공 → payToken 정상 발급 (예: 정상 응답 { payToken, orderNo, amount })

■ 문제 (실패 지점)

  • 발급받은 payToken으로 클라이언트에서 checkoutPayment({ payToken }) 호출 시 결제창이 뜨지 않고 아래 네이티브 오류 발생:

Exception in HostFunction: Parameter specified as non-null is null:
method com.brickmodule.codegen.BrickModule.MiniAppModule_postMessage, parameter

■ 환경

  • @apps-in-toss/web-framework 2.9.1 (최신)
  • 테스트앱(샌드박스) + 로컬 개발서버 연결, isTestPayment: true
  • Android 실기기

■ 문의 사항

  1. 미니앱 소유 계정(caretips@)과 토스페이 가맹점 계정(super222hj@)이 서로 다른 상황에서, 콘솔에 가맹점 키만 등록하면 checkoutPayment(네이티브 결제창)가 정상 동작하나요?
  2. 정상 동작을 위해 미니앱과 토스페이 가맹점의 플랫폼 연결(같은 계약/워크스페이스 일치 등) 추가 설정이 필요한가요? 필요하다면 절차를 알려주세요.
  3. make-payment(payToken 발급)는 되는데 checkoutPayment 네이티브 호출만 위 오류로 실패하는 원인이 위 계정 구조 때문인지, 아니면 다른 설정 누락인지 확인 부탁드립니다.

감사합니다.

@nancoco0705 님 안녕하세요
계정과는 무관합니다.
콘솔에 토스페이서 발급된 api key를 등록하면 정상 동작합니다.
샌드박스 테스트는 앱인토스 내 설정된 테스트 키로 셋팅되며,
테스트 키는 결제 생성까지만 가능하고 이후 승인 처리는 불가합니다.

혹시 QR코드 환경에서 해보시겠어요?

QR코드 환경에서 계속 해보았는데 [결제 처리 중 오류가 발생했어요. Exception in HostFunction: Parameter specified as non-null is null: method com.brickmodule.codegen.BrickModule.MiniAppModule_postMessage, parameter]---->이런메세지가 뜹니다. 그래서 토스페이 미니앱으로 청약 심사 승인받았고 가맹점 키도 받았는데 홈페이지주소가 https://minion.toss.im/Hwcx3pd5----> 심사받았을때 했던 홈페이지, 실제 미니홈페이지 출시 전이라 주소가 상이한것 같아 그것도 영향이 있는건지 궁금합니다.