Passer au contenu
/
Lire une transaction

Pay Station API (2.0)

Présentation

  • Version : 2.0.0
  • Serveurs :
    • https://api.xsolla.com/api

Pay Station permet aux partenaires de monétiser leurs produits en fournissant aux utilisateurs une interface pratique pour payer les achats en jeu dans le magasin de jeu. Pour configurer l'ouverture de l'interface de paiement, reportez-vous à ces instructions.

Pay Station API fournit les groupes d'appels suivants :

  • Jeton — comprend l'appel API pour générer un jeton avec des paramètres utilisateur arbitraires pour le traitement ultérieur du paiement via l'interface de paiement.
  • Tokénisation — comprend les appels API pour traiter les paiements en toute sécurité sans ouvrir l'interface de paiement ni impliquer l'utilisateur.
  • Rapports — comprend les appels API pour renvoyer des données sur les transactions des utilisateurs, pour générer des rapports et pour répartir les virements par devises.
  • Remboursement — comprend les appels API pour demander des remboursements intégraux et partiels.
  • Test — comprend l'appel API pour tester le processus de chargeback.

Pour plus d'informations sur la configuration de l'interface de paiement, reportez-vous au guide d'intégration de la solution Payments.

Note

Vous pouvez également vous référer à la section Xsolla Base API dans la collection Postman pour tester les appels API utilisés pour l'intégration.

Télécharger la description d'OpenAPI
index.json
index.yaml
Langues
Serveurs
https://api.xsolla.com/merchant/v2/
Mock server
https://xsolla.redocly.app/_mock/fr/api/pay-station/

Jeton

Opérations

Tokénisation

Opérations

Rapports

Opérations

Lire des rapports

Requête

Récupère une liste de rapports financiers sur une période donnée.

Remarque

Cet appel API ne contient pas le paramètre de chemin project_id, vous devez donc utiliser la clé API valide dans tous les projets de l'entreprise pour l'autorisation.

Sécurité
basicAuth
Chemin
merchant_idintegerobligatoire

ID de commerçant.

Requête
datetime_fromstring(datetime)obligatoire

Début de la période au format AAAA-MM-JJ. Non requis si au moins un des paramètres suivants est passé :

  • transfer_id ;
  • report_id.

Exemple: datetime_from=2023-02-08
datetime_tostring(datetime)obligatoire

Fin de la période au format AAAA-MM-JJ. Non requis si au moins un des paramètres suivants est passé :

  • transfer_id ;
  • report_id.
La différence entre datetime_from et datetime_to doit être inférieure à 92 jours.

Exemple: datetime_to=2023-03-08
curl -i -X GET \
  -u <username>:<password> \
  'https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/reports?datetime_from=2023-02-08&datetime_to=2023-03-08'

Réponses

OK.

Corpsapplication/json
Réponse
application/json
[
  {
    "agreement_document_id": "Organization Inc_RUB",
    "currency": "RUB",
    "is_direct_payout": false,
    "is_draft_by_agreement": true,
    "month": "January",
    "report_id": 57613,
    "year": 2019
  },
  {
    "agreement_document_id": "Organization Inc_EUR",
    "currency": "USD",
    "is_direct_payout": false,
    "is_draft_by_agreement": true,
    "month": "January",
    "report_id": 57619,
    "year": 2019
  }
]

Lire la liste des transactions

Requête

Renvoie une liste d'informations détaillées sur les transactions réussies et annulées pour une période donnée. Vous recevrez des informations sur les paiements, les frais, les taxes, les commandes et les utilisateurs. La liste est fournie au format JSON ou CSV. Cet appel API convient pour effectuer un rapprochement financier.

Remarque

Cet appel API ne contient pas le paramètre de chemin project_id, vous devez donc utiliser la clé API valide dans tous les projets de l'entreprise pour l'autorisation.

Sécurité
basicAuth
Chemin
merchant_idintegerobligatoire

ID de commerçant.

formatstringobligatoire

Format de données.

