# Démarrer

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 paiement](https://docs.payiz.app/page-de-paiement)** : Payiz dessine tout. Vous envoyez le lien, ou vous y renvoyez le client. (`payment_url`)
- **[Le widget](https://docs.payiz.app/widget)** : La fenêtre de Payiz, posée dans votre page. Le client ne la quitte pas. (`payiz.js`)
- **[Le paiement direct](https://docs.payiz.app/paiement-direct)** : Vous dessinez tout. Payiz lance la demande sur le téléphone et vous dit la suite. (`payer`)

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](https://docs.payiz.app/cles) : 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](https://docs.payiz.app/webhooks).

## Ce qui existe aujourd’hui

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