# Simiz

> Simiz est une infrastructure d'orchestration de paiements non-custodiale pour l'Afrique francophone. Simiz ne garde pas les fonds — les partenaires licenciés exécutent.

## Docs pour assistants IA

- [Intégration Provider](https://docs.simiz.dev/providers/integration): Construire son canal agent (webhook + SFTP/CSV), signature HMAC-SHA256, idempotence, anti-rejeu, erreurs typées, console de test, conformance suite.
- [OpenAPI Agent](https://docs.simiz.dev/openapi/agent-api.yaml): Spécification OpenAPI du canal agent provider→Simiz.
- [Product Overview](https://docs.simiz.dev/product-overview): SSOT produit — ce qu'est Simiz, à qui, comment (non-custodial, 3 piliers Pay/Verify/Trust).
- [Solutions Assurances](https://simiz.dev/solutions/assurances): Collecte primes Mobile Money + indemnisations, réconciliation par police.

## Principes d'intégration

1. **Non-custodial** : aucun fonds ne transite par Simiz. Le provider exécute.
2. **Signature obligatoire** : HMAC-SHA256 du body avec signingSecret, en-tête `X-Simiz-Signature`.
3. **Idempotence** : déduite de `transaction_ref` + `provider_transaction_id`. Renvoi = duplicate (409), sûr.
4. **Anti-rejeu** : timestamp < 5 min, sinon rejet.
5. **Erreurs typées** : 400 schéma, 401 clé, 403 signature, 409 duplicate, 422 statut inconnu.

## Quickstart

```bash
curl -X POST https://api.simiz.dev/provider/webhook/{PROVIDER_ID} \
  -H "Content-Type: application/json" \
  -H "X-Simiz-Api-Key: {API_KEY}" \
  -H "X-Simiz-Signature: {HMAC_SHA256_OF_BODY}" \
  -d '{"event":"payment.confirmed","transaction_ref":"tx_001","provider_transaction_id":"P-001","amount":15000,"currency":"XAF","status":"COMPLETED","fee":75,"timestamp":"2026-07-05T12:00:00Z"}'
```

## Optional

- [Console de test](https://docs.simiz.dev/providers/test-console): Valider son canal sans intervention Simiz.
- [Conformance suite](https://docs.simiz.dev/providers/conformance): 6 scénarios exécutables.
- [Client de référence](https://docs.simiz.dev/providers/reference-client): Client TypeScript miroir du standard.