[프론트 플러그인] PG(결제대행) API 직접 연동 지원 여부 문의

[coffeeya]

어떤 제품을 사용하나요?

• 제품: 프론트 플러그인
• SDK 또는 API 버전: 프론트 플러그인 SDK CDN v0 (개발자센터 배포 템플릿 기준)
• 환경: 개발

무엇이 궁금한가요?

무인 출력(키오스크형) 서비스를 프론트 플러그인으로 연동 중입니다. 복합기 앞 토스 프론트에서는 자사 서버에서 주문·금액을 받은 뒤 sdk.payment.requestPayment / requestPaymentCancel로 VAN 승인·취소하고, 결과는 자사 서버에 저장하는 구조입니다. 모바일 앱 쪽은 별도로 PG(결제대행) 결제·환불을 검토하고 있습니다.

아래 문서를 확인했을 때, 프론트 연동 경로에는 PG 연동 가이드가 없고 결제 흐름은 「플러그인 → 프론트 SDK → 결제앱 → VAN/카드사」로만 설명되어 있습니다.

https://docs.tossplace.com/guide/front-integration/plugin/test/payment.html
https://docs.tossplace.com/reference/plugin-sdk/front/payment.html
질문드립니다.

프론트 플러그인(WebView)에서 PG사 API·PG SDK를 직접 연동해 승인·취소하는 방식이 공식 지원 범위에 포함되나요?
지원되지 않는다면, 단말에서의 카드·QR 간편결제 승인은 sdk.payment.*를 통한 VAN 경로만 사용하는 것이 맞는지 확인 부탁드립니다.

모바일(PG) 결제와 프론트(VAN) 결제를 같은 주문·환불 정책으로 운영할 때, 토스플레이스에서 권장하는 연동 패턴(채널 분리, 취소 처리 주체 등)이 문서나 가이드로 정리되어 있는지 알려 주실 수 있을까요?

Open API의 Payment / pgDetails 필드(https://docs.tossplace.com/reference/open-api/payment.html)는 프론트 플러그인-only 구성(토스 POS 미사용)에서 어떤 경우에 활용하는지, PG 결제 내역을 Open API로 동기화하는 공식 경로가 있는지도 함께 여쭙니다. (Payment.Create 등은 실제 승인이 아닌 기록 API로 이해하고 있습니다.)

현재 이해는 「프론트 단말 = VAN 오프라인 승인, PG 직접 연동은 프론트 플러그인 문서상 미기재」입니다. 위 이해가 맞는지, 또는 예외·대안이 있는지 답변 부탁드립니다.

[토스플레이스-개발자센터]

안녕하세요. 토스플레이스 개발자센터입니다.

1. 프론트 결제와 모바일 PG 결제
문의하신 구성에서 프론트 단말의 카드·QR 결제는 프론트 SDK를 통한 VAN 승인·취소 경로를 사용합니다. 프론트 플러그인 안에서 외부 PG사의 API·SDK를 호출해 단말 결제를 대체하는 방식은 공개 SDK의 지원 범위에 포함되지 않습니다. 프론트 결제 흐름

2. 주문과 환불 관리
두 채널을 하나로 묶는 별도 표준 연동 가이드는 확인되지 않습니다. 자사 서버에서 같은 주문에 결제 채널과 원거래 식별자를 함께 저장해 두시면, 환불 시 프론트에서 승인한 건은 프론트 결제 취소 API로, 모바일에서 승인한 건은 해당 PG사의 취소 API로 구분해 처리할 수 있습니다.

3. Open API에 PG 결제 내역 기록
말씀하신 대로 Payment.Create는 실제 결제 승인이 아니라 이미 승인된 결제를 주문에 기록하는 용도입니다. pgDetails는 PG사와 거래 ID를 담는 항목으로, 입력한다고 PG 거래가 자동 동기화되지는 않습니다. 앱에 필요한 권한이 있고 Open API로 생성한 주문이라면 승인·취소 결과를 별도로 기록할 수 있습니다. 토스 POS 없이 프론트만 사용하는 매장도 VAN 대리점을 통해 Open API 앱을 별도로 연결할 수 있습니다. 결제 기록 API · 프론트 단독 매장의 앱 설치

PG사와 거래 ID가 조회 결과에 어떻게 표시되는지는 기존 포럼 답변에서도 확인하실 수 있습니다.

[coffeeya]

@토스플레이스-개발자센터
혹시 외부 PG사 말고 토스 페이먼츠 PG 로 연동해서 사용하는 기능은 있을까요?

[토스플레이스-개발자센터]

안녕하세요. 토스플레이스 개발자센터입니다.

프론트 플러그인은 VAN을 통한 오프라인 결제 승인·취소만 지원합니다. 토스페이먼츠 PG로 단말 결제를 직접 승인·취소하는 방식은 지원하지 않습니다.

복합기 앞 프론트 단말의 카드·QR 결제는 앞서 안내 드린 대로 현재 구현하신 프론트 결제 API를 사용해 주세요.