Guides
Log In
Guides

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

ElementTypeDescriptionSizeRequis
apiVersionStringNuméro de version de l’APIV20Requis
actionString"POST_PROCESSING"V30Requis
transactionTypeStringTransaction que le terminal est en train d’effectuer.
Valeurs valides :
  • "PURCHASE"
  • "PRE_AUTHORIZATION"
  • "PRE_AUTHORIZATION_COMPLETION"
  • "REFUND"
  • "INDEPENDENT_REFUND"
  • "VOID"
F8Requis
requestDateTimeStringDate 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.
F20Requis
languageStringLangue 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.
V30Requis
correlationIdStringPermet de corréler une série de requêtes au sein d’un même flux.V50Requis
terminalIdStringIdentifiant du terminal.F8Requis
merchantIdStringIdentifiant du marchand.V13Requis
merchantNameStringNom du marchand.V100Requis
merchantAddressObjectAdresse du marchand.Requis
unitNumberStringNuméro d’unité.V19Optionnel
streetNumberStringNuméro de rue.V19Optionnel
streetNameStringNom complet de la rue.V100Optionnel
provinceStringCode ISO 3166‑2 de la province ou de l’état.V3Optionnel
cityStringNom de la ville / localité.V100Optionnel
postalCodeStringCode postal.V30Optionnel
countryStringCode pays conformément à iso-3166-1-alpha-2V2Optionnel
receiptStringDonnées du reçu financier envoyées en utilisant l’encodage ISO‑8895‑1.V4000Conditionnel
transactionAmountObjectMontant du paiement reçu / approuvé.V10Conditionnel
amountStringLa valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059.V10Requis
currencyStringCode de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4Requis
authorizedAmountObjectMontant du paiement reçu / approuvé.V10Conditionnel
amountStringLa valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059.V10Requis
currencyStringCode de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4Requis
remainingAmountObjectMontant restant dû.V10Optionnel
amountStringLa valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059.V10Requis
currencyStringCode de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4Requis
amountDetailsObjectDétail de la ventilation des montants.Optionnel
tipAmountObjectMontant du pourboire de la transaction.Optionnel
amountStringLa valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059.V10Requis
currencyStringCode de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4Requis
subtotalAmountObjectMontant du sous‑total (avant taxes).
amountStringLa valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059.V10Requis
currencyStringCode de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4Requis
taxesArrayMaximum de 5 objets de taxe.
taxNameStringNom à afficher sur le reçu (hst, gst, etc.).V15
taxAmountObjectMontant correspondant.
amountStringLa valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059.V10Requis
currencyStringCode de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4Requis
cashbackAmountObjectMontant du retrait d’argent.V10Conditionnel
amountStringLa valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059.V10Requis
currencyStringCode de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4Requis
surchargeAmountObjectMontant de la surcharge appliquée à la transaction.V10Conditionnel
amountStringLa valeur doit être exprimée en cents. Par conséquent, 10,59 $ doit être envoyé sous la forme 1059.V10Requis
currencyStringCode de devise à trois lettres conformément à la norme ISO 4217.

Pour obtenir la liste complète des codes de devises, veuillez visiter : ISO 4217
V4Requis
paymentMethodObjectObjet de réponse du moyen de paiement.Conditionnel
paymentMethodInformationObjectDétails concernant la carte utilisée dans le moyen de paiement.Conditionnel
paymentAccountReferenceStringUtilisé 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 liaisonV29Conditionnel
cardInformationObjectInformations concernant la carte utilisée pour la transaction.Conditionnel
bankIdentificationNumberStringBIN: 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.
V8Conditionnel
lastFourStringQuatre derniers chiffres de la carte.F4Conditionnel
cardBrandStringAffiche 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"
V50Conditionnel
cardTypeStringCard type:

“CREDIT“

“DEBIT“

"GIFT"
V50Conditionnel
cardFingerprintStringIdentifiant 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é)
V255Conditionnel
issuerStringÉmetteur de la carte.V100Conditionnel
transactionDetailsObjectDétails supplémentaires concernant le résultat de la transaction.Conditionnel
transactionUniqueIdStringIdentifiant de transaction en temps réel provenant de l’hôte.F15Conditionnel
isoResponseCodeStringCode de réponse ISO.V2Conditionnel
response CodeStringCode de réponse de l’hôte Moneris.V3Conditionnel
sequenceNumberStringNuméro de séquence.V18Conditionnel
authorizationCodeStringCode d’autorisation retourné par l’institution émettrice.V8Conditionnel

{
  "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

ElementTypeDescriptionSizeRequis
apiVersionStringNuméro de version de l’APIV20Requis
correlationIdStringÉcho de la requêteV50Requis
responseDateTimeStringDate 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.
F20Requis
actionString"POST_PROCESSING"V50Requis
status*StringCode d'état HTTP de la requête de transaction.F3Requis
receipt**ObjectObjet JSONConditionnel
line1StringLigne 1 de l’insertion de reçu pour le message de l’application tierceV60Optionnel
line2StringLigne 2 de l’insertion de reçu pour le message de l’application tierceV60Optionnel
line3StringLigne 3 de l’insertion de reçu pour le message de l’application tierceV60Optionnel

{
  "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.