Enregistrement

Vue d'ensemble

Les Applications tierces doivent s’enregistrer auprès du terminal afin de pouvoir envoyer et recevoir des messages avec l’application Moneris Go. L’application doit sélectionner le ou les hooks auxquels elle souhaite enregistrer son application, ainsi que le ou les types de transaction associés.

Requête d’enregistrement

Élément	Type	Description	Size	Requis
apiVersion	String	Numéro de version de l’API	V20	Requis
correlationId	String	Permet de corréler une série de requêtes au sein d’un même flux.	V50	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
action	String	"REGISTER"	V50	Requis
applicationData	Object	Données de l’application tierce
applicationName	String	Nom de l’application tierce	V50	Requis
applicationPackageName	String	Nom du package de l’application tierce. Ce champ doit être défini par l’application tierce à l’aide de BuildConfig.APPLICATION\_ID	V50	Requis
hookRegistrations	Array	Contient les données applicables à la requête de transaction
hookType	String	Liste des points d’intégration auxquels l’application tierce souhaite s’enregistrer. Valeurs valides : - `"PRE\_CARD\_ENTRY"` - `"POST\_PROCESSING"`
transactionTypes	Array	Liste des transactions auxquelles l’application tierce souhaite être associée. Valeurs valides : "PURCHASE" "PRE\_AUTHORIZATION" "PRE\_AUTHORIZATION\_COMPLETION" "REFUND" "INDEPENDENT\_REFUND" "VOID"

{
  "apiVersion": "2025-01-09",
  "correlationId": "example_correlationId",
  "requestDateTime": "2025-12-31T23:59:60Z",
  "action": "REGISTER",
  "applicationData": {
    "applicationName": "xyz loyalty",
    "applicationPackageName": "xyz.exe"
  },
  "hookRegistrations": [
    {
      "hookType": "PRE_CARD_ENTRY",
      "transactionTypes": [
        "PURCHASE",
        "PRE_AUTHORIZATION",
        "PRE_AUTHORIZATION_COMPLETION"
      ]
    },
    {
      "hookType": "POST_PROCESSING",
      "transactionTypes": [
        "PURCHASE",
        "REFUND"
      ]
    },
    {
      "hookType": "TRANSACTION_RESULTS",
      "transactionTypes": [
        "PURCHASE",
        "REFUND"
      ]
    }
  ]
}

Exemple de code :

Intent regIntent = new Intent(ACTION_REGISTRATION);
regIntent.setPackage(PACKAGE_MONERIS_PAYMENT);
regIntent.putExtra(EXTRA_JSON_REQUEST, msgRequest);
sendBroadcast(regIntent);

Où :

 private static final String PACKAGE_MONERIS_PAYMENT = "com.moneris.payment.cert";
 private static final String ACTION_REGISTRATION = "com.moneris.hooks.Registration";

et msgRequest est la requête d’ENREGISTREMENT au format JSON

Réponse d’enregistrement

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	"REGISTER"	V50	Requis
status	String	Code d'état HTTP de la requête de transaction.	F3	Requis

{
  "apiVersion": "2025-01-09",
  "correlationId": "example_correlationId",
  "responseDateTime": "2025-12-31T23:59:60Z",
  "action": "REGISTER",
  "status": "200"
}