Enum"json""csv""xls"
Requête
datetime_fromstring(datetime)obligatoire

Début de la période au format AAAA-MM-JJ. Non requis si au moins un des paramètres suivants est passé :

  • transfer_id ;
  • report_id.

Exemple: datetime_from=2023-02-08
datetime_tostring(datetime)obligatoire

Fin de la période au format AAAA-MM-JJ. Non requis si au moins un des paramètres suivants est passé :

  • transfer_id ;
  • report_id.
La différence entre datetime_from et datetime_to doit être inférieure à 92 jours.

Exemple: datetime_to=2023-03-08
in_transfer_currencyintegerobligatoire

Convertit toutes les données financières dans la devise de versement (la devise de paiement est utilisée par défaut). Non requis si au moins un des paramètres suivants est passé :

  • transfer_id ;
  • report_id.

show_totalboolean

Détermine l'inclusion du montant total des transactions dans le rapport. Disponible uniquement pour l'exportation au format CSV. La valeur par défaut est true.

merchant_of_recordsstring or null

Merchant of Record. La valeur peut être xsolla, merchant ou ne pas être spécifiée. Si merchant, renvoie les transactions effectuées via les passerelles du partenaire. Si xsolla, renvoie les transactions effectuées sans passer par les passerelles du partenaire. Si elle n'est pas spécifiée, toutes les transactions sont renvoyées.

Enum ValeurDescription
merchant

Renvoie les transactions effectuées via les passerelles du partenaire.

xsolla

Renvoie les transactions effectuées sans passer par les passerelles du partenaire.

project_idinteger

ID de projet.

show_dry_runboolean

Détermine l'inclusion des transactions test.

transfer_idinteger

ID de virement.

report_idinteger

ID de rapport financier.

offsetinteger

Numéro de l'élément à partir duquel la liste est générée (le décompte commence à 0).

limitinteger

Limite du nombre de transactions affichées sur la page. Si ce paramètre est passé, les paramètres datetime_from et datetime_to ne sont plus requis.

statusstring

Statut de transaction.

Enum"done""canceled""error""refunded"
curl -i -X GET \
  -u <username>:<password> \
  'https://api.xsolla.com/merchant/v3/merchants/{merchant_id}/reports/transactions/registry.{format}?datetime_from=2023-02-08&datetime_to=2023-03-08&in_transfer_currency=0&show_total=true&merchant_of_records=xsolla&project_id=0&show_dry_run=true&transfer_id=0&report_id=0&offset=0&limit=0&status=done'

Réponses

Liste des transactions renvoyée avec succès.

