Identifiants
Divers identifiants sont utilisés pour rapprocher et suivre les transactions transitant par les systèmes de paiement. Ces identifiants sont utilisés dans le rapport de règlement de votre acquéreur pour vous aider à identifier chaque transaction.
Vous fournissez des identifiants lors de l'envoi de demandes à Mastercard Gateway. Idéalement, le même identifiant peut être utilisé dans tous les systèmes, c'est-à-dire le vôtre, la passerelle et votre acquéreur. Cependant, les différents systèmes ont des exigences différentes et une combinaison d'identifiants est souvent nécessaire. Chaque commande que vous créez peut avoir trois types d'identifiants différents :
Types d'identifiants
Chaque commande que vous créez peut avoir trois types d'identifiants différents :
- ID de commande : Il s'agit d'un identifiant obligatoire que vous devez définir lors de la première transaction de chaque commande. La valeur est fournie dans le champ orderID dans les corps des demandes et des réponses, ou dans le paramètre de la demande
orderID, en fonction de l'opération. La valeur doit être unique parmi toutes les commandes envoyées depuis votre compte de commerçant, car la passerelle l'utilise pour identifier une commande particulière que vous avez soumise. Pour plus de commodité, utilisez une clé naturelle de votre propre système commeorder ID, par exemple l'ID du panier d'achat ou le numéro de la facture. Cela facilite le suivi des commandes entre votre système et la passerelle. Comme la passerelle tente également d'utiliser l'ID de commande dans les messages de l'acquéreur lorsque cela est possible, les trois systèmes, c'est-à-dire le vôtre, la passerelle et votre banque, peuvent être liés par un identifiant commun. - Référence de la commande : Dans certains cas, les ID de commande que vous utilisez dans votre propre système ne peuvent pas être utilisés sur la passerelle, car ils ne répondent pas aux exigences de cette dernière. Par exemple, si votre système utilise une boucle pour les ID de commande, redémarre lorsqu'une limite supérieure définie est dépassée ou regroupe plusieurs offres sous une seule commande, l'ID de commande de votre système ne fonctionne pas comme un ID unique dans la passerelle. Dans ce cas, vous devez créer un nouvel
order IDunique à utiliser pour la passerelle. De plus, vous pouvez fournir une valeur facultative,order.reference, qui contient l'identifiant que vous utilisez dans votre propre système et vous permet de suivre les commandes entre votre système et la passerelle. - Identifiant de l'acquéreur : La passerelle devant transmettre un identifiant à l'acquéreur, elle tente d'utiliser votre
order ID. Toutefois, si cela ne convient pas à votre acquéreur, la passerelle transforme la valeur en quelque chose qui correspond aux exigences de l'acquéreur en matière de longueur de champ et de format. Si vous souhaitez contrôler la valeur que la passerelle fournit à l'acquéreur, vous pouvez indiquer une valeur transaction.acquirer.transactionId dans la demande. Cependant, si cette valeur ne correspond pas aux exigences de l'acquéreur, la passerelle la transforme également avant de l'envoyer. Dans les deux cas, vous pouvez trouver l'identifiant que la passerelle a effectivement envoyé à l'acquéreur dans le champ transaction.acquirer.transactionId de la réponse à la demande. Si la passerelle a dû transformer l'identifiant, stockez la valeur de la réponse pour pouvoir faire correspondre les détails de paiement de l'acquéreur aux commandes dans votre système.
Transactions
Pour identifier les transactions individuelles au sein d'une commande, la passerelle utilise des ID de transaction. La valeur est fournie dans le champ transaction.id dans les corps des demandes et des réponses, ou dans le paramètre de la demande transactionID pour des opérations spécifiques. Si votre système suit les transactions à l'aide d'un identifiant unique, utilisez-le. Sinon, utilisez n'importe quel numéro séquentiel ou aléatoire, à condition qu'il soit unique pour chaque transaction au sein de la même commande.
Pour identifier la transaction chez l'acquéreur de paiement, utilisez le reçu. Cette valeur est renvoyée dans le champ transaction.receipt de la réponse à la demande ; cependant, cette valeur peut ne pas être unique.