안녕하세요. MX사업부 Wallet 개발 그룹의 최종화 입니다.

우리의 일상에서 스마트폰은 떼려야 뗄 수 없는 필수품이 되었습니다. 사용자들은 점점 더 많은 것들을 스마트폰 안에서 무리 없이 처리하기를 원하고 더 높은 사용성을 가진 서비스로 끊임없이 이동합니다. 스마트폰이 똑똑해질수록 우리의 삶은 더욱 심플해지고 있습니다.

갤럭시 사용자들은 삼성페이로 결제할 수 있게 되면서, 결제 카드를 따로 가지고 다니지 않아도 되는 편리함에 완전히 익숙해져 있습니다. 한편으로는 지갑에 있는 다른 소지품들도 더 이상 가지고 다니지 않게 되는 날이 오겠다는 생각을 하기 시작했습니다. 이러한 기대에 맞게 진화한 삼성페이, 삼성월렛에는 다양한 기능이 추가 되었습니다.

삼성월렛은 모바일 결제 서비스인 삼성페이와 생체 인식 기반의 보안 솔루션인 삼성패스를 통합하고, 다양한 아이템을 추가하여 실물 지갑을 대체하는 새로운 디지털 라이프 경험을 제공하고 있습니다. 출시 초기인 2022년 6월에 최초 7개국에 먼저 선보였고, 2023년 1월을 기준으로 기존 삼성페이 출시국 29개국에 삼성월렛으로 출시하여 기능을 확장해 나가고 있습니다.

이번 포스팅에서는 일상생활에 필요한 모든 것들을 안전하고 편리하게 담을 수 있는 삼성월렛 서비스를 소개하고, 다양한 콘텐츠를 디지털화하여 월렛카드로 제공하는 방법인 '삼성월렛에 추가하기(Add to Samsung Wallet)' 서비스를 연동하는 방법을 이야기하려고 합니다.

위에서 소개했듯이 계속해서 발전하고 있는 삼성월렛의 다양한 기능 중 ‘Add to Samsung Wallet’ 또는 ‘삼성월렛에 추가하기’ 서비스에 대해 본격적으로 알아보는 시간을 가지겠습니다.

삼성월렛에 등록할 수 있는 디지털화된 콘텐츠는 카드의 형태로 등록되는데요. 이 카드를 월렛카드라고 부릅니다.

사용자 입장에서 월렛카드를 등록하는 방법은 매우 간단합니다. ‘Samsung Wallet에 추가하기’ 버튼만 누르면, 언제든 꺼내서 쓸 수 있는 카드가 사용자 스마트폰에 등록됩니다.

Add to Samsung Wallet 서비스는 다양한 콘텐츠를 월렛카드로 제공할 수 있도록 오픈 플랫폼을 지향하며, 콘텐츠 서비스 파트너가 쉽게 연동할 수 있도록 지원 국가와 기능을 확대하고 있습니다.

월렛카드가 제공하는 유용한 사용자 경험에 대해서는 아래 링크의 커머셜 영상을 통해서 더 알아볼 수 있습니다.

- Forgetting Can Be Awesome | Samsung Wallet: https://youtu.be/YQcBGo9omvc?si=o7BC29sSBOODZlhx

삼성월렛을 연동해서 갤럭시 사용자들에게 콘텐츠를 제공하려면, 삼성월렛 파트너 포털에 파트너로서 등록이 필요합니다.

- 삼성월렛 파트너 포털: https://partner.walletsvc.samsung.com/

서비스를 연동하는 방법은 삼성 개발자 포털을 통해서 자세히 확인할 수 있습니다.

- 삼성 개발자 포털: https://developer.samsung.com/wallet/connect.html

삼성월렛 파트너 포털로 가입하려면, 서비스 관리자로 사용할 삼성 어카운트 계정을 사용해야 하는데요. 가입 과정에는 서비스 데이터를 안전하게 전달하기 위한 인증서 교환 과정이 포함되어 있습니다. 아래 다이어그램과 개발자 가이드를 함께 참조하면, 그리 어렵지 않게 인증서 등록과 파트너 가입을 완료할 수 있습니다.

