Location

merchant.location dit où se trouve le point de vente reconnu, quand Noryo le sait. La clé est toujours présente dès que merchant est un objet : soit un objet, soit null.

Les formes possibles

"location": { "city": "PARIS", "postal_code": "75018" }
"location": { "city": "MULHOUSE" }
"location": null

Un objet porte au moins l'un des deux champs : Noryo ne rend jamais d'objet vide, qui ferait croire à une adresse connue mais illisible. Sans ville ni code postal, location vaut null.

Pourquoi null plutôt qu'absente

Absent et inconnu se ressemblent trop pour qu'on vous demande de les distinguer. Avec une clé toujours présente, un seul test suffit :

const loc = body.merchant?.location ?? null;
if (loc === null) {
  // localisation inconnue
} else {
  const city = loc.city ?? null;          // peut manquer
  const postalCode = loc.postal_code ?? null;
}

Ce que location n'est pas

• Ce n'est pas votre country. Le country de la requête entre dans l'identité économique, mais il n'est jamais recopié dans location : présenter une entrée du client comme une donnée résolue par Noryo serait trompeur. Il ne filtre pas non plus la résolution. Voir Lire une réponse.
• Ce n'est pas une adresse complète. Seuls city et postal_code sont publics ; aucun autre champ (coordonnées, rue, identifiant d'établissement) n'en sort.
• Ce n'est pas une condition de resolved. La politique de résolution en vigueur n'exige pas de localisation : un résultat resolved peut avoir location: null. Une politique qui l'exigerait rendrait partial avec la raison location_required.

Les valeurs

Les valeurs sont rendues telles que le catalogue de Noryo les connaît, par exemple une ville en majuscules (PARIS). Appliquez votre propre mise en forme à l'affichage.