유효성 검사 로직 빌드

이 문서에서는 Address Validation API의 다양한 응답을 처리하는 주소 확인 시스템을 빌드하는 프로세스를 설명합니다. 이 도움말에서는 고객에게 추가 정보를 요청할 시점과 방법을 결정하기 위해 API 응답을 해석하는 방법을 설명합니다.

일반적으로 API 응답은 시스템에서 주소를 처리해야 하는 다음과 같은 방법을 결정합니다.

• handyman 수정: 주소에 심각한 문제가 있을 수 있습니다.
  고객에게 추가 정보를 요청하는 메시지를 표시해 보세요.
• domain_add 하위 부지 추가: 주소에 하위 부지가 누락되었을 수 있습니다.
  고객에게 아파트 동호수를 추가하라는 메시지를 표시하는 것이 좋습니다.
• edit 확인: 주소에 약간의 문제가 있을 수 있습니다.
  고객에게 주소가 올바른지 확인하도록 요청하는 것이 좋습니다.
• check 수락: 주소에 문제가 없을 수 있습니다.
  추가 메시지 없이 주소를 사용하는 경우 책임은 본인에게 있습니다.

키 용도

이 문서를 통해 시스템을 수정하여 API 응답을 가장 잘 분석하고 제공된 주소로 취할 다음 작업을 결정할 수 있습니다. 다음의 슈도코드는 가능한 흐름을 보여줍니다.

if (verdict.possibleNextAction == FIX)
    Prompt the user to fix the address.
else if (verdict.possibleNextAction == CONFIRM_ADD_SUBPREMISES)
    Prompt the user to add a unit number.
else if (verdict.possibleNextAction == CONFIRM)
    Confirm with the user that the address is correct.
else
    Continue with the address returned by the API.

정확한 로직은 상황에 따라 다릅니다. 자세한 내용은 유효성 검사 로직 맞춤설정을 참고하세요.

가능한 워크플로

아래 표에는 API 응답에 따라 고객에게 메시지를 표시하기 위해 구현할 수 있는 워크플로가 요약되어 있습니다.

유효성 검사 로직 맞춤설정

verdict.possibleNextAction 필드의 결과를 사용하여 시스템이 API 응답을 처리하는 방식을 결정할 수 있지만 비즈니스별 요구사항을 처리하는 등 맞춤 로직을 빌드하는 것도 고려해 볼 수 있습니다.

이 섹션의 목적은 고객에게 메시지를 표시할지 여부와 방법을 결정하기 위해 API 응답을 해석하는 맞춤 로직을 개발하는 방법을 보여주는 것입니다. 이 섹션에서는 맞춤설정에 고려해야 할 위험 수준 및 추가 API 응답 신호를 설명합니다.

하지만 verdict.possibleNextAction만을 사용하여 다음 단계를 결정하더라도 아래에 설명된 추가 신호를 통해 주소와 관련된 잠재적 문제에 관한 세부정보를 파악할 수 있습니다.

위험 허용 범위

시스템이 Address Validation API의 신호에 응답하는 방식을 설계할 때 다음 권장사항을 따르면 더 효과적인 응답 모델을 빌드하는 데 도움이 됩니다. 하지만 이는 권장사항일 뿐이므로 구현은 비즈니스 모델에 적합해야 합니다.

위험 회피 결제 흐름 예시

전송 실패의 위험을 줄이려면 고객에게 더 자주 메시지를 표시하도록 로직을 맞춤설정할 수 있습니다. 예를 들어 주요 목적 섹션에 설명된 로직을 사용하는 대신 다음 로직을 사용할 수 있습니다.

if (verdict.possibleNextAction == FIX or verdict.validationGranularity
== OTHER or verdict.validationGranularity == ROUTE)
  Prompt customer to fix their address.
else if (verdict.possibleNextAction == CONFIRM_ADD_SUBPREMISES)
  Prompt customer to add a unit number.
else if (verdict.possibleNextAction == CONFIRM or verdict.validationGranularity
== PREMISE_PROXIMITY or verdict.hasSpellCorrectedComponents or
verdict.hasReplacedComponents or verdict.hasInferredComponents)
  Prompt customer to confirm their address.
else
  Proceed with the returned address.

간편한 결제 흐름의 예

결제 흐름의 불편을 줄이려면 고객에게 메시지를 더 적게 표시하도록 로직을 맞춤설정할 수 있습니다. 예를 들어 주요 목적 섹션에 설명된 로직을 사용하는 대신 다음 로직을 사용할 수 있습니다.

if (verdict.possibleNextAction == FIX)
  Prompt customer to fix their address.
else if (verdict.hasReplacedComponents)
  Prompt customer to confirm their address.
else
  Proceed with the returned address.

FIX 신호

결과에서 해당 주소로 배송할 수 없음을 명확하게 나타내는 경우 주소를 수정합니다. 그러면 시스템에서 고객에게 필요한 정보를 제공하라는 메시지를 표시할 수 있으며, 이후 워크플로를 다시 실행하여 결과물 주소를 가져올 수 있습니다.

Address Validation API 응답의 다음 필드는 verdict.possibleNextAction 외에도 주소에 심각한 문제가 있는지, 그리고 어떤 문제가 있는지 확인하는 데 사용할 수 있습니다.

주소 수정 예

CONFIRM_ADD_SUBPREMISES 신호 (미국 주소만 해당)

Address Validation API 응답에서 주소에 하위 부지가 누락되었을 수 있다고 표시되면 고객에게 주소를 검토하고 아파트 동호수를 추가하도록 요청합니다. 이 경우 건물의 주소는 유효할 수 있지만, 결과 주소가 고객이 의도한 주소인지 더 확실히 확인해야 합니다.

Address Validation API 응답의 다음 필드는 verdict.possibleNextAction 외에도 주소에 하위 부속건물이 누락되었을 가능성이 있는지 확인하는 데 사용할 수 있습니다.

하위 부지 주소 예 추가

CONFIRM 신호

확인 결과 Address Validation API가 유효한 주소를 생성하기 위해 주소 구성요소를 추론했거나 변경했음을 나타내는 경우 주소를 확인합니다. 이 경우 발송할 주소가 있지만 결과 주소가 고객이 의도한 주소인지 더 확실히 확인하는 것이 좋습니다.

Address Validation API 응답의 다음 필드는 verdict.possibleNextAction 외에도 주소에 경미한 문제가 있는지, 그리고 어떤 문제가 있는지 확인하는 데 사용할 수 있습니다.

주소 확인 예

ACCEPT 신호

Address Validation API API 응답이 주소가 전송 가능하며 다운스트림 프로세스에서 추가 고객 상호작용 없이 사용할 수 있다는 높은 신뢰도를 제공하는 경우 주소를 수락할 수 있습니다.

Address Validation API 응답의 다음 필드는 verdict.possibleNextAction와 함께 사용하여 주소의 품질이 허용되는지 확인할 수 있습니다.

허용되는 주소 예