연동하기

테스트와 검수

테스트 게이트웨이에서 전 구간을 통과하고 운영 전환 검수를 요청하는 절차입니다.

결제 링크 API 테스트

테스트 게이트웨이 https://dev-api.chewingpay.com은 API 연동 확인용입니다. 결제 생성·조회·삭제, 서명과 오류 코드를 확인할 수 있고, 결제 링크는 테스트 결제 페이지(dev.chewingpay.com)로 열립니다. 테스트 가맹점에는 카드 단말(CAT)이 연결돼 있지 않아 실제 카드 결제는 되지 않습니다(결제·취소를 시도하면 4006).

  • 결제 완료 콜백과 APPROVE_COMPLETE 조회를 시험하려면 거래번호(TRANS_SEQNO)를 기술 지원 채널로 알려 주세요. 카리페이가 테스트 승인 처리해 CONFIRM_URL로 콜백을 보냅니다.
  • 실제 카드 결제와 취소는 운영 환경에서 소액(100원) 결제 후 전액 취소로 확인합니다. 귀사 가맹점 등록 전에는 카리페이가 제공하는 테스트 가맹점을 쓸 수 있습니다.

스모크 시나리오

#단계확인환경
1requestPaymentRESULT_CODE 0000, REDIRECT_URL 수신, 주문 PENDING 저장테스트
2결제 — 테스트는 카리페이에 테스트 승인 요청, 운영은 실제 카드 100원결제 완료테스트·운영
3콜백 수신CONFIRM_URL에 POST 도착, 200 응답테스트·운영
4searchPaymentAPPROVE_COMPLETE, APPROVAL_AMOUNT = 주문 금액테스트·운영
5중복 콜백같은 본문을 두 번 보내도 서비스 제공은 1회테스트
6콜백 없이 폴링콜백 핸들러를 잠시 막고 폴링만으로 PAID 전이테스트
7requestPaymentCancel CANCEL0000, 조회 시 CANCEL_COMPLETE운영
8requestPaymentCancel 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 또는 지원 문의로 알려주세요.