환경 설정하기

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

테스트 환경

캔디페이는 개발자의 연동 편의를 위해 라이브 환경과 비슷한 테스트 환경을 제공하고 있어요.

하지만 테스트 환경에서는 카드 번호와 같은 실제 결제 정보를 입력해도, 결제는 가상으로 승인돼요. 따라서 테스트 환경에서는 결제가 승인되어도 실제 결제수단에서 돈이 출금되지 않아요.

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

에러 대응을 위해 테스트 환경에서 API 에러를 재현하고 싶을 수도 있는데요. 아래 Candypay-Sdk-Test API 헤더를 사용하면 캔디페이에서 일어나는 모든 에러를 테스트 환경에서도 라이브 환경과 똑같이 재현할 수 있어요.

Candypay-Sdk-Test: {TEST_CODE}

아래 예시는 결제 승인 API에서 잔액 부족 또는 한도초과 에러 REJECT_CARD_PAYMENT를 재현하고 있어요. 예시로 사용 방법을 자세히 알아볼게요.

• Authorization 인증 헤더에 반드시 테스트 시크릿 키를 사용해주세요. 라이브 키를 사용하면 테스트 코드 헤더가 무시돼요.
• Candypay-Sdk-Test 헤더에 재현하고 싶은 에러 코드를 넣고 API를 호출하세요.

curl --request POST \
  --url https://api.candypay.co.kr/px/intents/confirm \
  --header 'Authorization: Basic dGVzdF9nc2tfZG9jc19PYVB6OEw1S2RtUVhrelJ6M3k0N0JNdzY6' \
  --header 'Content-Type: application/json' \
  --header 'Candypay-Sdk-Test: REJECT_CARD_PAYMENT' \
  --data '{"intentKey":"5zJ4xY7m0kODnyRpQWGrN2xqGlNvLrKwv1M9ENjbeoPaZdL6","orderId":"a4CWyWY5m89PNh7xJwhk1","amount":15000}'

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

{
  "code": "REJECT_CARD_PAYMENT",
  "message": "한도초과 혹은 잔액부족으로 결제에 실패했습니다."
}

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

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