Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Vous avez un compte Kiwiz pour votre solution de facturation et vous avez la nécessite nécessité de gérer des sous comptes pour vos clients ? Le mode revendeur est fait pour vous !

Grace Grâce au mode revendeur, votre compte principal vous permet au travers de notre API de créer et de supprimer des comptes Kiwiz. Lors de la création des sous comptecomptes, vous avez la possibilité de choisir parmi les différents plans revendeurs mis à votre disposition.

Note

Chacun de vos clients doit avoir son propre compte. Si votre client a plusieurs systèmes de caisse, il vous faudra un abonnement par caisse.

Lors de la création de votre compte revendeur vous recevrez vos identifiants API ainsi qu'un subscription ID à ne pas utiliser. En effet il ne faut pas envoyer des factures dans le compte revendeur car elle seront détruites.

Compte principal

Grace aux identifiants login et mot de passe de votre compte principal vous générez un token disposant des droits revendeurs https://api.kiwiz.io/doc#/Tokens/authLogin

...

Warning

Il nous arrive parfois, pour des raisons techniques d'invalider des tokens. Dans ce cas, en cas d'appel, l'API Kiwiz vous répondra un code 401 vous demandant de générer un nouveau token

Schéma

...

général

Gestion des sous comptes

Création d'une souscription - https://api.kiwiz.io/doc#/Souscriptions/subscriptionAdd

Pour chaque abonnement client vous devez fournir les informations suivantes :

...

Les autres champs platform et version vous permettent de pousser des infos technique techniques pour vos besoins personnels.

...

Nous vous conseillons de stocker le token ansi ainsi que l'ID de souscription de chacun de vos clients.

Annuler une souscription - https://api.kiwiz.io/doc#/Souscriptions/subscriptionCancel

Vous avez la possibilité, au travers de l'API, d'annuler des souscriptions.

...

Warning

Il est impossible de réactiver une souscription annulée.

Seule les souscription souscriptions devant être annulées à la fin de leur période de validité peuvent être réactivées : https://api.kiwiz.io/doc#/Souscriptions/subscriptionReactivate

...