환경 설정하기

테스트 환경 주의점, 방화벽 설정, 지원 플랫폼 및 브라우저를 알아보세요.

테스트 환경

테스트 키로 요청한 결제도 실제로 승인되고 청구돼요. 카드 승인·청구나 계좌 출금이 발생하므로 소액으로 테스트하고, 당일 안에 취소 API로 취소해주세요.

테스트 결제의 23시 일괄 취소를 이용하려면 캔디페이 담당자와 적용 대상과 기간을 협의해주세요. 협의한 대상과 기간에 맞춰 일괄 취소를 적용해요.

테스트 환경에서 에러 재현하기

Candypay-Sdk-Test API 헤더를 사용하면 결제 처리 전에 지정한 에러 응답을 반환해 상점의 오류 처리 로직을 확인할 수 있어요.

Candypay-Sdk-Test: {TEST_CODE}

아래 예시는 결제 승인 API에서 승인 거절 에러 REJECT_CARD_COMPANY를 반환하도록 요청해요.

• Authorization 인증 헤더에 발급받은 테스트 시크릿 키를 사용해주세요.
• Candypay-Sdk-Test 헤더에 재현하고 싶은 에러 코드를 넣고 API를 호출하세요.
• 이 헤더는 테스트/라이브 키 요청 모두에 적용돼요. 실제 결제 요청에서는 제거해주세요.

curl --request POST \
  --url https://api.candypay.co.kr/px/intents/confirm \
  --user '{API_SECRET_KEY}:' \
  --header 'Content-Type: application/json' \
  --header 'Candypay-Sdk-Test: REJECT_CARD_COMPANY' \
  --data '{"intentKey":"{INTENT_KEY}","orderId":"{ORDER_ID}","amount":15000}'

그럼 아래와 같이 테스트한 에러 코드의 에러 객체가 응답으로 돌아옵니다.

{
  "code": "REJECT_CARD_COMPANY",
  "message": "결제 승인이 거절되었습니다."
}

지원 플랫폼·브라우저 환경

캔디페이 SDK가 지원하는 플랫폼·브라우저 환경이에요. 캔디페이 결제 서비스를 원활하게 이용하려면 최신 버전의 브라우저를 사용하는 것을 권장해요. 최신 브라우저는 더 안전하고 안정적이기 때문에 결제 오류를 최소화할 수 있습니다.

플랫폼 환경	브라우저 환경
데스크톱 브라우저	- Chrome 72 이상 - Edge 79 이상 - Firefox 64 이상 - Safari 13 이상 - Whale 1.6.81.8 이상
모바일 웹	Chrome, Safari, Firefox, 삼성 인터넷
모바일 앱	Android, iOS