이용약관 API
결제 서비스 이용 시 고객에게 표시해야 하는 각종 이용약관을 조회하는 API입니다.
결제 API와의 차이점
이용약관 API는 결제창 및 결제 관련 API와는 별개로 동작합니다.
- 도메인:
https://www.firstpay.co.kr(결제 API 도메인과 다름) - 용도: 가맹점에서 필요한 경우 팝업 또는 레이어 형식으로 약관을 표시할 때 사용
요청 Query 파라미터
GET
https://www.firstpay.co.kr/agreement?caseType={caseType}&langType={langType}
Base URL
https://www.firstpay.co.krContent-Type
application/json필수
조건부 필수
| key | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
| Number | 1 | 약관 유형 코드 (1~10) | ||
| String | - | ko | 언어 설정 (ko: 한국어, en: 영어) |
결제 수단별 필수 약관
- 신용카드 결제: caseType 1, 3, 4
- 가상계좌, 계좌이체 결제: caseType 1, 2, 3, 4
- 휴대폰 결제: caseType 7, 9, 10
- 정기결제 (빌링): caseType 1, 2, 3, 6, 8
- 에스크로 결제: caseType 5
CORS 주의
fetch로 약관 내용을 가져올 경우 CORS 정책에 의해 차단될 수 있습니다. 이 경우 iframe을 사용하거나, 서버 사이드에서 약관 내용을 가져온 후 클라이언트에 전달하는 방식을 권장합니다.
인증 불필요
이용약관 API는 공개 API로, 별도의 인증(callHash 등)이 필요하지 않습니다. 누구나 URL을 통해 약관 내용을 조회할 수 있습니다.