결제 웹훅: 제품 및 비즈니스 규칙

결제 웹훅에 대한 고객 흐름, 상태, 계산, 권한 효과, 메시지 및 예외 사례를 정의합니다. 환경별 한계를 구성 가능하게 유지하면서 채택 경계와 관찰 가능한 실패 증거를 고정합니다.

패키지 상태: 인간 검토를 위한 참조 컨텍스트 준비 완료. 계약 및 테스트 시나리오는 완성되었으나, 채택 구현이 이를 통과했다는 주장은 없습니다.

결정

결제 웹훅의 경우, 인증된 공급자 이벤트와 조정되는 내부 내구성 원장을 채택합니다. 사용자에게 보이는 약속, 제외 사항, 권한 및 실패 대응을 명확히 하면서 측정된 임계값은 채택 선택 사항으로 둡니다. 이 요구사항 블록은 제품 및 비즈니스 규칙에 구체적으로 집중합니다. 이 패키지는 참조 계약이며, 채택 팀은 자체 환경의 증거를 바탕으로 수치 한계, 공급자, 관할 구역 및 운영 소유자를 선택해야 합니다.

범위

• 결제 웹훅 행위자, 입력, 출력, 상태, 정책 또는 스키마 버전, 그리고 제품 및 비즈니스 규칙에 필요한 외부에 보이는 결과.
• 기본 및 대체 인터페이스, 백그라운드 작업, 캐시, 통합, 지원 경로 및 동일 경계를 실행할 수 있는 증거.
• 참조를 안전하게 적용하는 데 필요한 채택별 구성, 롤아웃, 복구 및 검증 책임.

이 블록에 포함되지 않는 사항

• 모든 채택자에 대해 보편적인 공급자, 프레임워크, 관할 구역, 수치 임계값, 보존 기간 또는 서비스 수준 목표를 선택하는 것.
• 패키지된 시나리오가 하위 구현에서 실행되었거나 이 참조가 법적, 보안 또는 접근성 인증을 부여한다고 주장하는 것.

계약

• 화폐는 명시적 통화 및 정확한 소수점 또는 소단위 값으로 표현하며, 원장 산술에 이진 부동소수점은 절대 사용하지 않습니다.
• 각 외부에 보이는 금융 의도에 대해 관련 원장 및 감사 수명 동안 유지되는 내구성 고유 키를 부여합니다.
• 공급자 콜백을 인증하고, 원시 이벤트 참조를 영구 저장하며, 현재 상태 검증 후 멱등하게 상태 전환을 적용합니다.
• 고객 대상, 공급자, 권한, 송장, 정산, 환불 및 조정 상태를 분리하며, 하나의 상태를 모두에 권위 있는 상태로 취급하지 않습니다.
• 각 실질 상태에서 어떤 행위자가 어떤 결과를 받는지 명시하며, 사용 불가, 권한 없음, 빈 상태, 부분 상태를 포함합니다.
• 구성 가능한 한계와 정책을 소유자가 있는 선택 사항으로 표시하며, 샘플 값을 보편적 요구사항으로 제시하지 않습니다.
• 결제 웹훅을 수락하기 전에 공급자 신원, 서명, 타임스탬프, 환경, 계정, 이벤트 유형 및 페이로드 버전을 원시 수신 바이트와 대조하여 검증합니다.
• 영수증을 내구성 있게 저장하고, 공급자 이벤트 및 객체 ID별 중복 제거하며, 현재 상태 조회 또는 버전 규칙을 통해 재정렬을 허용하고, 처리, 재시도, 격리 및 조정을 관찰 가능하게 만듭니다.
• 제품 및 비즈니스 규칙 변형에 대해 이 선언된 경계를 강제합니다: 결제 웹훅에 대한 고객 흐름, 상태, 계산, 권한 효과, 메시지 및 예외 사례를 정의합니다.

구현 지침

• 검토를 넘기기 전에 제품, 구현, 운영, 보안 및 영향 받는 사용자와 계약을 검토합니다.
• 프레임워크 또는 공급자 세부사항을 선택하기 전에 결제 웹훅 입력, 출력, 행위자, 상태, 불변 조건, 부작용 및 증거를 모델링합니다.
• 적용 가능한 결제 웹훅 계약 또는 정책 버전을 실질 상태와 함께 저장하여 마이그레이션, 재실행 및 지원 결정이 추적 가능하도록 합니다.
• 통제된 롤아웃 뒤에 경로를 도입하고, 예상 결과와 관찰된 결과를 비교하며, 채택 증거가 완성될 때까지 테스트된 복구 경로를 유지합니다.

실패 처리 및 안전장치

• 모호한 공급자 결과는 조정 대기 상태로 남으며, 시스템은 중복 가치를 부여하거나 금융 의무를 조용히 폐기하지 않습니다.
• 잘못되었거나 모순된 결제 웹훅 상태는 거부되거나 격리되며, 구현은 권한을 확장하거나 효과를 중복시키는 값을 추측하지 않습니다.
• 재시도는 한계가 있으며 내구성 있는 ID를 사용합니다; 소진 후 작업은 책임 있는 소유자가 있는 검사 가능한 최종 상태에 도달합니다.

검증 및 운영

• 각 약속과 제외 사항을 적어도 하나의 관찰 가능한 시나리오에 매핑하고, 두 상태가 모순된 결과를 요구하지 않음을 확인합니다.
• 결제 웹훅 성공, 거부, 검증 실패, 의존성 실패, 재시도 소진 및 복구를 계약 버전별로 민감한 페이로드 차원 없이 모니터링합니다.
• 정책, 스키마, 의존성, 마이그레이션 또는 경계 변경 후 양성 및 음성 픽스처를 재실행하고 결과 증거를 보존합니다.

채택 가정

• 예제의 이름과 값은 구체적인 픽스처이며 보편적 기본값이 아니며, 채택자는 문서화된 증거와 소유권을 통해 이를 교체합니다.
• 채택 시스템은 인증된 신원, 내구성 있는 작업 또는 기록 버전, 제한된 텔레메트리 및 변경을 위한 통제된 경로를 제공할 수 있습니다.

이 패키지의 실행 가능한 예제는 픽스처 및 수용 계약입니다.
구조와 메타데이터를 확인하려면 컬렉션 검증기를 실행한 후, 대상 저장소에서 시나리오를 번역 및 실행하여 구현 증거를 기록하십시오.

참고 문헌

• PCI Security Standards Council, PCI DSS (2026-09-08부터 적용)