연동하기
배포 체크리스트
운영 전환 전 마지막으로 확인할 항목입니다.
키·환경
- 운영
BASE_URL(https://api.chewingpay.com)과 운영용PLATFORM_CODE·STORE_CODE·API_KEY로 교체했다 (CARIPAY_MODE=live). API_KEY가 코드·로그·프런트 번들·저장소 히스토리에 없다.- 테스트 키가 운영 서버 환경변수에 남아 있지 않다.
결제 로직
- 금액은 서버 카탈로그에서 결정한다. 클라이언트 금액을 그대로 청구하지 않는다.
TRANS_SEQNO는 전 시스템에서 유일하다(접두어 + 시각 + 난수).- 콜백 수신 시
searchPayment로APPROVE_COMPLETE·승인금액을 재확인한다. - 중복 콜백·중복 폴링에도 서비스 제공은 1회다(조건부 상태 전이).
- 콜백 누락 대비 폴링(프런트 대기 화면 또는 미결제 배치)이 있다.
CONFIRM_URL이https://이고 200을 빠르게 응답한다.- 취소 경로가 환불 정책과 맞는다(전액 취소만 가능함을 운영자가 안다).
운영 준비
- 승인금액과 주문금액을 일 단위로 대사하는 작업이 있다.
- 장애 연락망(카리페이 담당자·귀사 담당자)을 교환했다.
- 고객 안내 문구에 결제수단(신용카드·카카오페이)과 환불 정책이 맞게 적혀 있다.
- 소액 실결제 1건으로 운영 키 동작과 정산 입금을 확인했다.
청구서 API·콘솔
- 사업자 등록이 승인됐고
STORE_CODE가 연결돼 있다. - 포인트 잔액이 첫 달 발송량을 감당한다.
- 기본 발송 수단을 정했다(알림톡 / 문자 / 알림톡 실패 시 문자).
requestId를 주문마다 저장하고 재시도에 같은 값을 쓴다.- 수납 확인 폴링 주기를 정했다.
문서에 없는 내용이나 오류는 bellight@goatheaven.com 또는 지원 문의로 알려주세요.