도움말

릴리즈 노트

게이트웨이·청구 서버·SDK·문서의 변경 이력입니다.

2026-10-08

결제 후 복귀(RETURN_URL) — 결제를 시작할 때 복귀 주소가 바뀌어 결제 후 귀사 페이지로 돌아가지 못하던 문제를 고쳤습니다. 복귀 주소에 붙는 값에서 고객 휴대폰 번호(MOBILE_NO)를 뺐고, 귀사 주소에 이미 있는 쿼리는 유지합니다. 결제 생성
콜백 재시도 — 결제 완료 콜백이 실패하면 최대 30회(약 21시간) 재시도합니다. 폴링은 계속 병행해 주세요. 콜백 구현

테스트 환경 안내 정정 — 테스트 게이트웨이는 API 연동 확인용이며 실제 카드 결제가 되지 않습니다. 결제 완료는 카리페이 테스트 승인으로, 실제 결제·취소는 운영 소액 결제로 확인합니다. 테스트와 검수
테스트 결제 링크 — 테스트 게이트웨이의 REDIRECT_URL이 테스트 결제 페이지(dev.chewingpay.com)로 발급됩니다. 이전에는 운영 결제 페이지 주소로 나와 열리지 않았습니다.
CONFIRM_URL 길이 — 100자 이내로 보내 주세요. 결제 생성

청구 항목 표시 — 청구서에 items가 있으면 알림톡·문자에 [청구 항목] 목록(상품명·수량·금액, 5개까지)이 들어갑니다. 재발송·대체 문자도 같습니다. 예시
SDK 1.5.0 — sendInvoice({ items }). amount를 생략하면 항목 합계로 청구합니다.
콘솔 — 청구서 발송 창에서 청구 항목(상품명·금액)을 입력할 수 있습니다.

청구서 웹훅 서명 — POST /app/v1/sales/bill에 webhookSecret. 있으면 웹훅마다 X-CariPay-Signature: t=<unix초>,v1=<HMAC-SHA256 hex>. 규격
SDK 1.4.0 — sendInvoice({ webhookSecret }), verifyWebhookSignature()(Node)·verify_webhook_signature()(Python). GitHub Release v1.4.0.

청구서 웹훅 — POST /app/v1/sales/bill에 webhookUrl. 결제 완료 bill.paid·취소 bill.canceled를 POST, 1분→5분→30분→2시간 재시도. 규격
운영 반영 — 발송 수단 선택·requestId 에코·웹훅이 운영 청구 서버(카리아카 운영 라인)에도 적용됐습니다.
SDK 1.3.0 — sendInvoice({ webhookUrl }), InvoiceWebhookPayload 타입.
안정성 — 청구 서버가 이미지 롤백 후에도 Flyway 이력을 훼손하지 않도록 repair()를 실패 행이 있을 때만 실행합니다.

청구서 발송 수단 선택 — POST /app/v1/sales/bill에 sendChannel(ALIMTALK · SMS · ALIMTALK_THEN_SMS) 추가. 예약·정기 발송과 재발송도 같은 수단을 따릅니다. 발송 이력에 실제 수단(sendChannel)이 기록됩니다.
멱등 키 — 청구서 API requestId. 같은 키 재요청은 새 청구서·포인트 차감·발송 없이 기존 청구서를 돌려줍니다.
공개 청구서 조회 — GET /app/v1/sales/public/bill/{transSeqNo}. 알림톡·문자 링크(caripay.co.kr/pay/{거래번호})가 사용합니다.
SDK 1.2.0 — sendInvoice({ channel }), CariPayBilling.login()(토큰 자동 갱신), createPayment({ returnUrl, tempValue }), 취소는 전액만 가능함을 명시.
개발자 문서 사이트 공개 — 이 문서.

문서에 없는 내용이나 오류는 bellight@goatheaven.com 또는 지원 문의로 알려주세요.