- 보안키와 인증서 생성 가이드: https://developer.samsung.com/wallet/api/references.html#Security-Factors

파트너로 가입을 완료하면, Wallet Card 메뉴에서 서비스할 카드를 생성할 수 있습니다. 각 카드는 서비스를 대표하는 Card ID가 할당되며, 카드의 종류와 연동 정보 등을 설정할 수 있습니다. 각 카드는 상태에 따라 테스트용과 운영용으로 자체 관리를 할 수 있습니다.

- 월렛카드 관리: https://developer.samsung.com/wallet/manage.html

이제 삼성월렛에 추가할 사전 준비가 되었으니, ‘삼성월렛에 추가하기’ 기능에 대해서 알아볼 차례입니다. 이 기능은 주로 링크가 연결된 버튼으로 구성하며, 콘텐츠 제공자의 애플리케이션, 웹페이지 또는 이메일이나 MMS 메시지로 제공할 수 있습니다.

사용자의 카드 데이터는 앞서 파트너 포털에서 생성한 월렛카드 종류에 맞게 구성해야 합니다. 월렛카드를 서비스하는 과정에서 필요한 데이터는 아래의 페이지에서 확인할 수 있습니다.

- 월렛카드 상세 스펙: https://developer.samsung.com/wallet/api/wallet-cards.html

사용자의 지갑에 등록될 소중한 데이터는 위변조와 유출 사고 방지를 위해 안전한 토큰화 처리가 필요합니다. 암호화와 서명을 포함한 JWT(JSON Web Token) 형식은 유효한 시간 기준을 가지고 검증되기 때문에 더욱 안전합니다. 특히, 이 토큰을 생성할 때는, 앞서 인증서 교환을 통해 생성하고 획득한 키와 인증서를 사용하게 됩니다.

- 카드 데이터 토큰: https://developer.samsung.com/wallet/api/security.html#Card-Data-Token

사용자에게 콘텐츠 서비스를 제공하는 방식에 따라 삼성월렛 서비스로 데이터를 전달하는 방식을 선택할 수 있습니다.

데이터 보내기 방식은 버튼에 연결된 링크에 토큰화한 데이터를 포함해서 구성하는 일반적인 방식으로, 사용자가 버튼을 누르는 시점에 카드 데이터가 삼성월렛 서비스로 전달됩니다.

삼성월렛 지원 여부만 체크된다면, 사용자의 카드 데이터를 포함한 링크를 생성하여, Add to Samsung Wallet 버튼을 눌렀을 때 링크가 실행되도록 애플리케이션이나 웹페이지에 구성하면 됩니다. 특히, 웹페이지에서 버튼을 구성할 때는 JavaScript 라이브러리를 제공하고 있습니다.

- 버튼 구성: https://developer.samsung.com/wallet/api/implement-the-button.html

애플리케이션에 버튼을 구성하는 경우에는, 아래 링크에서 제공하는 버튼 이미지 리소스를 활용하여 링크를 구성하면 됩니다.

- 버튼 리소스: https://developer.samsung.com/wallet/api/image-resources.html

데이터 불러오기 방식은 사용자의 콘텐츠를 대표하는 값인 refId만을 Add to Samsung Wallet 링크에 포함하여, 삼성월렛 서비스로 전달하는 방식입니다.

삼성서버는 월렛카드에 설정된 Get Card Data API의 정보를 참조하여, 잘 전달된 refId로 사용자 콘텐츠를 조회하여 등록을 완료합니다.

이 방식은 애플리케이션이나 웹페이지 외에도 정적인 링크를 제공할 수밖에 없는 이메일이나 MMS 메시지를 통해 사용자에게 제공할 때 적합합니다. 이 정적인 링크를 안전하게 만드는 옵션도 설정할 수 있습니다.

이렇게 살펴본 두 가지 방식과 Add to Samsung Wallet 링크에 대한 자세한 정보는 아래 가이드 페이지를 통해서 확인 할 수 있습니다.

- Add to Samsung Wallet 인터페이스: https://developer.samsung.com/wallet/api/add-to-wallet-interface.html