Post‑traitement

Vue d'ensemble

Ce hook est activé après le traitement de la requête financière, mais avant le traitement du reçu. Seules les réponses approuvées déclencheront un appel à ce hook.


Requête de post‑traitement

Element Type Description Size Requis
apiVersion String Numéro de version de l’API V20 Requis
action String "POST\_PROCESSING" V30 Requis
transactionType String Transaction que le terminal est en train d’effectuer.
Valeurs valides :
  • "PURCHASE"
  • "PRE\_AUTHORIZATION"
  • "PRE\_AUTHORIZATION\_COMPLETION"
  • "REFUND"
  • "INDEPENDENT\_REFUND"
  • "VOID"
F8 Requis
requestDateTime String Date et heure de la requête (YYYY‑MM‑DDTHH:MM:SSZ).

Le format est basé sur le profil Internet standard de RFC 3339 — un sous‑ensemble de ISO 8601.
F20 Requis
language String Langue du terminal. Fournit le code de langue à deux lettres conformément à la norme ISO 639‑1.

Pour obtenir la liste complète des codes de langue, veuillez visiter: [https://en.wikipedia.org/wiki/List\_of\_ISO\_639-1\_codes](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes).
V30 Requis
correlationId String Permet de corréler une série de requêtes au sein d’un même flux. V50 Requis
terminalId String Identifiant du terminal. F8 Requis
merchantId String Identifiant du marchand. V13 Requis
merchantName String Nom du marchand. V100 Requis
merchantAddress Object Adresse du marchand. Requis
unitNumber String Numéro d’unité. V19 Optionnel
streetNumber String Numéro de rue. V19 Optionnel
streetName String Nom complet de la rue. V100 Optionnel
province String Code ISO 3166‑2 de la province ou de l’état. V3 Optionnel
city String Nom de la ville / localité. V100 Optionnel
postalCode String Code postal. V30 Optionnel
country String Code pays conformément à iso-3166-1-alpha-2 V2 Optionnel
receipt String Données du reçu financier envoyées en utilisant l’encodage ISO‑8895‑1. V4000 Conditionnel
transactionAmount Object Montant du paiement reçu / approuvé. V10 Conditionnel
amount String La valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059. V10 Requis
currency String Code de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4 Requis
authorizedAmount Object Montant du paiement reçu / approuvé. V10 Conditionnel
amount String La valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059. V10 Requis
currency String Code de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4 Requis
remainingAmount Object Montant restant dû. V10 Optionnel
amount String La valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059. V10 Requis
currency String Code de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4 Requis
amountDetails Object Détail de la ventilation des montants. Optionnel
tipAmount Object Montant du pourboire de la transaction. Optionnel
amount String La valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059. V10 Requis
currency String Code de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4 Requis
subtotalAmount Object Montant du sous‑total (avant taxes).
amount String La valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059. V10 Requis
currency String Code de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4 Requis
taxes Array Maximum de 5 objets de taxe.
taxName String Nom à afficher sur le reçu (hst, gst, etc.). V15
taxAmount Object Montant correspondant.
amount String La valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059. V10 Requis
currency String Code de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4 Requis
cashbackAmount Object Montant du retrait d’argent. V10 Conditionnel
amount String La valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059. V10 Requis
currency String Code de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4 Requis
surchargeAmount Object Montant de la surcharge appliquée à la transaction. V10 Conditionnel
amount String La valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059. V10 Requis
currency String Code de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4 Requis
paymentMethod Object Objet de réponse du moyen de paiement. Conditionnel
paymentMethodInformation Object Détails concernant la carte utilisée dans le moyen de paiement. Conditionnel
paymentAccountReference String Utilisé pour lier les transactions basées sur le numéro de compte principal (PAN) et les transactions sur des jetons de paiement associés sans utiliser le PAN comme mécanisme de liaison V29 Conditionnel
cardInformation Object Informations concernant la carte utilisée pour la transaction. Conditionnel
bankIdentificationNumber String BIN: numéro d'identification bancaire

Correspond aux six à huit premiers chiffres du numéro de compte principal (PAN) et identifie le réseau de paiement ainsi que l’institution émettrice.
V8 Conditionnel
lastFour String Quatre derniers chiffres de la carte. F4 Conditionnel
cardBrand String Affiche le nom de la marque de carte associée au type de carte..

“VISA“

“MASTERCARD“

“AMERICAN\_EXPRESS“

“INTERAC“

“JCB“

"DISCOVER"

"UNIONPAY"

"GIFT MONERIS"

"GIFT DATACANDY"

"GIFT GIVEX"
V50 Conditionnel
cardType String Card type:

“CREDIT“

“DEBIT“

"GIFT"
V50 Conditionnel
cardFingerprint String Identifiant unique de la carte.

L’empreinte de carte attribue de manière aléatoire des identifiants aux cartes partageant le même PAN afin d’identifier facilement lorsque plusieurs moyens de paiement sont associés à la même carte sous‑jacente et d’aider les commerçants à identifier les clients sur plusieurs canaux (ex. programmes de fidélité)
V255 Conditionnel
issuer String Émetteur de la carte. V100 Conditionnel
transactionDetails Object Détails supplémentaires concernant le résultat de la transaction. Conditionnel
transactionUniqueId String Identifiant de transaction en temps réel provenant de l’hôte. F15 Conditionnel
isoResponseCode String Code de réponse ISO. V2 Conditionnel
response Code String Code de réponse de l’hôte Moneris. V3 Conditionnel
sequenceNumber String Numéro de séquence. V18 Conditionnel
authorizationCode String Code d’autorisation retourné par l’institution émettrice. V8 Conditionnel

{
  "apiVersion": "2025-01-09",
  "correlationId": "example_correlationId",
  "requestDateTime": "2025-12-31T23:59:60Z",
  "merchantId": "example_merchantId",
  "merchantName": "example_merchantName",
  "merchantAddress": {
    "unitNumber": "1A",
    "streetNumber": "12",
    "streetName": "Yonge St",
    "province": "ON",
    "city": "Toronto",
    "postalCode": "M4W 3H7",
    "country": "CA"
  },
  "terminalId": "example_terminalId",
  "action": "POST_PROCESSING",
  "transactionAmount": {
    "amount": "16000",
    "currency": "CAD"
  },
  "authorizedAmount": {
    "amount": "16000",
    "currency": "CAD"
  },
  "remainingAmount": {
    "amount": "0",
    "currency": "CAD"
  },
  "amountDetails": {
    "subtotalAmount": {
      "amount": "10000",
      "currency": "CAD"
    },
    "tipAmount": {
      "amount": "1000",
      "currency": "CAD"
    },
    "taxes": [
      {
        "taxName": "HST",
        "taxAmount": {
          "amount": "500",
          "currency": "CAD"
        }
      },
      {
        "taxName": "GST",
        "taxAmount": {
          "amount": "500",
          "currency": "CAD"
        }
      }
    ],
    "cashbackAmount": {
      "amount": "16000",
      "currency": "CAD"
    },
    "surchargeAmount": {
      "amount": "0",
      "currency": "CAD"
    }
  },
  "paymentMethod": {
    "paymentMethodInformation": {
      "paymentAccountReference": "11112222333344445555666677778",
      "cardInformation": {
        "bankIdentificationNumber": "123456",
        "lastFour": "1234",
        "cardBrand": "MASTERCARD",
        "cardType": "CREDIT",
        "cardFingerprint": "1Q2W3E4r5t6rfwewerwewrrw",
        "issuer": "RBC"
      }
    }
  },
  "transactionDetails": {
    "transactionUniqueId": "938c2cc0dcc05f2b68c4287040cfcf71",
    "isoResponseCode": "00",
    "responseCode": "000",
    "message": "approved",
    "ecommerceIndicator": "AUTHENTICATED_ECOMMERCE"
  }
}

Réponse de post-traitement

Element Type Description Size Requis
apiVersion String Numéro de version de l’API V20 Requis
correlationId String Écho de la requête V50 Requis
responseDateTime String Date et heure de la réponse (YYYY‑MM‑DDTHH:MM:SSZ).

Le format est basé sur le profil Internet standard de RFC 3339 — un sous‑ensemble de ISO 8601.
F20 Requis
action String "POST\_PROCESSING" V50 Requis
status\* String Code d'état HTTP de la requête de transaction. F3 Requis
receipt\*\* Object Objet JSON Conditionnel
line1 String Ligne 1 de l’insertion de reçu pour le message de l’application tierce V60 Optionnel
line2 String Ligne 2 de l’insertion de reçu pour le message de l’application tierce V60 Optionnel
line3 String Ligne 3 de l’insertion de reçu pour le message de l’application tierce V60 Optionnel

{
  "apiVersion": "3.0",
  "correlationId": "example_correlationId",
  "responseDateTime": "2025-12-31T23:59:60Z",
  "action": "POST_PROCESSING",
  "status": "200",
  "receipt": {
    "line1": "\\2\\LAmount:\\2\\R$100.00",
    "line2": "\\2\\LPoints:\\2\\R200 pts",
    "line3": "\\2\\LBalance:\\2\\R1000 pts"
  }
}

REMARQUES:

  • L’objet reçu sera traité uniquement lorsque le champ statut “status” indique « 200 », traité avec « OK ».
  • Les lignes du reçu prennent en charge des descripteurs de formatage limités, chaque descripteur étant précédé de « \».
    • Tailles de police : 1, 2, 3. La taille de police 2 est la taille principale utilisée dans le corps du reçu financier.
    • Informations d’alignement : L – aligné à gauche, C – centré, R – aligné à droite.

Cette page vous a-t-elle aidé ?