Corpsapplication/jsonArray [
payment_detailsobject

Informations sur le paiement.

payment_details.​chargebackPenaltyobject
payment_details.​chargebackPenalty.​amountnumber(float)
payment_details.​commission_agentobject
payment_details.​commission_agent.​amountnumber(float)
payment_details.​commission_agent.​percentnumber(float)
payment_details.​commission_agent_fixedinteger
payment_details.​commission_psobject
payment_details.​commission_ps.​amountnumber(float)
payment_details.​commission_ps.​fixed_amountinteger
payment_details.​commission_ps.​percentnumber(float)
payment_details.​commission_ps_from_vatobject
payment_details.​commission_ps_from_vat.​amountnumber(float)
payment_details.​commission_userobject
payment_details.​commission_user.​amountnumber(float)
payment_details.​commission_user.​percentnumber(float)
payment_details.​commission_xsollaobject
payment_details.​commission_xsolla.​amountnumber(float)
payment_details.​commission_xsolla.​fixed_amountinteger
payment_details.​commission_xsolla.​percentnumber(float)
payment_details.​cpa_network_commissionobject
payment_details.​cpa_network_commission.​amountnumber(float)
payment_details.​cpa_network_commission.​percentnumber(float)
payment_details.​direct_whtobject
payment_details.​direct_wht.​amountnumber(float)
payment_details.​direct_wht.​percentnumber(float)
payment_details.​paymentobject
payment_details.​payment.​amountnumber(float)
payment_details.​payment.​amount_from_psinteger
payment_details.​payment.​currencystring
payment_details.​payoutobject
payment_details.​payout.​amountnumber(float)
payment_details.​payout.​amount_from_psnumber(float)
payment_details.​payout.​currencystring
payment_details.​payout.​fx_ratenumber(float)
payment_details.​payout.​percentnumber(float)
payment_details.​refundPenaltyobject
payment_details.​refundPenalty.​amountnumber(float)
payment_details.​repatriation_costsobject
payment_details.​repatriation_costs.​amountnumber(float)
payment_details.​repatriation_costs.​percentnumber(float)
payment_details.​sales_taxobject
payment_details.​sales_tax.​amountnumber(float)
payment_details.​sales_tax.​percentnumber(float)
payment_details.​vatobject
payment_details.​vat.​amountnumber(float)
payment_details.​vat.​percentnumber(float)
payment_details.​vat.​user_amountinteger
payment_details.​vat.​user_percentinteger
purchaseobject

Informations sur l'achat.

purchase.​friendobject
purchase.​friend.​emailstring or null
purchase.​friend.​user_idstring or null
purchase.​items_amountinteger
purchase.​pin_codesobject
purchase.​pin_codes.​amountnumber or null(float)
purchase.​pin_codes.​contentstring or null
purchase.​pin_codes.​currencystring or null
purchase.​purchase_amountnumber(float)
purchase.​simple_checkoutobject
purchase.​simple_checkout.​amountnumber or null(float)
purchase.​simple_checkout.​currencystring or null
purchase.​subscriptionobject
purchase.​subscription.​namestring or null
purchase.​subscription.​plan_idinteger or null
purchase.​subscription.​product_idstring or null
purchase.​subscription.​product_namestring or null
purchase.​subscription.​subscription_idinteger or null
purchase.​virtual_currencyobject
purchase.​virtual_currency.​amountnumber(float)
purchase.​virtual_currency.​currencystring
purchase.​virtual_currency_amountinteger
purchase.​virtual_itemsobject
purchase.​virtual_items.​amountnumber or null(float)
purchase.​virtual_items.​contentstring or null
purchase.​virtual_items.​currencystring or null
transactionobject

Données de transaction.

transaction.​custom_parametersobject or null
transaction.​direct_accountinteger
transaction.​dry_runinteger
transaction.​external_idstring or null
transaction.​idinteger
transaction.​payment_methodobject
transaction.​payment_method.​classstring
transaction.​payment_method.​idinteger
transaction.​payment_method.​namestring
transaction.​projectobject
transaction.​project.​idinteger
transaction.​project.​namestring
transaction.​refund_reasonstring or null
transaction.​refund_reason_commentstring or null
transaction.​statusstring
Enum"created""processing""done""canceled""error""refunded""partiallyRefunded""awaitingRefund""disputeFee"
transaction.​transfer_datestring(datetime)
userobject

Informations sur l'utilisateur.

user.​countrystring

Code pays à deux lettres majuscules selon la norme ISO 3166-1 alpha-2.

user.​customstring or null
user.​emailstring

Adresse e-mail de l'utilisateur.

user.​idstring

ID utilisateur.

user.​ipstring
user.​marketplacestring
user.​namestring

Pseudo de l'utilisateur.

user.​phonestring or null

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

user_balanceobject

Solde utilisateur.

user_balance.​payment_currencyobject

Devise de paiement préférée.

user_balance.​payment_currency.​deduction_amountnumber(float)
user_balance.​payment_currency.​payout_amount_from_balancenumber(float)
user_balance.​payment_currency.​purchase_amount_from_balancenumber(float)
]
Réponse
application/json
[
  {
    "payment_details": { … },
    "purchase": { … },
    "transaction": { … },
    "user": { … },
    "user_balance": { … }
  }
]

Rechercher des transactions

Requête

