Introduction
L'API Axepta BNP Paribas Online est une solution de paiement en ligne conçue pour faciliter l'intégration des paiements sécurisés sur votre plateforme e-commerce. Cette documentation technique fournit toutes les informations nécessaires pour comprendre, configurer et utiliser notre API de manière efficace.
1. Présentation de l'API
1.1. Fonctionnalités Clés
- Support de 350+ méthodes de paiement : L'API prend en charge une large gamme de méthodes de paiement à travers le monde.
- Architecture RESTful : L'API est basée sur les principes REST, offrant une interface prédictible et facile à utiliser.
- Sécurité renforcée : Conformité aux normes PCI-DSS et communication sécurisée via HTTPS (TLS 1.2 ou supérieur).
- Documentation complète : Documentation technique détaillée pour faciliter l'intégration.
1.2. Cas d'Utilisation
- Paiements en ligne : Traitement des paiements en temps réel.
- Gestion des transactions : Consultation et gestion des transactions passées.
- Personnalisation : Adaptation de l'expérience de paiement à votre site web.
2. Configuration de l'API
2.1. Prérequis
- Compte Merchant : Un compte marchand est nécessaire pour accéder à l'API.
- Clés d'API : Vous recevrez un Merchant ID et une API Key pour authentifier vos requêtes.
2.2. Environnements de Test et de Production
- Environnement de Test : Utilisé pour tester vos intégrations avant de passer en production.
- Environnement de Production : Utilisé pour les transactions réelles.
3. Authentification
3.1. Méthodes d'Authentification
Basic Authentication :
- Utilisez votre Merchant ID comme nom d'utilisateur et votre API Key comme mot de passe.
- Formatez la chaîne
MerchantID:APIKey et encodez-la en Base64. - Incluez-la dans l'en-tête
Authorization avec le préfixe Basic.
OAuth 2.0 :
- Générez un JSON Web Token (JWT) en vous authentifiant avec votre API Key via l'endpoint
authorization/oauth/token.
3.2. Exemple de Requête d'Authentification
http
Collapse
1
2
3
GET /authorization/oauth/token HTTP/1.1
Host: api.axepta.bnpparibas
Authorization: Basic base64(MerchantID:APIKey)
4. Endpoints de l'API
4.1. Création d'une Transaction
- Endpoint :
POST /payments - Description : Crée une nouvelle transaction de paiement.
- Paramètres Requis :
amount : Montant de la transaction.currency : Devise de la transaction.payment_method : Méthode de paiement choisie.customer_email : Adresse e-mail du client.
4.2. Consultation d'une Transaction
- Endpoint :
GET /payments/{transaction_id} - Description : Récupère les détails d'une transaction spécifique.
- Paramètres Requis :
transaction_id : Identifiant unique de la transaction.
4.3. Annulation d'une Transaction
- Endpoint :
POST /payments/{transaction_id}/cancel - Description : Annule une transaction en attente.
- Paramètres Requis :
transaction_id : Identifiant unique de la transaction.
5. Gestion des Erreurs
5.1. Codes d'Erreur Courants
- 400 Bad Request : Requête mal formée.
- 401 Unauthorized : Authentification échouée.
- 404 Not Found : Ressource non trouvée.
- 500 Internal Server Error : Erreur interne du serveur.
5.2. Exemple de Réponse d'Erreur
json
Collapse
1
2
3
4
5
6
⌄
⌄
{
"error": {
"code": "400",
"message": "Invalid amount"
}
}
6. Sécurité
6.1. Conformité PCI-DSS
- Chiffrement des Données : Toutes les communications sont chiffrées via HTTPS (TLS 1.2 ou supérieur).
- Protection des Données Sensibles : Les données sensibles des clients sont gérées par Axepta BNP Paribas, réduisant ainsi vos responsabilités PCI-DSS.
6.2. Bonnes Pratiques de Sécurité
- Gestion des Clés API : Stockez vos clés API de manière sécurisée.
- Mises à Jour Régulières : Assurez-vous que votre système est à jour pour éviter les vulnérabilités.
7. Documentation Complémentaire
7.1. Exemples de Code
python
Collapse
Run
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
⌄
⌄
import requests
url = "https://api.axepta.bnpparibas/payments"
headers = {
"Authorization": "Basic base64(MerchantID:APIKey)",
"Content-Type": "application/json"
}
data = {
"amount": 100.00,
"currency": "EUR",
"payment_method": "credit_card",
"customer_email": "client@example.com"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
javascript
Collapse
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
⌄
⌄
const axios = require('axios');
const url = 'https://api.axepta.bnpparibas/payments';
const headers = {
'Authorization': 'Basic base64(MerchantID:APIKey)',
'Content-Type': 'application/json'
};
const data = {
amount: 100.00,
currency: 'EUR',
payment_method: 'credit_card',
customer_email: 'client@example.com'
};
axios.post(url, data, { headers })
.then(response => console.log(response.data))
.catch(error => console.error(error));
7.2. FAQ