Introduction

KartaPay est une passerelle de paiement qui permet aux marchands d'accepter des paiements de la part de leurs clients via des fournisseurs de paiement locaux (Holo, MVola, et d'autres) sans avoir à intégrer chaque fournisseur directement.

Déroulement d'un paiement

1. Un client sélectionne KartaPay comme moyen de paiement dans votre application.
2. Votre backend crée un paiement via l'API KartaPay et reçoit une submitUrl.
3. Vous redirigez le navigateur du client vers submitUrl — la page de paiement KartaPay.
4. Le client choisit un fournisseur (par ex. MVola) et effectue le paiement sur la page d'approbation propre au fournisseur.
5. KartaPay redirige le client vers votre successUrl (ou cancelUrl en cas d'annulation) et envoie un webhook à votre backend une fois le paiement confirmé.

Termes clés

Terme	Signification
Tableau de bord (Dashboard)	L'interface web KartaPay où vous gérez votre compte marchand (voir Aperçu du dashboard)
Marchand	Votre compte professionnel dans KartaPay
clientId	Un identifiant de rapprochement que vous générez pour faire correspondre un paiement KartaPay à votre propre commande/enregistrement
submitUrl	L'URL de paiement KartaPay vers laquelle vous redirigez le client après la création d'un paiement
successUrl / cancelUrl	URLs sur votre propre site vers lesquelles KartaPay redirige le client après approbation/annulation
Webhook	Une requête HTTP POST que KartaPay envoie à votre serveur lorsque le statut d'un paiement change

Étape suivante

Créez un compte marchand pour commencer, ou passez directement au guide développeur si vous avez déjà un compte.