Renvoie une liste de transactions selon des critères de recherche spécifiques. Vous recevrez des données sur tous les paiements dans votre jeu, y compris ceux échoués. Vous pouvez définir la période de transaction et d'autres critères de recherche, comme un utilisateur particulier ou le statut de paiement. La liste est fournie au format JSON ou CSV.

Remarque

Cet appel API ne contient pas le paramètre de chemin project_id, vous devez donc utiliser la clé API valide dans tous les projets de l'entreprise pour l'autorisation.

Sécurité
basicAuth
Chemin
merchant_idintegerobligatoire

ID de commerçant.

formatstringobligatoire

Format de données.

Enum"json""csv""xls"
Requête
datetime_fromstring(datetime)

Début de la période.

datetime_tostring(datetime)

Fin de la période.

project_idinteger

ID de projet.

transaction_idinteger

ID de transaction.

typestring

Type de transactions affichées dans les résultats de la recherche :

Enum ValeurDescription
all

Toutes les transactions.

canceled

Transactions annulées, à l'exclusion des transactions test.

test

Transactions test.

transferred

Transactions réussies, à l'exclusion des transactions test.

phonestring

Numéro de téléphone au format international.

user_idstring

ID utilisateur unique dans le jeu stocké de votre côté. Assurez-vous de passer l'ID existant. En cas d'erreur, consultez les réponses de la FAQ.

user_namestring

Nom d'utilisateur.

user_customstring

Paramètre personnalisé pour l'identification utilisateur.

emailstring<= 100 characters

Adresse e-mail de l'utilisateur.

external_idstring

ID de transaction dans le jeu. Il doit être unique pour chaque paiement d'utilisateur.

order_idinteger

ID de commande. Utilisez-le pour appeler la méthode API Lire une commande.

Exemple: order_id=1234
offsetinteger

Numéro de l'élément à partir duquel la liste est générée (le décompte commence à 0).

limitinteger

Nombre maximal d'éléments sur une page.

statusstring(status.enum)

Statut de transaction.

Enum ValeurDescription
awaitingRefund

La transaction est en attente d'une décision de remboursement. Une fois que l'utilisateur a demandé un remboursement, le service client Xsolla traite manuellement la demande et prend une décision sur le remboursement.

canceled

Il existe deux scénarios possibles :

  • La transaction a été annulée par le système de paiement. Par exemple, le compte de l'utilisateur n'était pas suffisamment approvisionné.
  • Le paiement a été remboursé à l'utilisateur.
created

L'utilisateur a initié la transaction, mais celle-ci n'a pas encore été traitée.

done

La transaction a été traitée avec succès.

error

Une erreur s'est produite lors du traitement de la transaction. Pour obtenir un remboursement, contactez le service client Xsolla.

partiallyRefunded

L'utilisateur a reçu un remboursement partiel.

processing

La transaction est en cours de traitement.

refunded

Un remboursement a été effectué sur le solde Xsolla de l'utilisateur.

review

La transaction a été suspendue par le système anti-fraude. Elle fait actuellement l'objet d'une vérification supplémentaire.

curl -i -X GET \
  -u <username>:<password> \
  'https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/reports/transactions/search.{format}?datetime_from=string&datetime_to=string&project_id=0&transaction_id=0&type=all&phone=string&user_id=string&user_name=string&user_custom=string&email=string&external_id=string&order_id=1234&offset=0&limit=0&status=created'

Réponses

OK.

Corpsapplication/json
Réponse
application/json
[
  {
    "payment_details": { … },
    "payment_system": { … },
    "purchase": { … },
    "transaction": { … },
    "user": { … }
  }
]

Rechercher des transactions (recherche rapide)

Requête

Récupère en quelques secondes une liste de transactions sur la base de paramètres de recherche spécifiques. Il s'agit de l'alternative à l'appel API Rechercher des transactions qui renvoie des données au format JSON, CSV ou XLS.

Remarque

