Documentation/Démarrer avec Payiz

Démarrer avec Payiz

Encaisser par mobile money, suivre l’argent, et être prévenu quand il arrive. Tout commence en mode test, sans un franc réel.

Encaisser en cinq minutes, sans écrire une ligne

Dans votre espace, Encaisser crée un lien de paiement : un montant, un motif, et l’adresse à envoyer au client par WhatsApp ou SMS. Il paie depuis son téléphone, et vous voyez le paiement arriver dans Paiements.

Choisir son intégration

Trois façons de brancher votre site ou votre logiciel. Elles créent le même paiement, avec les mêmes frais et les mêmes webhooks : ce qui change, c’est qui dessine l’écran.

La page de paiementPayiz dessine tout. Vous envoyez le lien, ou vous y renvoyez le client.payment_url Le widgetLa fenêtre de Payiz, posée dans votre page. Le client ne la quitte pas.payiz.js Le paiement directVous dessinez tout. Payiz lance la demande sur le téléphone et vous dit la suite.payer

La page de paiementPayiz dessine tout.Le widgetLa fenêtre de Payiz, dans votre page.Le paiement directVous dessinez tout ; le payeur valide sur son téléphone.

Un lien de l’espace suffit à la page de paiement et au widget sans serveur. Dès que votre serveur appelle Payiz, il lui faut une clé d’API : elle vit dans vos serveurs, jamais dans une page web ni une application mobile.

bash

curl https://api.payiz.app/v1/account \
  -H "Authorization: Bearer sk_test_votre_cle"

La réponse dit qui parle, dans quel mode, et ce que la clé peut faire. C’est le premier appel à réussir avant tout le reste.

json

{
  "object": "account",
  "id": "org_01j9x0mh3q8fvt2wd6kn",
  "name": "Boutique Adjoa",
  "country": "BEN",
  "currency": "XOF",
  "livemode": false,
  "key": {
    "permissions": {
      "paiement": [
        "lire",
        "creer",
        "rembourser"
      ],
      "lien": [
        "lire",
        "gerer"
      ],
      "retrait": [
        "lire",
        "demander"
      ],
      "espace": [
        "lire"
      ]
    }
  }
}

Être prévenu quand l’argent arrive

Plutôt que d’interroger Payiz en boucle, donnez-lui l’adresse de votre serveur : chaque paiement réussi, demande refusée, remboursement ou retrait vous est envoyé, signé. Recevoir les webhooks.

Ce qui existe aujourd’hui

Les clés, les webhooks, le journal des requêtes, l’API v1 — paiements et leurs demandes, moyens de paiement, remboursements, liens, solde, bénéficiaires et retraits, litiges et conversions —, la page de paiement, le widget, le paiement direct et les SDK Node et PHP sont en service. La suite s’annoncera dans le journal des changements, datée.

{ "object": "account", "id": "org_01j9x0mh3q8fvt2wd6kn", "name": "Boutique Adjoa", "country": "BEN", "currency": "XOF", "livemode": false, "key": { "permissions": { "paiement": [ "lire", "creer", "rembourser" ], "lien": [ "lire", "gerer" ], "retrait": [ "lire", "demander" ], "espace": [ "lire" ] } } }

Ce qui existe aujourd’hui