거래처가 정산계좌를 바꿔달라고 했다: 예금주 조회 뒤에도 남겨야 할 승인 단계

에이픽 서비스를 소개하는 홍보 글입니다. 아래는 가상 업무 시나리오이며 실제 고객 후기나 실측 결과가 아닙니다. API 설명은2026년11월5일12:19 UTC에 재확인한 공식 문서를 기준으로 작성했고, 삽입된4장은2026년10월28일의 공개 보관 화면으로 현재 성공 결과와 구분합니다.

이번에 해결하려는 문제

공급업체에서 다음 달부터 정산계좌를 바꿔달라는 요청이 왔다고 가정합니다. 담당자가 메시지에 적힌 계좌를 곧바로 시스템에 덮어쓰면 나중에 누가 무엇을 확인했는지 알기 어렵습니다.

이번 사례는 개인 환불신청 처리와 다릅니다. 기존 거래처의 계좌 변경 요청을 접수하고, 예금주 조회 결과와 내부 승인 기록을 연결하는 시나리오입니다. 계좌실명을 조회했다고 요청자의 권한이나 거래의 안전이 자동으로 입증되는 것은 아닙니다.

화면1. 2026년10월28일 공식 공개 보관 캡처. 빈 회원가입 양식, 실제 가입·키 발급을 진행한 화면이 아닙니다.

호출 전에 정할 기준

변경 전 계좌를 즉시 지우지 말고 변경 신청을 별도 업무건으로 만듭니다. 거래처의 승인된 연락 경로와 담당자 권한을 확인한 뒤 필요한 조회를 수행합니다. API는 조회한 계좌의 실명을 알려주는 기능이며 누가 변경을 요청할 권한이 있는지까지 결정하지 않습니다.

bank_code와 account_num을 서버에서 전달합니다. 실제 계좌번호와 키는 환경변수로 관리하고 글·공개 로그에는 표시하지 않습니다. 공개 응답에서는 계좌번호와 계좌실명을 가립니다.

화면2. 2026년10월28일 공식 공개 보관 캡처. 서버 인증키 보관 안내, 실제 비밀키를 보여주는 화면이 아닙니다.

화면3. 2026년10월28일 공식 공개 보관 캡처. 계좌 예금주 실명 조회 API의 2026년 10월 28일 공식 문서 보관 화면입니다. 실제 계좌나 송금 성공 결과가 아닙니다.

공식 요청을 연결하는 예시

다음 코드는 공식 문서의 경로와 필드에 기반한 정적 예시입니다. 실제 호출하지 않았습니다. 서버 환경변수의 실제 값은 글이나 로그에 공개하지 마세요.

curl --request POST 'https://apick.app/rest/account_realname' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string "bank_code=${APICK_BANK_CODE}" \
  --form-string "account_num=${APICK_ACCOUNT_NUM}"

아래는 공식 응답 형식 또는 부분 구조를 설명한 정적 예시입니다. 식별정보는 가렸으며 실제 처리 로그가 아닙니다.

{
  "data": {
    "은행코드": "004",
    "은행명": "국민",
    "계좌번호": "[마스킹]",
    "계좌실명": "[마스킹]",
    "success": 1
  },
  "api": {"success": true, "cost": 60}
}

이름이 같다고 자동승인하지 않는다

거래처 명칭과 예금주가 일치하면 검토에 도움이 될 수 있지만, 그 사실만으로 변경 요청이 정당하다고 확정하지 않습니다. 반대로 표기가 다르다고 사기라고 단정하지도 않습니다. 거래처 유형, 승인된 증빙과 담당자의 확인 절차를 함께 봅니다.

우리 시스템의 작업상태는 ‘변경 접수 / 조회 확인 / 담당자 승인 / 반영 완료’처럼 설계할 수 있습니다. 이 네 상태는 APICK의 기본 상태코드가 아니라 내부 프로세스 예시입니다. 예금주 조회 후 실제 송금이나 계좌 변경 적용은 별개 단계입니다.

화면4. 2026년10월28일 공식 공개 보관 캡처. 공통 시작하기 info cURL 정적 예시이며 본문 해당상품의 실제 실행 결과가 아닙니다.

확인 기록에는 필요한 것만 남긴다

공식 예시에는60P가 표시됩니다. 같은 건을 담당자마다 반복조회하지 않도록 조회시각과 검토 여부를 공유하되, 전체 계좌번호와 실명 원문을 모든 사람에게 노출하지 않습니다. 데이터 접근과 보관기간은 조직 정책에 맞게 정합니다.

이번 글에서는 실제 계좌 조회·송금·계좌 변경을 수행하지 않았습니다. 자동화 효과는 승인 누락, 중복조회, 담당자 재확인 건수로 평가하고 비용 절감이나 금융사고 예방을 보장하지 않습니다.

실제 운영 전에는 해당 상품의 현재 이용조건·과금·처리시간·개인정보 처리 권한을 확인하세요. 모든 업무를 몇 분 안에 끝낸다는 보장은 하지 않습니다.

공식 서비스: https://apick.app

공식 명세: https://apick.app/dev_guide/account_realname