Cet appel API ne contient pas le paramètre de chemin project_id, vous devez donc utiliser la clé API valide dans tous les projets de l'entreprise pour l'autorisation.

Sécurité
basicAuth
Chemin
merchant_idintegerobligatoire

ID de commerçant.

Requête
transaction_idinteger

ID de transaction. Soit cet ID, soit external_id doit être passé, mais jamais les deux.

external_idstring

ID de transaction dans le jeu. Il est unique pour chaque paiement. Soit cet ID, soit transaction_id doit être passé, mais jamais les deux.

curl -i -X GET \
  -u <username>:<password> \
  'https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/reports/transactions/simple_search?transaction_id=0&external_id=string'

Réponses

Liste des transactions renvoyée avec succès.

Corpsapplication/jsonArray [
payment_detailsobject

Informations sur le paiement.

payment_details.​paymentobject
payment_details.​payment.​amountnumber(float)

Montant du paiement.

payment_details.​payment.​currencystring

Devise de paiement. Code de devise à trois lettres selon la norme ISO 4217.

transactionobject

Informations sur la transaction.

transaction.​external_idstring

ID de transaction dans le jeu. Il est unique pour chaque paiement d'utilisateur.

transaction.​idinteger

ID de transaction.

transaction.​payment_datestring

Date du paiement au format AAAA-MM-JJ.

transaction.​projectobject
transaction.​project.​idinteger

ID de projet. Il se trouve dans le Compte éditeur.

transaction.​project.​namestring

Nom de projet.

transaction.​refund_reasonstring

Motif de remboursement.

transaction.​statusstring(status.enum)

Statut de transaction.

Enum ValeurDescription
awaitingRefund

La transaction est en attente d'une décision de remboursement. Une fois que l'utilisateur a demandé un remboursement, le service client Xsolla traite manuellement la demande et prend une décision sur le remboursement.

canceled

Il existe deux scénarios possibles :

  • La transaction a été annulée par le système de paiement. Par exemple, le compte de l'utilisateur n'était pas suffisamment approvisionné.
  • Le paiement a été remboursé à l'utilisateur.
created

L'utilisateur a initié la transaction, mais celle-ci n'a pas encore été traitée.

done

La transaction a été traitée avec succès.

error

Une erreur s'est produite lors du traitement de la transaction. Pour obtenir un remboursement, contactez le service client Xsolla.

partiallyRefunded

L'utilisateur a reçu un remboursement partiel.

processing

La transaction est en cours de traitement.

refunded

Un remboursement a été effectué sur le solde Xsolla de l'utilisateur.

review

La transaction a été suspendue par le système anti-fraude. Elle fait actuellement l'objet d'une vérification supplémentaire.

userobject

Informations sur l'utilisateur.

user.​countrystring

Code pays à deux lettres majuscules selon la norme ISO 3166-1 alpha-2.

user.​emailstring

Adresse e-mail de l'utilisateur.

user.​idstring

ID utilisateur.

user.​namestring

Nom d'utilisateur.

]
Réponse
application/json
[
  {
    "payment_details": { … },
    "transaction": { … },
    "user": { … }
  }
]

Lire les virements répartis en devises

Requête

Repartit les virements en fonction de la devise.

Remarque

Cet appel API ne contient pas le paramètre de chemin project_id, vous devez donc utiliser la clé API valide dans tous les projets de l'entreprise pour l'autorisation.

Sécurité
basicAuth
Chemin
merchant_idintegerobligatoire

ID de commerçant.

Requête
datetime_fromstring(datetime)

Début de la période.

datetime_tostring(datetime)

Fin de la période.

legal_entity_idinteger

ID de l'entité légale du développeur.

statusstring

Statut de transaction.

Enum"done""canceled""error""refunded"
curl -i -X GET \
  -u <username>:<password> \
  'https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/reports/transactions/summary/transfer?datetime_from=string&datetime_to=string&legal_entity_id=0&status=done'

Réponses

OK.

