Demandes de paiement
Envoyez des demandes de paiement aux clients avec une date d’expiration.
L’API Payment requests permet de créer des demandes de paiement limitées dans le temps. Utile pour la facturation et le B2B.
Créer une demande de paiement
Référence API (schéma complet) : Créer une demande de paiement
L’essentiel : amount, currency_code et expiry_date (ISO 8601) sont obligatoires. Passez optionnellement customer_id, payment_reference, description et metadata. La réponse inclut un payment_url pour le client.
import { LomiSDK } from '@lomi./sdk';
const lomi = new LomiSDK({
apiKey: process.env.LOMI_SECRET_KEY!,
environment: 'live',
});
const request = await lomi.paymentRequests.create({
amount: 50000,
currency_code: 'XOF',
expiry_date: '2024-02-15T23:59:59Z',
description: 'Facture n° INV-2024-001',
customer_id: 'cus_abc123...',
payment_reference: 'INV-2024-001',
metadata: {
invoice_id: 'INV-2024-001',
},
});
console.log(`Payment request created: ${request.id}`);
console.log(`Payment URL: ${request.payment_url}`);from lomi import LomiClient
import os
client = LomiClient(
api_key=os.environ["LOMI_SECRET_KEY"],
environment="test"
)
request = client.payment_requests.create({
"amount": 50000,
"currency_code": "XOF",
"expiry_date": "2024-02-15T23:59:59Z",
"description": "Facture n° INV-2024-001",
"customer_id": "cus_abc123...",
"payment_reference": "INV-2024-001"
})
print(f"Payment request: {request['id']}")curl -X POST "https://api.lomi.africa/payment-requests" \
-H "X-API-KEY: $LOMI_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 50000,
"currency_code": "XOF",
"expiry_date": "2024-02-15T23:59:59Z",
"description": "Facture n° INV-2024-001",
"customer_id": "cus_abc123...",
"payment_reference": "INV-2024-001"
}'Lister les demandes de paiement
Référence API : Lister les demandes, filtrez par status, customerId, limit et offset.
const requests = await lomi.paymentRequests.list({
status: 'pending',
limit: 20,
});requests = client.payment_requests.list(status="pending", limit=20)curl -X GET "https://api.lomi.africa/payment-requests?status=pending&limit=20" \
-H "X-API-KEY: $LOMI_SECRET_KEY"Obtenir une demande de paiement
Référence API : Obtenir une demande
const request = await lomi.paymentRequests.get('pr_abc123...');
console.log(`Status: ${request.status}`);request = client.payment_requests.get('pr_abc123...')curl -X GET "https://api.lomi.africa/payment-requests/pr_abc123..." \
-H "X-API-KEY: $LOMI_SECRET_KEY"Webhooks
| Événement | Description |
|---|---|
payment_request.completed | Paiement reçu |
payment_request.expired | Demande expirée sans paiement |
API associée
Comment fonctionnent les liens de paiement ?
Créez des URLs de paiement réutilisables ou ponctuelles à partager par email, chat, facture, QR code ou réseaux sociaux.
Comment accepter le mobile money ?
Utilisez le checkout hébergé, les liens de paiement ou des flux directs pour accepter Wave, MTN MoMo, SPI et les moyens locaux.