[앱스킴] 앱 결제 후 표준 브라우저로 튀는 문제, 앱스킴을 활용한 처리

최근에 가맹점 앱에 결제수단을 연동하는 작업을 진행했는데, 결제 자체는 잘 되지만 결제 완료 후 예상치 못한 문제가 하나 생겼습니다.

결제 완료 버튼을 누르면 원래 실행 중이던 가맹점 앱이 아닌, 표준 브라우저가 뜨는 현상이였습니다.

 

사용자 입장에서는 결제가 끝났는데 갑자기 다른 앱이 열리니 당황하기 쉽고, UX 측면에서도 꽤 치명적이었다. 그래서 자연스럽게 원래 앱으로 돌아갈 수 있도록 흐름을 바로잡는 작업을 진행하게 되었습니다.

 

간혹 앱 결제 시 주문 화면으로 돌아가 결제를 완료해달라는 페이지가 뜨는 걸 목격한 적이있습니다. 이때 "버튼을 눌러 돌아가기"를 클릭하면 가맹점앱으로 돌아가게 되는데 해당 처리를 앱스킴을 이용해 돌아가는 것으로 알 수 있었습니다.

 

🔍 문제는 어디서 발생했을까?

결제사의 결제 페이지로 넘어갔다가 결제가 완료되면, 결제사는 미리 등록한 return URL로 리다이렉트 처리합니다.

여기서 핵심은 이 return URL을 어떻게 처리하느냐에 달려 있습니다.

• 만약 return URL이 일반 웹 주소라면 → OS는 당연히 브라우저로 이동
• 앱으로 돌아가려면 → 앱스킴(또는 앱링크, 유니버설 링크) 형태여야 함

이번 이슈는 바로 여기에서 발생했다. 결제 완료 시 앱으로 돌아가는 스킴이 정의되어 있지 않아, OS는 그냥 웹 주소를 받아 들고 표준 브라우저를 열어버린 것입니다. 그래서 가맹점 앱으로 돌아가기 위해서 표준브라우저에서 다시 앱스킴처리를 해야됩니다.

 

네이버 URL Scheme 예제로 앱스킴 이해하기

앱스킴 이야기를 너무 추상적으로만 하면 와닿지 않아서, 네이버에서 공개한 URL Scheme 예제를 가져왔습니다. 

 

네이버 앱을 실행시키는 기본 형식은 이런 구조입니다.

naversearchapp://{명령어}?{파라미터}={옵션}&version={버전}

https://developers.naver.com/docs/utils/mobileapp/#1-url-scheme-%EA%B5%AC%EC%84%B1

 

예를들면, 네이버 앱의 음성 인식 검색 기능을 열고 싶다면 ?

naversearchapp://search?qmenu=voicerecg&version=1

 

 

여기서 볼 수 있는 포인트는:

 

• naversearchapp → scheme (어느 앱으로 보낼지)
• search → 명령어/기능
• 뒤쪽 qmenu=voicerecg&version=1 → 파라미터

즉, “어떤 앱의, 어떤 기능을, 어떤 옵션으로 열지”를 URL 한 줄로 표현한 것입니다.

 

해당 설정을 했다면 IOS, AOS에서도 앱 스킴을 받을 수 있도록 물론 설정을 해줘야합니다.

 

 

 

네이버 앱 URL Scheme 연동 가이드