시작하기

앱인토스를 연동하기 위해 필요한 API를 소개드려요.
앱인토스 개발을 처음 시작하신다면, 좀 더 친절한 안내를 먼저 확인해보세요! '시작하기' 문서로 바로가기

🚨 잠시만요

앱인토스는 iFrame 방식을 공식적으로 지원하지 않습니다. iFrame 방식을 이용하는 경우 기능의 원활한 연동이 되지 않아요.
내부 보안 심사에서도 반려되니 iFrame 사용은 지양해 주세요.

서버 mTLS 인증서 발급받기

앱인토스 API 사용을 위해서는 필수로 mTLS(mutual TLS, 양방향 인증) 인증서를 설정해야 해요. 이 인증서는 파트너사 서버와 앱인토스 서버 사이의 통신을 암호화하고, 서로 신원을 확인하는 데 사용돼요.
mTLS 인증서가 준비되지 않으셨다면 여기를 확인해주세요.

통신 방화벽 확인하기

In/Out Bound 방화벽 관리를 하신다면 아래 IP를 방화벽에 등록해주세요.

가맹점이 허용해야하는 inbound IP 목록(앱인토스 -> 가맹점)

IP	port
117.52.3.11	443
211.115.96.11	443
106.249.5.11	443
117.52.3.80~87	443
211.115.96.80~87	443
106.249.5.80~87	443

가맹점이 허용해야하는 outbound IP 목록(가맹점 -> 앱인토스)

기능	도메인	IP	port
간편 로그인, 메시지 발송, 토스 포인트 지급	apps-in-toss-api-toss.im	117.52.3.192, 211.115.96.192, 106.249.5.192	443
간편 결제	pay-apps-in-toss-api-toss.im	117.52.3.195, 211.115.96.195, 106.249.5.195	443

API 공통규격 확인하기

도메인 정보

https://apps-in-toss-api.toss.im
https://pay-apps-in-toss-api.toss.im

API 공통 응답

성공

// 성공일 경우 resultType이 SUCCESS로 설정되며 해당 API의 응답이 success 하위에 적재됩니다.
{
   "resultType":"SUCCESS",
   "success":{
      "sample":"data"
   }
}

실패

// 실패일 경우 resultType 이 FAIL로 설정되며 해당 실패 사유가 error 하위에 적재됩니다.
{
   "resultType":"FAIL",
   "error":{
      "errorCode":"INVALID_PARAMETER",
      "reason":"요청에 실패했습니다."
   }
}