결제 연동 변경 기록: Fiserv 코드 정리와 네이버페이 도메인 전환

결제 서비스를 운영하면서 새 기능을 추가하는 일 외에도 기존 연동을 고칠 일이 있었습니다. 사용하던 API가 폐기되거나 개발 환경의 주소가 바뀌면, 해당 기능을 사용하는 코드와 설정을 찾아 반영해야 했습니다.

여기서는 2024년의 Fiserv 코드 정리와 공통 빌드 인증 변경, 2025년 1월의 네이버페이 도메인 변경을 함께 정리했습니다. API 제공자의 변경과 사내 공통 환경의 변경은 원인이 달랐지만, 영향을 받는 서비스의 범위를 확인해야 한다는 점은 비슷했습니다.

변경 시점과 대상

Fiserv 정산 경로와 AAA 코드 제거

Fiserv의 settlement 엔드포인트가 폐기되면서 그 경로에 연결된 AAA 코드를 정리했습니다. 이때 AAA는 당시 사용하던 사내 서비스 인증 체계를 가리킵니다. 일반적인 약어 풀이를 붙이는 것보다 어떤 호출 경로를 위해 남아 있던 코드인지 보는 것이 맞습니다.

내부 호출 인증도 이후 OAuth 방식으로 전환됐습니다. 예전 인증 경로를 계속 유지할 필요가 있는지, 폐기된 API와 함께 제거할 부분이 어디인지 확인하는 작업이었습니다.

연동 코드 하나를 없앨 때도 호출 지점과 설정, 관련 테스트를 함께 확인해야 합니다. 사용 중인 다른 경로와 인증 처리를 공유하고 있다면, 폐기된 API의 코드를 지우는 과정에서 필요한 부분까지 바뀔 수 있기 때문입니다.

여러 저장소의 빌드 인증 변경

그보다 앞선 3월에는 기존 Maven 사용자 인증 폐기에 대응해 여섯 저장소의 빌드 설정을 같은 날 변경했습니다. 결제 API의 동작을 바꾸는 작업은 아니었지만, 반영하지 않은 저장소에서는 이후 빌드가 막힐 수 있었습니다.

같은 변경을 반복할 때는 수정한 파일 수보다 적용해야 할 저장소 목록이 기준이 됩니다. 빌드 설정을 바꾼 곳과 실제 빌드가 확인된 곳을 구분해야 누락을 찾기 쉽습니다.

네이버페이 개발 API 도메인 변경

2025년 1월에는 네이버페이 개발 환경의 API 도메인 변경에 대응했습니다. 같은 변경 이력에는 자동 해지 관련 수정도 함께 남아 있습니다.

주소를 바꾸는 작업에서도 실행 환경별 설정을 구분해야 합니다. 개발용 URL이 어느 환경에서 사용되는지, 설정을 바꿔 배포한 서비스가 실제로 새 주소를 사용하는지 확인할 필요가 있습니다. 코드에 적힌 URL 외에도 배포 설정에서 값을 덮어쓰는 곳이 있을 수 있습니다.

연결 성공과 기능 동작도 따로 봐야 합니다. 새 주소로 응답을 받는지 확인한 뒤에는 해당 API를 사용하는 등록·해지 등의 흐름을 확인해야 합니다. 자동 해지 관련 수정 역시 주소 변경의 확인 항목과 구분해서 볼 부분입니다.

변경 범위에 맞춘 확인

세 작업의 확인 대상은 달랐습니다. Fiserv는 폐기된 호출 경로와 제거 범위, Maven 인증은 각 저장소의 빌드, 네이버페이는 실행 환경의 주소와 연동 동작이었습니다.

공통 설정으로 바꿀 수 있는 부분이 있더라도 마지막 확인은 사용하는 서비스에서 해야 합니다. API 코드의 변경 완료와 실제 배포 상태, 빌드 설정의 변경과 빌드 성공을 각각 확인하는 것이 필요했습니다.