APICK 1원 인증 API 도입 전 계좌 등록 흐름 설계하기
이 글은 2026년 10월 28일 확인한 APICK 공개 화면과 공식 개발가이드를 바탕으로 한 실무 설계 예시입니다. 실제 회원가입 제출, API 키 발급, 인증서 등록, 유료 API 호출은 수행하지 않았으며, 예시를 실제 연동 성공 사례로 제시하지 않습니다.
정산 계좌 등록에 확인 단계를 넣고 싶다면
프리랜서가 작업을 마치고 정산 계좌를 등록하는 서비스를 가정해 보겠습니다. 계좌 정보를 입력한 사람이 해당 계좌의 입금 내역을 확인할 수 있는지 알아보려면, 단순히 계좌번호와 이름을 대조하는 것보다 추가 절차가 필요할 수 있습니다. 1원 인증은 소액 입금 내역의 확인 문구를 이용하는 방식이지만, 연동팀은 송금 요청과 인증 완료를 별개의 단계로 설계해야 합니다.
APICK 공개 가이드는 POST /rest/transfer_1won 경로를 안내하면서 상품문의를 통해 도입 방법을 안내받으라고 명시합니다. 이 요청은 실제 1원 송금과 관련되므로 문서의 예제를 호기심으로 실행하는 방식은 적절하지 않습니다. 먼저 이용 가능 여부, 필요한 계약이나 설정, 시험 방법을 문의해야 합니다. APICK 1원 인증 공식 가이드
가입과 키 준비 전에 문의 내용을 정리합니다
APICK 공개 가입 화면에서는 Google 또는 다른 이메일 방식으로 가입할 수 있습니다. 이메일 입력 화면에는 비밀번호·확인·이름 또는 회사명·전화번호·동의 항목과 reCAPTCHA가 있습니다.
가입 후에는 시작하기의 인증키 확인 링크를 따르고, 키를 서버 환경변수 APICK_API_KEY에 보관합니다. Bearer 인증은 서버에서만 처리하세요. 공통 가이드에는 1원 인증도 최초 결제 이력이 필요한 API로 안내되어 있습니다.
상품문의에는 정산 계좌를 등록하는 사용자가 누구인지, 확인을 언제 수행할지, 예상 요청 규모와 담당자 연락 창구를 정리해 보내는 편이 좋습니다. 계좌번호나 실제 주민등록번호를 문의 게시판에 올릴 필요는 없습니다. 개별 이용 가능 여부를 확인하기 전에는 회원가입과 키 준비만으로 즉시 서비스가 활성화된다고 가정하지 마세요.
공개 문서만으로 확정할 수 없는 부분을 남겨 둡니다
공식 문서는 요청에 사용하는 form-data 항목과 경로를 보여주지만, 확인 당시 이 경로의 정적 응답 예제는 공개하지 않았습니다. 따라서 인증 요청 식별값, 사용자가 입력한 문구를 검증하는 절차, 유효시간, 최종 완료 응답의 모양을 이 글에서 임의로 만들지 않습니다. 1원 인증 요청과 응답 안내
연동 전에 다음 질문의 답을 받아 두세요. 인증 문구를 생성하고 검증하는 주체는 누구인가요? 요청 결과를 다시 확인할 수 있나요? 시간 초과 뒤 송금 여부는 어떻게 확인하나요? 재발송과 중복 요청은 어떤 기준으로 처리하나요? 이용 가능한 금융기관과 운영 시간, 비용 발생 시점은 어떻게 확인하나요? 답을 받기 전에는 해당 기능이 있다고 단정하지 않습니다.
송금 요청과 최종 확인을 따로 기록하기
아래는 미실행 서비스 설계 예시이며 APICK의 공식 상태 코드가 아닙니다. 실제 호출 명령과 계좌 정보는 넣지 않았습니다.
우리 서비스의 계좌 등록 상태 예시
등록 초안
→ 사용자에게 절차 안내 및 진행 의사 확인
→ 승인된 조건에서 인증 요청
→ 요청 결과 확인 중
→ 안내받은 방식으로 사용자 확인 절차 진행
→ 확인 완료 또는 재검토 필요
응답이 끊긴 요청: 확인 중 상태로 보류
자동 재송금: 도입 조건과 결과 조회 방법 확인 전에는 하지 않음
사용자가 인증 버튼을 여러 번 누르거나 브라우저를 새로 열어도 같은 계좌 등록 건의 진행 상태를 서버가 기억하도록 설계하는 것이 좋습니다. 프런트엔드 버튼을 비활성화하는 것만으로는 여러 기기의 중복 요청까지 막을 수 없습니다. 내부 요청 번호와 진행 상태를 연결하고, 이미 진행 중이면 새로운 송금 요청을 만들지 않는 동작을 검토하세요.
특히 시간 초과는 송금되지 않았다는 뜻으로 단정할 수 없습니다. 결과가 불명확할 때 새 요청을 자동으로 보내면 중복 송금이나 불필요한 비용이 생길 수 있으므로, APICK과 합의한 조회·문의 절차로 결과를 확인한 다음 다음 동작을 결정해야 합니다. 멱등성 기능이 제공되는지 확인하지 않은 상태에서 특정 헤더나 재시도 규칙을 예제로 제시해서도 안 됩니다.
인증이 끝난 뒤에도 정산 계좌를 묶어 관리합니다
확인 절차를 마친 계좌가 바뀌면 이전 확인 상태를 새 계좌에 넘겨주지 않습니다. 사용자, 계좌 등록 버전, 확인 시점, 최종 판단을 연결해 관리하는 구조를 권합니다. 확인 문구와 계좌번호를 분석 도구나 고객지원 채팅에 그대로 남기지 않도록 수집 경로도 점검하세요.
출시 전 시험은 승인된 테스트 방식과 데이터로 진행합니다. 정상 흐름뿐 아니라 중복 클릭, 입력 지연, 틀린 문구, 계좌 수정, 결과 불명확 상태, 사용자의 중도 이탈을 확인하세요. 재발송 횟수와 대기 시간은 이 글의 임의 숫자가 아니라 제공 조건과 서비스 위험 평가에 맞춰 정해야 합니다.
APICK 1원 인증 도입의 첫 단계는 무작정 호출하기가 아니라 문의할 요구사항을 정리하는 것입니다. 공식 가이드의 상품문의 안내에서 이용 조건과 인증 완료 절차를 확인한 뒤, 가입·키 준비·승인된 시험을 순서대로 진행해 보세요.
확인 범위: 2026년 10월 28일 공개 문서와 가입 UI를 확인했습니다. 회원가입 완료, API 키 발급, 실제 API 호출 및 1원 송금은 실행하지 않았습니다. 인증 성공 화면이나 완료 응답도 재현하지 않았습니다.
#APICK #에이픽 #1원인증 #계좌인증 #정산계좌 #프리랜서플랫폼 #API연동
댓글
댓글 쓰기