시작하기

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

🚨 주의해주세요

iframe은 사용할 수 없어요.
iframe을 사용할 경우 앱인토스 기능이 정상 동작하지 않고, 내부 보안 심사에서도 반려됩니다.
단, YouTube 영상 콘텐츠를 삽입하는 용도는 예외적으로 iframe 사용이 가능해요.

서버 mTLS 인증서 발급받기

앱인토스 API 사용을 위해서는 필수로 mTLS(mutual TLS, 양방향 인증) 인증서를 설정해야 해요. 이 인증서는 파트너사 서버와 앱인토스 서버 사이의 통신을 암호화하고, 서로 신원을 확인하는 데 사용돼요.
mTLS 인증서가 준비되지 않으셨다면 서버 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":"요청에 실패했습니다."
   }
}