Mise en œuvre d'une intégration Batch

Le traitement des opérations par Batch peut échouer en raison d'une défaillance des communications ou des systèmes due à l'une des erreurs suivantes :

• Une erreur due à une défaillance interne du système s'est produite.
• Une erreur s'est produite car les ressources du serveur étaient insuffisantes pour traiter la demande à ce moment-là.
• Une erreur s'est produite lors du traitement d'une transaction de vérification de Tokenization

Lorsque cela se produit et qu'il est possible de relancer une opération, Batch tente d'envoyer celle-ci pour traitement jusqu'à la réception d'une réponse ne pouvant pas faire l'objet d'une nouvelle tentative ou jusqu'à ce que la limite des tentatives soit atteinte.

Batch stocke les noms de batch et leur code d'intégrité du message (MIC) correspondant que vous avez chargés. Les batches portant un nom de batch précédemment soumis mais avec un contenu différent peuvent être identifiés et seront rejetés par Batch.

Il est également possible d'identifier les batches de nom et de contenu identiques soumis précédemment. Batch renvoie le même statut que pour le batch chargé précédemment. Ainsi, si le commerçant pense qu'il existe un problème de transmission, il peut vérifier que le batch a été chargé correctement vers Batch.

Les valeurs de la ligne d'en-tête d'une demande de batch soumise pour traitement ne peuvent contenir que des caractères figurant dans les noms de champ NVP API. Les caractères suivants sont autorisés :

• Les caractères alphanumériques (a-z, A-Z, 0-9)
• Le point (.)
• Les crochets ([ ])

Le service Batch ne garantit pas qu'il traitera les opérations dans le même ordre que celui spécifié dans le fichier de batch, le répartiteur Batch pouvant traiter les opérations en parallèle. Ce comportement peut également être attribué à la fonction de nouvel essai, c'est-à-dire que si certaines opérations d'un fichier de batch nécessitent un nouvel essai, les opérations qui sont prêtes seront traitées en premier, quel que soit l'ordre dans lequel elles sont spécifiées. Par exemple, même si des opérations ultérieures sont spécifiées après des opérations initiales [opération Capture (Collecter) suivie d'une opération Authorization (Autorisation), opération Void (Annuler) suivie d'une opération Pay (Payer)], l'opération Capture (Collecter) peut être effectuée avant l'opération opération Authorization (Autorisation) ou l'opération Void (Annuler) avant l'opération Pay (Payer).

Par conséquent, pour les opérations qui doivent suivre strictement un ordre donné, il est recommandé d'exécuter d'abord le batch d'opérations initial, d'attendre le fichier de réponse du batch et, en cas de succès, d'exécuter le batch d'opérations suivant.

La Tokenization stocke les détails des cartes dans un jeton. Pour utiliser Tokenization avec Batch, vous devez utiliser l'identifiant de jeton dans le fichier de batch, comme indiqué ci-dessous.

apiOperation,cardDetails.card.number,cardDetails.card.expiry.month,cardDetails.card.expiry.year,cardDetails.card.securityCode,cardDetails.cardToken,transaction.amount,transaction.currency,transaction.id,transaction.authorizationCode,order.id,card.start.month,card.start.year,card.issueNumber,card.bankAccountType
AUTHORIZE,,,,,200,10,AUD,TXID1,,10323711802,,,,
AUTHORIZE,,,,,300,20,AUD,TXID1,,10323711803,,,,
AUTHORIZE,,,,,400,10,AUD,TXID1,,10323711804,,,,
AUTHORIZE,,,,,500,5.99,AUD,TXID1,,10323711805,,,,     

Les informations d'identification de l'opération incluent l'identifiant du commerçant et le mot de passe. Pour chaque opération d'un batch, les informations d'indentification d'opération utilisent par défaut les informations d'identification d'authentification fournies dans l'en-tête de la demande de batch (identifiant et mot de passe du commerçant). Toutefois, si vous spécifiez des valeurs pour ces deux champs dans les lignes d'enregistrement d'opération, l'authentification de l'opération utilisera les informations d'identification au niveau de l'opération, et non les informations d'identification par défaut du batch chargé.

Oui, vous pouvez traiter plusieurs types d'opérations dans un seul fichier de batch à condition qu'elles ne soient PAS liées à la même commande, c'est-à-dire qu'elles ne contiennent pas le même identifiant de commande. Le service Batch ne garantit pas qu'il traitera les opérations dans le même ordre que celui spécifié dans le fichier de batch, le répartiteur Batch pouvant traiter les opérations en parallèle. Ce comportement peut également être attribué à la fonction de nouvel essai, c'est-à-dire que si certaines opérations d'un fichier de batch nécessitent un nouvel essai, les opérations qui sont prêtes seront traitées en premier, quel que soit l'ordre dans lequel elles sont spécifiées. Par exemple, si des opérations Pay (Payer) et Void (Annuler) figurent dans le même fichier de batch, l'opération Void (Annuler) peut être effectuée avant l'opération Pay (Payer). Toutefois, si les opérations ne sont PAS liées à la même commande (c.-à-d. si elles contiennent des identificateurs de commande différents), vous pouvez placer plusieurs types d'opérations dans un même fichier de batch.

Oui, vous pouvez utiliser des sources multiples de détails de cartes dans un seul fichier de batch, à l'exception de l'identifiant de session de paiement. Pour plus d'informations sur les sources multiples, voir Sources multiples de détails de cartes.

Les opérations Authorize (Autoriser) de l'exemple ci-dessous utilisent des jetons au lieu des détails de la carte.

apiOperation,order.id,transaction.id,transaction.amount,transaction.currency,cardDetails.card.number,cardDetails.card.expiry.month,cardDetails.card.expiry.year,card.number,cardDetails.cardToken,result,error.cause,error.explanation,response.gatewayCode
PAY,921830104167,TXID1,30,AUD,5123456789012346,05,13,,,,,,
PAY,921830104168,TXID1,50,AUD,5123456789012346,05,13,,,,,,
PAY,921830104169,TXID1,100,AUD,4987654321098769,05,13,,,,,,
AUTHORIZE,10072028281,TXID1,,,,,,,200,,,,,
AUTHORIZE,10072028282,TXID1,,,,,,,300,,,,,
AUTHORIZE,10072028283,TXID1,,,,,,,400,,,,,