연동은 한 번 성공한 다음부터가 범위다

호출이 한 번 성공한 화면

연동 문의는 대개 붙일 서비스 이름으로 들어온다. 결제, 지도, 문자, 로그인. 이름만 보면 작업량이 비슷해 보이는데 돌아온 견적은 서로 다르다.

개발자 입장에서 첫 성공은 빠르다. 문서에 있는 예제를 그대로 넣고, 테스트 키를 발급받고, 응답이 돌아오는 걸 확인하는 데까지는 오래 걸리지 않는다. 화면에서 결제창이 뜨고 승인 메시지가 보이면 붙었다고 말할 수 있다.

그런데 그 화면은 잘 풀린 경우 하나다. 서비스를 열고 나면 잘 풀리지 않은 경우들이 매일 들어온다. 연동 범위를 잡는다는 건 그 경우들을 세는 일이고, 견적이 갈리는 자리도 대부분 거기다.

계정과 심사가 일정을 먼저 잡는다

외부 서비스 중에는 개발자가 혼자 열 수 없는 것이 많다. 사업자 명의로 신청하고, 서류를 내고, 심사를 기다린 뒤에야 실서비스용 키가 나온다. 결제, 본인확인, 알림 발송처럼 돈이나 개인정보가 오가는 쪽은 대체로 이 절차가 붙는다.

이 기간은 개발 일정 안에 있지 않다. 코드를 아무리 빨리 짜도 승인이 나기 전에는 실계정으로 확인할 수 없고, 승인 조건에 서비스 화면이나 약관 문구가 들어가는 경우도 있다. 심사에서 한 번 반려되면 고쳐서 다시 넣는 만큼 또 밀린다.

그래서 연동 견적을 받을 때 신청 주체가 누구인지부터 정하는 편이 낫다. 계정 신청과 심사 대응까지 맡길 것인지, 대표님이 직접 하고 개발만 맡길 것인지에 따라 일정표가 달라진다.

테스트 환경에서 되고 실서비스에서 안 되는 것들

대부분의 외부 서비스는 테스트용 환경을 따로 준다. 여기서는 카드번호를 아무거나 넣어도 승인이 나고, 문자도 실제로는 발송되지 않는다. 개발과 확인은 여기서 끝난다.

실서비스로 넘어가면 조건이 붙는다. 호출을 허용할 도메인이나 서버 주소를 미리 등록해야 하는 경우, 결과를 받을 주소가 외부에서 접근 가능한 정식 주소여야 하는 경우, 정산 계좌나 발신 번호처럼 미리 등록해 둔 정보와 일치해야만 통과하는 경우가 있다.

이 항목들은 개발 문제가 아니라 준비물 문제다. 그런데 준비물이 빠져 있으면 개발이 다 끝나고도 공개를 못 한다. 실서비스 전환에 필요한 목록을 착수 시점에 받아 두는 것이 이 구간을 줄이는 방법이다.

실패하고 중복되고 취소되는 흐름

성공 경로는 하나다. 실패 경로는 여러 개이고, 연동 작업량은 대체로 이쪽에 몰려 있다.

응답을 기다리다 시간이 지나 끊긴 경우가 대표적이다. 우리 쪽에는 실패로 남았는데 상대 쪽에서는 처리가 끝나 있을 수 있다. 사용자가 안 됐다고 생각하고 다시 누르면 같은 요청이 두 번 들어간다. 같은 요청을 두 번 받아도 한 번만 처리되게 만드는 장치, 그리고 양쪽 기록을 맞춰 보는 화면이 여기서 필요해진다.

취소와 환불도 별도의 흐름이다. 전체 취소와 부분 취소가 다르고, 상대 쪽에서 이미 정산이 넘어간 뒤에는 절차가 또 달라진다. 결과를 알려주는 알림이 중복해서 오는 경우도 흔해서, 같은 알림을 여러 번 받아도 결과가 어긋나지 않게 처리해야 한다.

이 흐름들을 어디까지 만들 것인지가 연동 범위의 실제 내용이다. 문의하실 때 붙일 서비스 이름과 함께 “취소는 어떻게 처리하나요”에 대한 답이 있으면 견적이 훨씬 정확해진다.

상대가 규격을 바꾸는 날

연동은 우리 코드가 그대로여도 깨질 수 있다. 상대 쪽에서 옛 버전 지원을 끝내거나, 응답에 있던 값이 사라지거나, 인증 방식이 바뀌는 일이 실제로 일어난다. 공지가 미리 오지만 그 공지를 받는 사람은 계정을 만든 사람이다.

그래서 연동은 한 번 만들고 끝나는 항목이 아니라 계속 지켜봐야 하는 항목에 가깝다. 최소한 상대 서비스의 공지 메일이 확인되는 주소로 오게 해 두고, 붙어 있는 외부 서비스 목록과 각각의 계정 명의를 한 장으로 정리해 두면 나중에 훨씬 수월하다.

붙일 서비스 이름만 알려주셔도 됩니다

위플은 연동 문의를 받으면 무엇을 붙일지보다 어떤 경우까지 처리할지를 먼저 정리합니다. 계정과 심사를 누가 맡을지, 실서비스 전환에 필요한 준비물이 무엇인지, 취소와 중복을 어디까지 다룰지를 나눠 적고 나면 범위가 눈에 보입니다. 금액이 어떤 단위로 매겨지는지는 가격 안내에 적어 두었습니다. 확인해 보고 지금 붙이지 않는 편이 낫다는 결론이 나오면 대체할 방법까지 같이 찾아 드립니다.