# sendwich

> Phone number verification through user-sent SMS.

Website: https://sendwich.kr. Merchant API: https://api.sendwich.kr. Hosted verification window: https://id.it.kr.

Users send the returned sms_text to destination from their phones. Integrations create, retrieve and cancel verifications through the server-side API and receive results by polling or signed webhook. Free and Plus both support the hosted window and direct API integration.

## 시작하기

- [sendwich 시작하기](https://sendwich.kr/docs/markdown/index.md): SMS 인증 흐름과 인증 창·API 연동 방식
- [첫 인증 만들기](https://sendwich.kr/docs/markdown/quickstart.md): 프로젝트 생성부터 첫 인증 결과 조회까지

## 인증 이해하기

- [보내는 번호와 받는 번호](https://sendwich.kr/docs/markdown/phone-numbers.md): 발신 번호·수신 번호의 역할과 지원하는 전화번호 형식
- [인증 문자와 유효시간](https://sendwich.kr/docs/markdown/verification-codes.md): 인증 코드 형식, 유효시간, 문자 일치 규칙
- [인증 모드](https://sendwich.kr/docs/markdown/verification-modes.md): 발신 번호를 확인하는 discover와 지정한 번호를 검증하는 match

## 인증 창

- [인증 창 연결하기](https://sendwich.kr/docs/markdown/verification-window.md): 팝업, 완료 알림, 모바일·QR 전환 설정
- [인증 화면 설정](https://sendwich.kr/docs/markdown/verification-window/settings.md): 인증 창의 템플릿, QR 표시, 로고와 색상 설정

## API

- [API로 직접 연동하기](https://sendwich.kr/docs/markdown/api.md): 웹·앱·봇에서 인증 흐름을 직접 구현하는 방법
- [API 키와 인증](https://sendwich.kr/docs/markdown/api/authentication.md): 프로젝트 API 키 발급, 권한, 보관과 교체
- [인증 생성](https://sendwich.kr/docs/markdown/api/create.md): 인증 생성 요청·응답과 Idempotency-Key 사용 규칙
- [인증 조회와 취소](https://sendwich.kr/docs/markdown/api/retrieve-and-cancel.md): 인증 상태·결과 조회와 대기 중인 인증 취소
- [오류와 재시도](https://sendwich.kr/docs/markdown/api/errors.md): HTTP 상태별 오류 코드와 재시도 조건

## 웹훅

- [웹훅](https://sendwich.kr/docs/markdown/webhooks.md): 인증 결과 수신, 서명 검증, 중복 이벤트 처리

## 연동 예제

- [직접 만든 인증 화면](https://sendwich.kr/docs/markdown/examples/custom-ui.md): 사용자 화면과 서비스 서버의 구성 예제
- [Discord 봇](https://sendwich.kr/docs/markdown/examples/discord.md): 비공개 인증 안내와 역할 부여를 구현하는 Node.js 봇
- [Node.js와 Python](https://sendwich.kr/docs/markdown/examples/node-python.md): Node.js·Python 서버에서 인증을 생성하고 조회하는 예제

## 운영하기

- [요금제와 사용량](https://sendwich.kr/docs/markdown/usage.md): 요금제별 기능, API 호출 집계, 월 사용량 한도
- [문제 해결](https://sendwich.kr/docs/markdown/troubleshooting.md): 문자 인증, 팝업 연결, 웹훅 수신 오류 해결

## 도구

- [LLM용 문서](https://sendwich.kr/docs/markdown/llms.md): 코딩 도구용 Markdown 문서와 OpenAPI 명세

## 활용 사례

- [휴대폰 인증 API](https://sendwich.kr/solutions/phone-verification-api/): 휴대폰 인증 API를 무료로 연동하는 방법. 인증 생성, 결과 조회, 웹훅까지 세 단계로 끝나고 계약과 심사가 필요 없어요.
- [회원가입 휴대폰 인증](https://sendwich.kr/solutions/signup-verification/): 회원가입에 휴대폰 인증을 붙여 다계정 가입과 어뷰징을 막는 방법. 실명 확인 없이 번호 점유만 확인해요.
- [디스코드 봇 인증](https://sendwich.kr/solutions/discord/): Discord 봇에서 휴대폰 인증을 받고 인증된 사용자에게 역할을 부여하는 방법. Node.js 예제와 함께 안내해요.
- [휴대폰 인증 비용 비교](https://sendwich.kr/compare/free-phone-verification/): 휴대폰 인증에 드는 기본료, 건당 요금, 계약과 심사 기간을 비교하고 무료로 시작할 수 있는 조건을 정리했어요.

## Reference

- [Merchant OpenAPI](https://sendwich.kr/docs/openapi.json): Request and response schemas for create, retrieve and cancel operations.
- [All documentation](https://sendwich.kr/llms-full.txt): All articles in a single Markdown file.