Corpsapplication/json
Réponse
application/json
[
  {
    "DirectTaxesOfPayments": 0.46,
    "IsoCurrency": "RUB",
    "PaymentsAmount": 223679.84,
    "SumCommissionAgent": 11329.58,
    "SumCommissionUserTaxes": 153.67,
    "SumItems": 571325.13,
    "SumNominalSum": 214792.98,
    "SumOutProject": 551096.13,
    "SumPayoutSum": 193316.71,
    "TaxesOfPayments": 171.56
  },
  {
    "DirectTaxesOfPayments": 0.14,
    "IsoCurrency": "USD",
    "PaymentsAmount": 482.58,
    "SumCommissionAgent": 77.51,
    "SumCommissionUserTaxes": 0.07,
    "SumItems": 243777.62,
    "SumNominalSum": 493.09,
    "SumOutProject": 241787.62,
    "SumPayoutSum": 462.62,
    "TaxesOfPayments": 0.14
  },
  {
    "DirectTaxesOfPayments": 0.07,
    "IsoCurrency": "EUR",
    "PaymentsAmount": 608.2,
    "SumCommissionAgent": 55.71,
    "SumCommissionUserTaxes": 90.94,
    "SumItems": 156238.62,
    "SumNominalSum": 607.26,
    "SumOutProject": 156158.62,
    "SumPayoutSum": 460.8,
    "TaxesOfPayments": 90.94
  }
]

Lire une transaction

Requête

Récupère les informations complètes sur une transaction par son ID.

Remarque

Cet appel API ne contient pas le paramètre de chemin project_id, vous devez donc utiliser la clé API valide dans tous les projets de l'entreprise pour l'autorisation.

Sécurité
basicAuth
Chemin
merchant_idintegerobligatoire

ID de commerçant.

transaction_idintegerobligatoire

ID de transaction.

curl -i -X GET \
  -u <username>:<password> \
  'https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/reports/transactions/{transaction_id}/details'

Réponses

Informations relatives à la transaction renvoyées avec succès.

