# 보내는 번호와 받는 번호

> 발신 번호·수신 번호의 역할과 지원하는 전화번호 형식

문서: https://sendwich.kr/docs/phone-numbers/

## 발신 번호

발신 번호는 인증 문자를 보낸 사용자의 휴대폰 번호입니다. 사용자는 확인하려는 번호의 SIM으로 문자를 전송해야 합니다. 듀얼 SIM 기기에서는 문자 앱에서 선택한 회선의 번호가 확인됩니다.

문자 발송 요금은 사용자의 통신사 요금제에 따라 발생할 수 있습니다.

## 수신 번호

수신 번호는 사용자가 문자를 보낼 sendwich의 번호로, 인증 생성 응답의 `destination`을 사용합니다.

```javascript
const receivingNumber = session.destination;
const messageToSend = session.sms_text;
```

화면에 번호를 표시할 때는 하이픈을 넣을 수 있습니다. 복사와 문자 앱 연결에는 응답의 원본 값을 사용합니다. 수신 번호는 sendwich에서 관리합니다.

## 지원 형식

대한민국 `010` 휴대폰 번호를 지원합니다. `match` 모드의 `expected_phone`에는 `01012345678`, `010-1234-5678`, `+821012345678` 형식을 사용할 수 있습니다. 인증 결과는 E.164 형식인 `+821012345678`로 반환합니다.

| 필드 | 의미 |
| --- | --- |
| `destination` | 인증 문자를 보낼 수신 번호 |
| `expected_phone` | `match` 모드에서 확인할 휴대폰 번호 |
| `phone` | 인증 성공 후 API·웹훅으로 반환하는 발신 번호 |
| `carrier` | 수신 문자에서 확인한 통신망: `SKT`, `KT`, `LGU+` 또는 `null` |

`carrier`는 통신망 정보이며 알뜰폰 판매 브랜드를 구분하지 않습니다. 통신망 정보가 없는 경우에도 번호 인증은 가능합니다.

번호를 사전에 입력받을지는 [인증 모드](https://sendwich.kr/docs/verification-modes/)에서 결정합니다. 전체 번호는 서버 API·웹훅으로 제공하며, 인증 창의 브라우저 API에서는 마스킹한 번호를 제공합니다.
