환경 설정하기

토스페이먼츠가 처음이라면 아래 가이드를 참고해서 연동을 준비하세요.

테스트 키로 연동할 때 실제 결제 정보(카드 번호, 휴대폰 번호 등)를 사용해도 결제 승인은 가상으로 이루어져요. 따라서 테스트 환경에서는 결제 승인에 성공해도 내 결제수단에서 빠져나가는 금액은 없어요.

테스트 환경이 라이브 환경과 달라서 주의해야 할 점이에요.

테스트 환경에서 에러를 재현하고 싶다면 토스페이먼츠 API 테스트 헤더를 사용하세요.

TossPayments-Test-Code: {TEST_CODE}

• {TEST_CODE} 자리에 재현하고 싶은 에러 코드를 넣고 API를 실행하세요.
• test_ 로 시작하는 테스트 API 키를 사용해주세요. 라이브 환경에서는 테스트 코드 헤더가 무시됩니다.

예를 들어, 카드 번호 결제 API에 잘못된 유효기간을 넣었을 때 돌아오는 응답을 보고 싶다면 아래와 같이 INVALID_CARD_EXPIRATION를 테스트 헤더에 추가하세요.

curl --request POST \
  --url https://api.tosspayments.com/v1/payments/key-in \
  --header 'Authorization: ' \
  --header 'Content-Type: application/json' \
  --header 'TossPayments-Test-Code: INVALID_CARD_EXPIRATION' \

1. 개발자센터의 테스트 결제내역 메뉴로 이동하세요.

2. 날짜 별, 결제수단 별로 결제내역을 조회할 수 있어요.

3. 가상계좌 결제는 가장 오른쪽 컬럼에서 결제를 취소하거나 가상계좌 입금을 처리할 수 있어요.

   • '취소' 를 선택하면 결제 취소 API를 호출하지 않고 테스트 결제를 취소할 수 있어요.
   • '입금처리' 를 선택하면 가상계좌에 입금되는 액션을 테스트할 수 있어요.

토스페이먼츠는 고객의 결제 정보와 개인 정보를 보호하기 위해 HTTPS 통신과 TLS 버전 1.2 이상만 지원해요.

서버에서 아래 토스페이먼츠 IP 주소를 허용해주세요. 더 자세한 내용은 방화벽 가이드에서 확인하세요.

토스페이먼츠 SDK가 지원하는 플랫폼·브라우저 환경이에요.