FDS 도입 전에 준비할 결제 데이터

식별자는 연결의 기준

거래번호, 주문번호, 가맹점과 단말기 식별자를 구분하세요. 주문 하나에 여러 결제가 존재할 수 있으므로 주문번호만으로 거래를 유일하게 취급하면 실제 거래가 누락될 수 있습니다. 외부 식별자가 어느 시스템에서 발급되는지도 정리합니다.

금액과 시각은 단위를 함께 확인

금액의 숫자만 전달하지 말고 통화와 소수 단위 정책을 확인합니다. 거래 시각과 수신 시각은 각각 원 거래 발생과 서버 도착을 뜻하므로 대체하면 안 됩니다. API가 요구하는 형식과 시간대를 개발자 문서에서 확인하세요.

입력 품질을 시험하는 예시

한 승인 거래를 동일하게 두 번 보내고, 그 거래의 취소를 보낸 뒤 운영 화면의 횟수와 금액을 확인합니다. 이후 존재하지 않는 원 승인에 대한 취소도 시험해 정상 연결된 취소와 구분되는지 봅니다. 테스트 데이터는 실제 고객이나 카드 정보를 사용하지 않습니다.

운영 전 점검 목록

• 필수 값이 비어 있을 때 오류를 감지할 수 있는가.
• 가맹점 이름 변경과 식별자 변경을 구분하는가.
• 재시도 시 원본 시각·금액·식별자를 그대로 보존하는가.
• 전체 카드번호나 불필요한 개인정보를 보내지 않는가.

이 목록은 데이터 품질 점검용입니다. 실제 허용 필드·길이·자료형은 API 계약이 기준이며, 임의의 보완 필드를 추가하면 입력 검증에서 거절될 수 있습니다.

가상 검증 사례

가상 승인 한 건을 동일 키로 두 번 보내고 전체 취소를 연결합니다. 원 승인 식별자가 다른 취소도 보내 정상 연결과 구분되는지 확인합니다. 중복 때문에 승인 합계가 두 배가 되면 입력 정합성을 먼저 수정합니다.

이 사례는 실측 성능이나 실제 고객 자료가 아닙니다. 제품의 적용 범위는 GUARDIAN 공개 API 계약를 기준으로 확인합니다.