연동하기
테스트와 검수
테스트 게이트웨이에서 전 구간을 통과하고 운영 전환 검수를 요청하는 절차입니다.
결제 링크 API 테스트
테스트 게이트웨이 https://dev-api.chewingpay.com은 API 연동 확인용입니다. 결제 생성·조회·삭제, 서명과 오류 코드를 확인할 수 있고, 결제 링크는 테스트 결제 페이지(dev.chewingpay.com)로 열립니다. 테스트 가맹점에는 카드 단말(CAT)이 연결돼 있지 않아 실제 카드 결제는 되지 않습니다(결제·취소를 시도하면 4006).
- 결제 완료 콜백과
APPROVE_COMPLETE조회를 시험하려면 거래번호(TRANS_SEQNO)를 기술 지원 채널로 알려 주세요. 카리페이가 테스트 승인 처리해CONFIRM_URL로 콜백을 보냅니다. - 실제 카드 결제와 취소는 운영 환경에서 소액(100원) 결제 후 전액 취소로 확인합니다. 귀사 가맹점 등록 전에는 카리페이가 제공하는 테스트 가맹점을 쓸 수 있습니다.
스모크 시나리오
| # | 단계 | 확인 | 환경 |
|---|---|---|---|
| 1 | requestPayment | RESULT_CODE 0000, REDIRECT_URL 수신, 주문 PENDING 저장 | 테스트 |
| 2 | 결제 — 테스트는 카리페이에 테스트 승인 요청, 운영은 실제 카드 100원 | 결제 완료 | 테스트·운영 |
| 3 | 콜백 수신 | CONFIRM_URL에 POST 도착, 200 응답 | 테스트·운영 |
| 4 | searchPayment | APPROVE_COMPLETE, APPROVAL_AMOUNT = 주문 금액 | 테스트·운영 |
| 5 | 중복 콜백 | 같은 본문을 두 번 보내도 서비스 제공은 1회 | 테스트 |
| 6 | 콜백 없이 폴링 | 콜백 핸들러를 잠시 막고 폴링만으로 PAID 전이 | 테스트 |
| 7 | requestPaymentCancel CANCEL | 0000, 조회 시 CANCEL_COMPLETE | 운영 |
| 8 | requestPaymentCancel DELETE | 미결제 건 STORE_DELETE, 링크 접속 시 결제 불가 | 테스트 |
| 9 | 오류 | 잘못된 서명 3001, 중복 거래번호 4001, 없는 거래 조회 4003 | 테스트 |
SDK 사용자는 node/example-express.mjs를 띄우면 생성·콜백·폴링·멱등 처리를 한 번에 확인할 수 있습니다. 결제 단계는 위 2번 방식으로 진행합니다.
로컬 콜백 받기
콜백은 HTTPS 공개 주소여야 합니다. 로컬 개발에는 ngrok·cloudflared 같은 터널의 https 주소를 CONFIRM_URL로 쓰세요.
청구서 API 테스트
청구 API는 실발송 환경 하나뿐입니다.
- 수신자는 본인 또는 동의한 테스트 번호만. 고객 번호로 테스트하지 않습니다.
- 금액은 100원,
requestId는test_로 시작하는 값을 씁니다. - 발송 후
getInvoice로sendHistories와sendChannel을 확인하고, 청구서를 삭제해 마감합니다. - 발송 없이 코드만 검증하려면 SDK의 모의 테스트(
npm test)를 참고하세요.
검수 요청
테스트가 끝나면 아래 정보를 기술 지원 채널로 보내 주세요. 카리페이가 게이트웨이 로그로 확인한 뒤 운영 키를 발급합니다.
- 결제 승인 TRANS_SEQNO:
- 승인 취소 TRANS_SEQNO:
- 청구서 삭제 TRANS_SEQNO:
- 콜백 수신 URL(도메인만):
- 서비스 URL · 오픈 예정일 · 장애 연락처:운영 전환 전 배포 체크리스트를 확인하세요.
문서에 없는 내용이나 오류는 bellight@goatheaven.com 또는 지원 문의로 알려주세요.