한주연B님의 아티클

콘텐츠, 코드, Preview가 완전히 연동되는 문서의 시작 🪄✨

완전히 달라진 토스페이먼츠 문서 제품을 체험해보세요! 🤗

https://docs.tosspayments.com/guides/payment-widget/integration

코드 제로, 설정 제로. 브라우저에서 바로 시작하는 결제 연동

📍샌드박스 체험하기: https://developers.tosspayments.com/sandbox

결제 연동을 고민하고 있는 개발자 혹은 기획자라면, 토스페이먼츠 샌드박스 한 번 사용해 보세요!

지난 주에 "테크니컬 라이터가 왜 개발자경험을 개선하는 제품을 만드나요?”라는 글을 올렸는데요. 그때 이야기 했던 제품이 배포되었답니다.

토스페이먼츠 DX 팀은 샌드박스를 통해 개발자의 첫 번째 경험을 개선하고 싶었어요. 그래서 브라우저에서 바로 테스트 연동을 할 수 있는 샌드박스를 만들었습니다.

샌드박스를 사용하면 토스페이먼츠 결제 흐름을 구현 없이 체험해 볼 수 있고, 결제 연동을 위해 필요한 파일 구조와 로직을 이해하기도 쉬워졌어요. 또 직접 코드를 수정해가며 테스트 결제를 해 볼 수 있고(실제로 결제가 되지 않아요), 성공과 실패 시나리오를 경험할 수 있답니다.

샌드박스가 아직 MVP 단계라 남은 과제도 많은데요. 먼저 React와 JavaScript, Node 외에도 다양한 언어를 순차적으로 지원할 예정입니다. 또 ‘내 코드 공유하기’ 기능도 개발 중인데요. 이 기능을 사용하면 샌드박스 URL을 공유해서 내가 작성한 코드를 그대로 동료와 공유할 수 있어요. 수정한 코드가 동작하지 않을 때 기술지원팀에 링크를 공유하면 디버깅도 더 쉬워질 거예요.

사용해보시고 많은 피드백 부탁드려요!

📍토스페이먼츠 개발자센터: https://developers.tosspayments.com

"테크니컬 라이터가 왜 개발자경험을 개선하는 제품을 만드나요?”

지금 저는 테크니컬 라이터로 일하고 있지만, 3년 전에는 개발자로 일하고 있었는데요. 의외로(?) 문서를 읽기 싫어하는 개발자였어요. 문서 경험이 좋지 않았기 때문에 테크니컬 라이터가 된 거기도 해요. 개발자가 제한된 시간에 빠르게 문서를 탐색하고 쉽게 개발할 수 있도록 돕고 싶었거든요.

그런데 문서를 만들다 보니 좋은 개발자경험은 문서만으로 충분하지 않다는 생각을 하게 됐어요. 연동을 막 시작하려는 개발자에게 문서부터 탐색하게 하는 게 좋을까? 혹은 개발 없이 바로 실행해 보는 경험이 더 좋을까? 저는 개발자들이 연동 흐름에 대해 직관적으로 이해할 수 있고, 아무런 설정 없이 바로 브라우저에서 실행할 수 있는 환경을 제공하는 게 좋은 개발자경험이라고 생각하게 됐습니다. 그 과정에서 문서도 읽을 수 있고요.

이런 고민 끝에 토스페이먼츠에서도 그런 경험을 만들어보기로 했어요. 다음 주 개발자경험을 개선할 샌드박스 제품 배포를 앞두고 있는데요. 배포를 앞두고 다른 분들이 생각하는 좋은 개발자경험은 무엇인지도 궁금해지네요. (있다면 댓글로 알려주세요!)