Passer au contenu
/
Notification de paiement

Digital Distribution Hub (1.0.0)

Aperçu

Digital Distribution Hub est une nouvelle solution Xsolla qui comble le fossé entre les paiements numériques et les paiements en espèces via la technologie des paiements push et le e-commerce.

Cette référence décrit les endpoints API de deux produits Xsolla : In-Game Store et Pay Station. Deux URL de base sont utilisées :

  • https://store.xsolla.com/api pour les groupes Communs, Catalogue, Panier, et Commande.
  • https://ps.xsolla.com pour le groupe Notifications.

Les endpoints API dans le groupe Catalogue ne requièrent pas d'autorisation.

Pour utiliser les opérations des groupes Panier et Commande, vous devez générer un jeton via Create user token.

Note

Cette référence présente un projet d'une future API et non une interface entièrement fonctionnelle. Actuellement, vous ne pouvez essayer que les endpoints des groupes Catalogue et Notifications. Si vous souhaitez nous faire part de vos commentaires, envoyez-nous un e-mail à l'adresse suivante : techdoc@xsolla.com.
Télécharger la description d'OpenAPI
index.json
index.yaml
Langues
Serveurs
Mock server
https://xsolla.redocly.app/_mock/fr/api/digital-distribution-hub/
https://store.xsolla.com/api/

Panier

Opérations

Clés de jeu

Opérations

Objets et monnaie virtuels

Opérations

Lots

Opérations

Jeton d'utilisateur

Opérations

Notifications

Opérations

Notification d'annulation

Requête

Envoyez une notification d'annulation de paiement dans les cas suivants :

  • le paiement n'a pas été effectué ;
  • le paiement a été remboursé.
Corpsapplication/json
payment_idintegerobligatoire
curl -i -X POST \
  https://xsolla.redocly.app/_mock/fr/api/digital-distribution-hub/push-payments/cancel \
  -H 'Content-Type: application/json' \
  -d '{
    "payment_id": 784998479
  }'

Réponses

OK.

Notification de paiement

Requête

Envoyez cette notification après avoir facturé l'utilisateur avec succès.

Corpsapplication/json
paymentobjectobligatoire
payment.​amountnumberobligatoire

Montant du paiement.

payment.​currencystring

Devise de la commande. L'UGS de la monnaie virtuelle ou code de devise à trois lettres selon la norme ISO 4217.

payment.​geotype_idintegerobligatoire

ID du partenaire distributeur du côté de Xsolla.

payment.​project_transaction_idstring

ID de transaction du côté du développeur du jeu.

payment.​ps_transaction_idstring

ID de transaction du côté du partenaire de distribution.

project_idintegerobligatoire

ID de projet.

purchaseobjectobligatoire
purchase.​order_idintegerobligatoire

ID de commande.

userobjectobligatoire
user.​emailstring

Adresse e-mail de l'utilisateur.

user.​idstringobligatoire

Identifiant unique de l'utilisateur dans le jeu.

user.​phonestring

Numéro de téléphone de l'utilisateur.

user.​ps_account_idstring

ID du compte de paiement de l'utilisateur du côté du partenaire de distribution.

curl -i -X POST \
  https://xsolla.redocly.app/_mock/fr/api/digital-distribution-hub/push-payments/pay \
  -H 'Content-Type: application/json' \
  -d '{
    "payment": {
      "amount": 10,
      "currency": "USD",
      "geotype_id": 13038,
      "ps_transaction_id": "ps_transaction_id"
    },
    "project_id": 18404,
    "purchase": {
      "order_id": 1334430
    },
    "user": {
      "id": "s.ivanov"
    }
  }'

Réponses

OK.

Corpsapplication/json
payment_idinteger
Réponse
application/json
{
  "payment_id": 784998484
}

Commande

Opérations