전체 연동 흐름
- 영카트 주문 상세에서 WHATTA 전송 버튼으로 주문을 push합니다.
- WHATTA는 주문번호 기준으로 중복을 차단하고 배송접수 대기 목록에 저장합니다.
- 배송접수 전환 후 송장이 생성되면 callback payload를 쇼핑몰로 전송합니다.
- 영카트 callback 파일은 서명을 검증한 뒤 od_invoice와 od_invoice_time을 저장합니다.
WHATTA 실무 가이드
영카트 송장 및 택배 API 자동연동
영카트 송장번호 자동 반영은 주문 push와 WHATTA 송장 callback이 같은 주문번호 기준으로 안전하게 연결되어야 합니다.
이 가이드에서 확인할 내용
가이드 목록
그누보드·영카트 쇼핑몰에서 주문을 WHATTA로 보내고, 송장번호를 다시 영카트 주문에 저장하는 흐름을 정리합니다.
중복 주문, 중복 callback, 다른 송장 충돌을 막는 정책이 있어야 운영 중 송장번호가 잘못 덮어써지지 않습니다.
callback 서명 검증
- WHATTA가 보낸 timestamp와 body 원문을 기준으로 HMAC 서명을 검증합니다.
- 검증키가 다르거나 body가 바뀌면 INVALID_SIGNATURE로 거부해야 합니다.
- 검증 실패 요청은 송장번호를 저장하지 않습니다.
- 운영 전 callback URL과 검증키를 테스트해야 합니다.
중복과 충돌 처리
- 같은 송장이 다시 오면 DUPLICATE로 응답하고 기존 값을 유지합니다.
- 다른 송장이 이미 있으면 INVOICE_CONFLICT로 응답하고 덮어쓰지 않습니다.
- 주문번호가 없으면 ORDER_NOT_FOUND로 분리합니다.
- 필수 payload가 빠지면 INVALID_PAYLOAD로 처리합니다.
WHATTA에서 처리되는 범위
- 영카트 주문 push 수신과 중복 방지
- 배송접수 전환과 송장 생성 후 callback queue 관리
- callback 성공, 실패, 재시도 대기 상태 저장
- 운영자가 실패 사유를 확인할 수 있는 상태 표시
