수정된 사업자 신원 정보 다시 확인하기
기존 조직 브랜드의 수정된 신원 정보를 다시 확인해야 할 때 이 작업을 사용하세요. 먼저 기존 브랜드를 업데이트한 다음 현재 신원 확인 상태를 조회하세요. 일반적인 프로필 업데이트로는 이 별도의 유료 확인이 신청되지 않습니다. 재인증은 다른 브랜드를 만들거나 캠페인을 등록하지 않습니다.
허용된 출발지 IP에서 HTTPS를 통해 본인의 활성화된 API 계정을 사용하세요. 브랜드는 해당 계정에 속해야 합니다. 브랜드 기록에는 사업자 정보와 연락처 정보가 포함되어 있으므로 비공개로 관리하세요.
신청 전에 브랜드 검토하기
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
--output current-brand.json반환된 브랜드가 의도한 사업자에 해당하고 수정 사항이 반영되었는지 확인하세요. 최초 등록이 대기 중이면 아직 재인증할 수 없습니다. 사업자 정보가 변경되지 않았다면 등록 기관이 요청을 거부할 수 있습니다. 특수 속성이 누락된 경우에는 신원 확인을 다시 신청하는 대신 이의 신청이 필요할 수 있습니다. 개인사업자 브랜드는 해당 신원 확인/PIN 절차를 사용해야 합니다. 이 엔드포인트를 그 절차의 대체 수단으로 사용하지 마세요.
별도 요금 확인하기
현재 설정된 운영 환경의 재인증 요금은 접수된 확인 신청 건당 US$5.00입니다(시월 24일, 2026년 확인). 최초 등록한 사업체의 등록 요금이 다른 경우에도 표준 브랜드 요금이 적용됩니다. 구매 기능이 활성화되어 있어야 하며, 선불 계정은 신청 전에 잔액이 충분해야 합니다.
202 응답은 추가 처리를 위해 요청이 접수되었음을 의미하며, 접수 시점에 과금 처리가 전달됩니다. 사업자의 신원 확인이 완료되었다는 의미는 아닙니다. 나중에 새로 확인을 신청하면 추가 요금이 발생할 수 있습니다. 확인이 계속 대기 중이라는 이유만으로 새 확인을 신청하지 마세요.
의도한 확인을 한 번만 신청하기
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request PUT \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/revet"이미 저장된 브랜드 정보를 확인하므로 프로필을 담은 요청 본문은 필요하지 않습니다. 의도한 확인 신청에 고유한 멱등성 키를 사용하고, 재시도할 때 메서드, 경로, 쿼리 및 본문을 정확히 동일하게 유지하세요. 키에는 공백 없이 출력 가능한 ASCII 문자 1–128개를 사용할 수 있습니다. 진행 중인 신청과 중복되면 Retry-After와 함께 409가 반환될 수 있습니다. 완료된 신청은 오류를 포함하여 저장된 결과를 다시 반환할 수 있습니다.
공개 API는 활성화된 토큰 계정의 Bearer 인증도 허용합니다. 계정 소유 관계와 허용된 출발지 IP에 대한 확인은 계속 적용됩니다. 저장된 모의 브랜드는 이 운영 환경 과금 절차를 건너뛰지만, 샌드박스 결과는 운영 환경의 신원 확인이 아닙니다.
결과를 확인하고 상태에 따라 조치하기
| 응답 | 의미 및 다음 조치 |
|---|---|
| 200 | 요청이 성공했습니다. 반환된 브랜드를 살펴보고 현재 브랜드 기록을 다시 조회하여 신원 확인 상태를 확인하세요. |
| 202 | 요청이 접수되었으며 추가 확인을 기다리고 있습니다. 브랜드 ID를 보관하고, 유료 확인을 다시 신청하지 말고 나중에 현재 상태를 확인하세요. |
| 400 | 반환된 등록 기관 오류를 검토하세요. 최초 등록이 대기 중이거나, 프로필이 변경되지 않았거나, 다른 유효성 검사 규칙이 적용되었을 수 있습니다. |
| 401 / 404 | 인증 정보와 허용된 IP 또는 계정에 속한 브랜드 ID를 확인하세요. |
| 402 / 503 | 로컬 측의 구매/충전 또는 요금 설정/서비스 오류를 검토하세요. 503이 반환되었다고 해서 상위 시스템으로 요청이 전송되지 않았다고 단정하지 마세요. |
| 429 | Retry-After를 따르고 확인 신청의 세부 내용을 동일하게 유지하세요. |
프록시는 변경 요청이 접수된 후 로컬 브랜드 기록을 새로 고치지만, 이 갱신 자체가 최종 확인 결과를 입증하지는 않습니다. 사업자는 미확인 또는 대기 상태로 남을 수 있습니다. 캠페인 설정을 계속하기 전에 HTTP 요청 접수 여부만으로 판단하지 말고 현재 브랜드 상태를 확인하세요.
결과가 불확실할 때 상태 확인하기
전송 실패로 인해 캐시된 502가 반환될 수 있습니다. 상위 시스템에서 요청이 접수된 후 로컬 영구 저장 또는 과금에 실패하면 requestId가 포함된 500이 캐시되어 반환될 수 있습니다. 해당 식별자를 보관하고 지원팀과 함께 현재 브랜드 및 과금 상태를 대조하세요. 다른 키를 생성하면 별도 요금이 부과되는 확인 신청이 만들어질 수 있습니다. 상황을 확인하지 않은 채 새 키로 재시도하지 마세요.
고객 포털 사용하기
포털에서는 현재 프로필과 요금을 검토한 후 UNVERIFIED 상태인 운영 환경의 조직 브랜드에 대해 재인증을 신청할 수 있습니다. 포털은 프로필과 요금이 변경되지 않았는지 확인하며, 현재와 동일한 정보로 이미 접수된 신청이 있으면 추가 신청을 거부합니다. 샌드박스 브랜드와 개인사업자 브랜드는 이 포털 작업의 대상에서 제외됩니다.
이러한 포털 보호 장치는 작업 절차에 추가된 확인 단계입니다. API를 직접 사용하는 클라이언트는 자체 검토를 수행해야 하며, API에서도 포털의 버전 필드나 요금 확인 필드가 필수라고 가정해서는 안 됩니다. 일반적인 브랜드 정보 수정 내용을 저장하는 것은 별도의 작업이며 재인증을 자동으로 신청하지 않습니다.