Corpsapplication/jsonArray [
customer_detailsobject
customer_details.​billing_addressstring
customer_details.​binstring
customer_details.​browser_languagestring
customer_details.​countrystring
customer_details.​ipstring
customer_details.​paystation_countrystring
customer_details.​phonestring or null
customer_details.​timezonestring
customer_details.​user_idstring
customer_details.​user_namestring
finance_detailsobject
finance_details.​direct_whtobject
finance_details.​direct_wht.​amountnumber(float)
finance_details.​direct_wht.​currencystring
finance_details.​dispute_feeobject
finance_details.​dispute_fee.​amountnumber(float)

Le montant de la taxe de contestation dans la devise de paiement.

finance_details.​dispute_fee.​currencystring

Devise de paiement. Code de devise à trois lettres selon la norme 7ISO 4217.

finance_details.​dispute_fee.​datestring

Date d'ouverture de la contestation.

finance_details.​paymentobject
finance_details.​payment.​amountnumber(float)
finance_details.​payment.​currencystring
finance_details.​payment_method_feeobject
finance_details.​payment_method_fee.​amountnumber(float)
finance_details.​payment_method_fee.​currencystring
finance_details.​payment_method_sumobject
finance_details.​payment_method_sum.​amountnumber(float)
finance_details.​payment_method_sum.​currencystring
finance_details.​payoutobject
finance_details.​payout.​amountnumber(float)
finance_details.​payout.​currencystring
finance_details.​payout_currency_ratenumber(float)
finance_details.​repatriation_commissionobject
finance_details.​repatriation_commission.​amountnumber(float)
finance_details.​repatriation_commission.​currencystring
finance_details.​sales_taxobject
finance_details.​sales_tax.​amountnumber(float)
finance_details.​sales_tax.​currencystring
finance_details.​vatobject
finance_details.​vat.​amountnumber(float)
finance_details.​vat.​currencystring
finance_details.​xsolla_balance_sumobject
finance_details.​xsolla_balance_sum.​amountnumber(float)
finance_details.​xsolla_balance_sum.​currencystring
finance_details.​xsolla_feeobject
finance_details.​xsolla_fee.​amountnumber(float)
finance_details.​xsolla_fee.​currencystring
payment_detailsobject
payment_details.​card_holdernamestring or null
payment_details.​card_issuerstring
payment_details.​card_monthinteger
payment_details.​card_numberinteger
payment_details.​card_schemestring
payment_details.​card_yearinteger
payment_details.​customer_firstnamestring
payment_details.​customer_lastnamestring
payment_details.​enrollmentboolean
payment_details.​ps_accountstring
payment_details.​zip_codestring
subscription_detailsobject
subscription_details.​is_payment_from_subscriptionboolean
subscription_details.​is_subscription_createdboolean
transaction_detailsobject
transaction_details.​amountnumber(float)
transaction_details.​cancellation_datestring or null
transaction_details.​countrystring
transaction_details.​currencystring
transaction_details.​custom_parametersstring or null
transaction_details.​foreign_invoicestring or null
transaction_details.​gift_recipient_emailstring or null
transaction_details.​gift_recipient_idstring or null
transaction_details.​payment_datestring
transaction_details.​payment_methodstring
transaction_details.​payment_method_namestring
transaction_details.​projectinteger
transaction_details.​project_namestring
transaction_details.​purchaseobject
transaction_details.​purchase.​checkoutobject
transaction_details.​purchase.​checkout.​amountnumber(float)
transaction_details.​purchase.​checkout.​currencystring
transaction_details.​purchase.​pin_codesobject
transaction_details.​purchase.​pin_codes.​amountnumber(float)
transaction_details.​purchase.​pin_codes.​contentstring or null
transaction_details.​purchase.​pin_codes.​currencystring or null
transaction_details.​purchase.​totalobject
transaction_details.​purchase.​total.​amountnumber(float)
transaction_details.​purchase.​total.​currencystring
transaction_details.​purchase.​virtual_currencyobject
transaction_details.​purchase.​virtual_currency.​amountnumber(float)
transaction_details.​purchase.​virtual_currency.​currencystring
transaction_details.​purchase.​virtual_currency.​namestring
transaction_details.​purchase.​virtual_currency.​quantitystring
transaction_details.​purchase.​virtual_itemsobject or null
transaction_details.​purchase.​virtual_items.​amountnumber(float)
transaction_details.​purchase.​virtual_items.​contentstring
transaction_details.​purchase.​virtual_items.​currencystring
transaction_details.​refund_commentstring or null
transaction_details.​refund_reasonstring or null
transaction_details.​statusstring
transaction_details.​user_idstring
]
Réponse
application/json
[
  {
    "customer_details": { … },
    "finance_details": { … },
    "payment_details": { … },
    "subscription_details": { … },
    "transaction_details": { … }
  }
]

Lire des virements

Requête

Récupère une liste de tous les virements pour une période donnée.

Remarque

Cet appel API ne contient pas le paramètre de chemin project_id, vous devez donc utiliser la clé API valide dans tous les projets de l'entreprise pour l'autorisation.

Sécurité
basicAuth
Chemin
merchant_idintegerobligatoire

ID de commerçant.

Requête
datetime_fromstring(datetime)

Début de la période.

datetime_tostring(datetime)

Fin de la période.

legal_entity_idinteger

ID de l'entité légale du développeur.

statusstring

Statut du virement.

Enum ValeurDescription
hold

Attente de demande de traitement.

paid

Virement complété.

ready

Virement en cours.

curl -i -X GET \
  -u <username>:<password> \
  'https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/reports/transfers?datetime_from=string&datetime_to=string&legal_entity_id=0&status=hold'

Réponses

OK.

Corpsapplication/json
Réponse
application/json
[
  {
    "canceled": 0,
    "payout": { … },
    "rate": 1,
    "transfer": { … }
  }
]

Remboursement

Opérations

Tests

Opérations