API REST · Webhooks temps réel

Documentation API.

Tout ce qu'il faut pour intégrer Kalipay en moins de cinq minutes. SDKs, endpoints, webhooks, exemples.

Démarrage rapide

Trois étapes jusqu'au premier paiement.

De la création de compte au premier payment.succeeded : trois commandes suffisent. Aucune configuration serveur, aucun environnement à installer.

01 · Clé API →

Récupérer votre clé API

Connectez-vous au tableau de bord, ouvrez l'onglet Développeurs, copiez votre clé secrète sk_live_….

curl https://api.kalipay.com/v1/keys \
  -H "Authorization: Bearer sk_live_…"

02 · SDK →

Installer le SDK

Quatre langages disponibles. La version Node couvre 95 % des intégrations e-commerce.

npm install @kalipay/node
# ou
yarn add @kalipay/node

03 · Paiement →

Créer une transaction

Un PaymentIntent représente l'intention d'encaisser : montant, devise, client.

import Kalipay from "@kalipay/node";
const kp = new Kalipay(process.env.KALIPAY_KEY);

const intent = await kp.payments.create({
  amount: 4990,
  currency: "EUR",
  customer: "cus_8a2f1c"
});

Référence API

Six endpoints essentiels.

Toutes les ressources Kalipay suivent les conventions REST : verbes HTTP standard, JSON, codes d'erreur explicites. Versionning par préfixe /v1/.

POST /v1/payments Créer un paiement avec montant, devise et client associé.

GET /v1/payments/:id Récupérer le détail d'un paiement, son statut et son historique.

POST /v1/refunds Émettre un remboursement total ou partiel sur une transaction.

POST /v1/customers Créer un client réutilisable avec ses moyens de paiement.

GET /v1/transactions Lister les transactions filtrables par date, statut ou devise.

POST /v1/webhooks Enregistrer un endpoint webhook pour recevoir les événements.

SDKs officiels

Quatre langages maintenus.

Chaque SDK offre la même surface d'API : typages stricts, gestion automatique des retries idempotents, signature des webhooks intégrée. Sources ouvertes sur GitHub.

01 · JavaScript