테스트 · 오픈

운영 전환 체크리스트

양도 코드 연동을 실제 거래에 열기 전에 확인할 항목입니다. 테스트 모드에서 모든 흐름을 확인한 뒤, 접수·승인·링크·해제·정산 처리와 운영 키를 점검하고 소액 양도 1건으로 마지막 확인을 합니다.

진행 상황 0 / 32

체크 표시는 이 브라우저에만 저장됩니다.

1. 테스트 모드에서 확인 #

테스트 키로 테스트 양도 코드를 발급해 확인 → 접수 → 승인 시뮬레이션 → 링크 생성 → 테스트 PIN 확인 → delivered 까지 끝까지 확인했다 관련 문서
오류는 code 로 분기한다 (특히 같은 401 인 UNAUTHORIZED 와 WRONG_PASSWORD 를 구분한다) 관련 문서

매물 등록 전에 GET /v1/transfers/code/{code} 로 확인하고, claimable 이 false 면 등록 화면으로 넘어가지 않는다 관련 문서
확인 응답의 items · faceTotal 이 판매자가 올리려는 매물과 같은지 대조한다 관련 문서
접수(POST /v1/transfers/claim) 응답이 성공일 때만 다음 단계로 가고, 409 ALREADY_CLAIMED 면 등록을 막는다 관련 문서
코드 원문 대신 transferId 와 codeLast4 만 저장하고, transferId 에 고유 제약을 둔다 관련 문서
접수 응답을 받지 못하면 같은 코드로 다시 접수해 같은 transferId 를 이어서 쓴다 관련 문서

양도 비밀번호(숫자 6자리)는 접수할 때마다 판매자에게 입력받고, 저장하거나 로그에 남기지 않는다 관련 문서
passwordSet 이 false 거나 409 PASSWORD_NOT_SET 이면 판매자에게 핀락 주문 화면에서 비밀번호를 정해 달라고 안내한다 관련 문서
401 WRONG_PASSWORD 면 남은 횟수(meta.attemptsLeft)를 보여 주고 같은 값으로 자동 재시도하지 않으며, 423 LOCKED 면 60분 뒤 다시 시도하라고 안내한다 관련 문서
테스트 고정 비밀번호를 운영 코드의 기본값으로 쓰지 않는다 관련 문서

접수 뒤(pending_approval) 판매자에게 핀락에서 승인해 달라고 안내하고, approval.expiresAt 까지 남은 시간을 보여 준다 관련 문서
조회로 claimed_by_you 를 확인한 뒤에만 매물을 공개하고 링크를 만든다 (그 전에는 409 APPROVAL_PENDING) 관련 문서
승인 기한이 지나거나 판매자가 거절해 조회가 404 가 되면 매물을 내리고 판매자에게 다시 등록하라고 안내한다 관련 문서

구매자 결제 취소·매물 삭제 등으로 거래가 깨지면 POST /v1/transfers/{transferId}/release 로 바로 해제한다 관련 문서
7일 자동 해제(claimExpiresAt) 전에 팔리지 않은 매물을 내리고 해제한다 관련 문서
해제가 409 CONFLICT 면 조회로 delivered 인지 확인해 처리한다 관련 문서

링크를 만든 거래만 30~60초 간격으로 조회하고, delivered 가 되거나 선점이 풀리면(404) 조회를 멈춘다 관련 문서
delivered 를 확인한 뒤에만 판매자에게 정산한다. 판매자 정산은 핀락이 아니라 업체가 직접 한다 관련 문서
키당 호출 한도(429 LIMIT_EXCEEDED)를 넘지 않도록 폴링 간격과 동시 요청 수를 조절하고, 429 면 간격을 늘려 재시도한다 관련 문서
예상하지 못한 상태 값을 받아도 멈추지 않고 안전하게 처리한다 관련 문서

모두 확인했다면

운영 준비가 끝났습니다. 운영 중 문제가 생기면 응답 헤더의 X-Request-Id 와 transferId 를 함께 알려 주시면 빠르게 확인할 수 있습니다.