lomi.
Payments

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

Corps de la requête

ChampTypeObligatoireDescription
amountnumberOuiMontant demandé
currency_codestringOuiDevise (XOF, USD, etc.)
expiry_datestringOuiDate d’expiration (ISO 8601)
descriptionstringNonDescription du paiement
customer_idstringNonIdentifiant client existant
payment_referencestringNonRéférence facture / commande
metadataobjectNonPaires clé-valeur
import { LomiSDK } from '@lomi./sdk';

const lomi = new LomiSDK({
  apiKey: process.env.LOMI_API_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_API_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_API_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écupère les demandes avec filtrage optionnel.

Paramètres de requête

ParamètreTypeDescription
statusstringStatut : pending, completed, failed, expired
customerIdstringFiltrer par client
limitnumberRésultats par page (défaut : 20)
offsetnumberDécalage (défaut : 0)
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_API_KEY"

Obtenir une demande de paiement

Récupère le détail d’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_API_KEY"

Objet Payment Request

ChampTypeDescription
idstringIdentifiant unique
amountnumberMontant demandé
currency_codestringDevise
statusstringpending, completed, failed, expired
descriptionstringDescription
customer_idstringClient associé
payment_referencestringRéférence
payment_urlstringURL pour payer
expiry_datestringExpiration
transaction_idstringTransaction créée une fois payé
metadataobjectMétadonnées
created_atstringCréation

Webhooks

ÉvénementDescription
payment_request.completedPaiement reçu
payment_request.expiredDemande expirée sans paiement

Réponses d’erreur

StatutDescription
400Entrée invalide
401Clé API invalide ou manquante
404Demande introuvable

Sur cette page