Implémentation
Sécurité
Pour garantir la sécurité, Xsolla utilise :
Note
Les clés API sont générées par Xsolla et uniques pour chaque prestataire.
En-têtes
Les requêtes entrantes de Xsolla contiennent les en-têtes suivants :
| En-tête | Description | Obligatoire |
|---|---|---|
Request-Id | ID unique de la requête. | Oui. |
Content-Digest | Valeurs de somme de contrôle pour le corps de la requête. | Oui, si la requête comprend un corps. |
Signature-Input | Paramètres utilisés pour générer la signature. | Oui. |
Signature | Demander une signature. | Oui. |
Prefer | Données supplémentaires, par exemple, environment=“sandbox”. | Non. |
Note
Vous devez inclure les mêmes en-têtes dans les webhooks envoyés à Xsolla.
Vérification des requêtes entrantes
Lorsque vous recevez des requêtes de Xsolla :
- Extrayez la clé secrète qui correspond à la valeur
keyidde l’en-têteSignature-Input. - Validez la fenêtre temporelle
created/expires. - Récupérez le corps de la requête.
- Reconstituez la chaîne de signature selon
Signature-Inputet vérifiez-la avec HMAC-SHA256.
Copy
- http
1sig1=("@method" "@target-uri" "content-digest" "request-id");alg="hmac-sha256";created=1700000000;expires=1700000600;keyid="acc_123"
- Utilisez
Request-Idpour rechercher la requête dans les journaux.
Fonctionnalité requise
Pour une intégration réussie, vous devez implémenter au moins les méthodes API suivantes :
| Méthode | Chemin | Description |
|---|---|---|
| POST | /v1/payments | Crée un paiement. Retourne l’objet action. |
| PATCH | /v1/payments/{transaction_id} | Confirme le paiement si action.type=confirm est retourné. |
| GET | /v1/payments/{transaction_id} | Récupère le statut actuel du paiement. |
payment.succeeded— paiement réussipayment.failed— paiement échouépayment.refunded— remboursement
Note
Référez-vous à la spécification pour obtenir une description détaillée des méthodes API et des webhooks.
Cet article vous a été utile ?
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entrée.
