Activation

Ce contenu a été traduit par une intelligence artificielle. Si vous repérez une erreur, merci de nous le signaler pour nous aider à améliorer notre support. En cas de doute, la version originale en anglais fait foi.

L’activation est l’initialisation d’un nouveau terminal. À sa réception, un terminal contient les applications nécessaires mais ne possède pas encore la configuration commerçant spécifique (Merchant ID, Terminal ID et Clés de sécurité) indispensable pour traiter une transaction.

Le système de caisse (POS) peut déclencher cette première activation afin d’éviter une manipulation manuelle sur le terminal.

Charge utile et structure requises

La requête d'activation est une opération asynchrone (ASYNC) qui utilise la structure de message générique AdminRequest.

Requête d'activation (Activation Request)

En-tête (Header)

L'objet standard SaleToPOIRequest.MessageHeader, avec le champ MessageClass défini sur Service et MessageCategory sur Admin.

Corps (Body)

Le seul champ requis est la chaîne encodée en Base64 dans AdminRequest.ServiceIdentification. Cette chaîne contient la commande XML réelle transmise au noyau (kernel) du terminal.

Contenu décodé : La chaîne PFJlcXVlc3Q+CiAgICA8QWN0aW9uPkFjdGl2YXRpb248L0FjdGlvbj4KICAgIDxUaW1lb3V0PjUwMDA8L1RpbWVvdXQ+CjwvUmVxdWVzdD4K se décode en XML comme suit :

  • <Request>
        <Action>Activation</Action>
        <Timeout>5000</Timeout>
    </Request>
    
  • Objectif : Cela confirme que la requête déclenche l'action d'activation avec un délai d'attente (timeout) spécifié (5000 millisecondes dans cet exemple).

Activation request example JSON
{
  "MessageHeader": {
    "MessageClass": "Service",
    "MessageCategory": "Admin",
    "MessageType": "Request",
    "ServiceID": "823",
    "SaleID": "POS_01",
    "POIID": "POI_01"
  },
  "AdminRequest": {
    "ServiceIdentification": "PFJlcXVlc3Q+CiAgICA8QWN0aW9uPkFjdGl2YXRpb248L0FjdGlvbj4KICAgIDxUaW1lb3V0PjUwMDA8L1RpbWVvdXQ+CjwvUmVxdWVzdD4K"
  }
}

Review the full schema on the API specification page for required fields.

Activation request example XML
<?xml version="1.0" encoding="UTF-8"?>
<SaleToPOIRequest xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<MessageHeader MessageClass="Service" MessageCategory="Admin" MessageType="Request" ServiceID="823" SaleID="POS_01" POIID="POI_01"></MessageHeader>
	<AdminRequest>
		<ServiceIdentification>PFJlcXVlc3Q+CiAgICA8QWN0aW9uPkFjdGl2YXRpb248L0FjdGlvbj4KICAgIDxUaW1lb3V0PjUwMDA8L1RpbWVvdXQ+CjwvUmVxdWVzdD4K</ServiceIdentification>
	</AdminRequest>
</SaleToPOIRequest>

Review the full schema on the API specification page for required fields.