Saltar al contenido

Descripción general

  • Versión: 2.0.0
  • Servidores:
    • https://api.xsolla.com/api

Con Pay Station, los socios podrán monetizar sus productos ofreciendo a los usuarios una cómoda interfaz para pagar las compras dentro del juego en la tienda del juego. Para establecer la apertura de la interfaz de pago, consulte estas instrucciones.

Pay Station API proporciona los siguientes grupos de llamadas:

  • El token incluye la llamada API que permite generar un token con parámetros de usuario arbitrarios para procesar posteriormente los pagos a través de la interfaz de pago.
  • Tokenización: incluye las llamadas API para procesar pagos de forma segura sin abrir la interfaz de pago ni implicar al usuario.
  • Informes: incluye las llamadas API para devolver datos sobre las transacciones de los usuarios, generar informes, así como obtener el desglose de las retribuciones por moneda.
  • Reembolso: incluye las llamadas API para solicitar reembolsos totales y parciales.
  • Pruebas: incluye la llamada API que permite probar el proceso de contracargo.

En el documento Guía de integración de la solución Payments encontrará información detallada sobre la configuración de la interfaz de pago.

Nota

También puede consultar la sección de la Xsolla Base API de la Colección Postman para probar las llamadas API empleadas para la integración.

Descargar descripción de OpenAPI
Idiomas
Servidores
https://api.xsolla.com/merchant/v2/
Mock server
https://xsolla.redocly.app/_mock/es/api/pay-station/
Operaciones
Operaciones
Operaciones

Solicitud

Obtiene la lista de informes financieros durante un periodo especificado.

Aviso

Esta llamada API no contiene el parámetro de ruta project_id, por lo que tiene que usar la clave de API que sea válida en todos los proyectos de la empresa para establecer la autorización.

Seguridad
basicAuth
Ruta
merchant_idintegerrequerido

ID de vendedor.

Consulta
datetime_fromstring(datetime)requerido

Fin del periodo en formato AAAA-MM-DD. No es necesario si se transmite al menos uno de los siguientes parámetros:

  • transfer_id
  • report_id

Ejemplo: datetime_from=2023-02-08
datetime_tostring(datetime)requerido

Fin del periodo en formato AAAA-MM-DD. No es necesario si se transmite al menos uno de los siguientes parámetros:

  • transfer_id
  • report_id
La diferencia entre datetime_from y datetime_to no puede ser superior a 92 días.

Ejemplo: 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'

Respuestas

OK.

Cuerpoapplication/json
Respuesta
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 } ]

Solicitud

Devuelve la lista de detalles sobre las transacciones realizadas y canceladas durante un periodo especificado. Como respuesta, recibe información sobre los pagos, incluyendo datos sobre tasas, impuestos, así como sobre el pedido y el usuario. Puede obtener la lista en formato JSON o CSV. Puede usar esta llamada API para realizar conciliaciones financieras.

Aviso

Esta llamada API no contiene el parámetro de ruta project_id, por lo que tiene que usar la clave de API que sea válida en todos los proyectos de la empresa para establecer la autorización.

Seguridad
basicAuth
Ruta
merchant_idintegerrequerido

ID de vendedor.

formatstringrequerido

Formato de los datos.

Enumeración"json""csv""xls"
Consulta
datetime_fromstring(datetime)requerido

Fin del periodo en formato AAAA-MM-DD. No es necesario si se transmite al menos uno de los siguientes parámetros:

  • transfer_id
  • report_id

Ejemplo: datetime_from=2023-02-08
datetime_tostring(datetime)requerido

Fin del periodo en formato AAAA-MM-DD. No es necesario si se transmite al menos uno de los siguientes parámetros:

  • transfer_id
  • report_id
La diferencia entre datetime_from y datetime_to no puede ser superior a 92 días.

Ejemplo: datetime_to=2023-03-08
in_transfer_currencyintegerrequerido

Convierte todos los datos financieros a la moneda de desembolso (por defecto se utiliza la moneda de pagos entrantes). No es necesario si se transmite al menos uno de los siguientes parámetros:

  • transfer_id
  • report_id

show_totalboolean

Si se debe incluir el importe total de las transacciones en el informe. Disponible para exportación, pero solo en formato CSV. Por defecto es true.

merchant_of_recordsstring or null

Comerciante titular. Puede ser xsolla, merchant o sin especificar. Si es merchant, devuelve las transacciones realizadas a través de las pasarelas del socio. Si es xsolla, devuelve las transacciones realizadas sin utilizar las pasarelas del socio. Si no se especifica, devuelve todas las transacciones.

Enumeración ValorDescripción
merchant

Devuelve las transacciones realizadas a través de las pasarelas del socio.

xsolla

Devuelve las transacciones realizadas sin utilizar las pasarelas del socio.

project_idinteger

ID del proyecto.

show_dry_runboolean

Si se deben incluir transacciones de prueba.

transfer_idinteger

ID del desembolso.

report_idinteger

ID del informe financiero.

offsetinteger

Número del elemento a partir del cual se genera la lista (el conteo empieza desde el 0).

limitinteger

Límite del número de transacciones que se muestran en la página. Si se transmite este parámetro, no es necesario transmitir los parámetros datetime_from y datetime_to.

statusstring

Estado de la transacción.

Enumeración"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'

Respuestas

La lista de transacciones se ha devuelto correctamente.

Cuerpoapplication/jsonArray [
payment_detailsobject

Datos del pago.

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

Datos de la compra.

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

Datos de la transacción.

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
Enumeración"created""processing""done""canceled""error""refunded""partiallyRefunded""awaitingRefund""disputeFee"
transaction.​transfer_datestring(datetime)
userobject

Datos del usuario.

user.​countrystring

Código de país de dos letras mayúsculas de conformidad con la norma ISO 3166-1 alpha-2.

user.​customstring or null
user.​emailstring

Correo del usuario.

user.​idstring

ID del usuario.

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

Nombre de pantalla del usuario.

user.​phonestring or null

Número de teléfono del usuario.

user_balanceobject

Saldo del usuario.

user_balance.​payment_currencyobject

Moneda de pago preferida.

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)
]
Respuesta
application/json
[ { "payment_details": {}, "purchase": {}, "transaction": {}, "user": {}, "user_balance": {} } ]

Solicitud

Devuelve una lista de transacciones basada en parámetros de búsqueda específicos. Como respuesta, recibirá datos sobre todos los pagos hechos en su juego, incluso si no fueron aceptados. Puede especificar no solo el periodo de la transacción, sino también otros parámetros, como p. ej., para buscar transacciones realizadas por un usuario concreto o en un estado de pago específico. Puede obtener la lista en formato JSON o CSV.

Aviso

Esta llamada API no contiene el parámetro de ruta project_id, por lo que tiene que usar la clave de API que sea válida en todos los proyectos de la empresa para establecer la autorización.

Seguridad
basicAuth
Ruta
merchant_idintegerrequerido

ID de vendedor.

formatstringrequerido

Formato de los datos.

Enumeración"json""csv""xls"
Consulta
datetime_fromstring(datetime)

Inicio del periodo.

datetime_tostring(datetime)

Fin del periodo.

project_idinteger

ID del proyecto.

transaction_idinteger

ID de la transacción.

typestring

Tipo de transacciones que aparecen en los resultados de búsqueda:

Enumeración ValorDescripción
all

Todas las transacciones.

canceled

Transacciones canceladas, sin incluir las transacciones de prueba.

test

Transacciones de prueba.

transferred

Transacciones realizadas con éxito, sin incluir las transacciones de prueba.

phonestring

Número de teléfono en formato internacional.

user_idstring

ID único de usuario en el juego que está almacenado en su lado. Asegúrese de transmitir el ID de usuario existente. Si se produce un error, consulte las respuestas a las Preguntas frecuentes.

user_namestring

Nombre de usuario.

user_customstring

Parámetro personalizado para la identificación del usuario.

emailstring<= 100 characters

Correo del usuario.

external_idstring

ID de la transacción dentro del juego. Debe ser único para cada pago del usuario.

order_idinteger

ID del pedido. Puede usarlo para invocar el método API Obtener pedido.

Ejemplo: order_id=1234
offsetinteger

Número del elemento a partir del cual se genera la lista (el conteo empieza desde el 0).

limitinteger

Límite para el número de elementos presentes en la página.

statusstring(status.enum)

Estado de la transacción.

Enumeración ValorDescripción
awaitingRefund

La transacción está pendiente de una decisión sobre el reembolso. Cuando el usuario haya solicitado un reembolso, el servicio de atención al cliente de Xsolla procesa la solicitud manualmente y adoptará una decisión sobre el reembolso.

canceled

Hay dos escenarios posibles:

  • La transacción ha sido cancelada en el lado del sistema de pago. Por ejemplo, no había fondos suficientes en la cuenta del usuario.
  • El pago fue reembolsado al usuario.
created

El usuario inició la transacción, pero esta aún no se ha procesado.

done

La transacción fue procesada correctamente.

error

Se produjo un error al procesar la transacción. Estos pagos pueden ser reembolsados si contacta con el equipo de atención al cliente de Xsolla.

partiallyRefunded

El usuario recibió un reembolso parcial.

processing

La transacción está siendo procesada.

refunded

Se hizo un reembolso al saldo de Xsolla del usuario.

review

El pago ha sido suspendido por el sistema antifraude y la transacción está siendo sometida a una verificación adicional.

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'

Respuestas

OK.

Cuerpoapplication/json
Respuesta
application/json
[ { "payment_details": {}, "payment_system": {}, "purchase": {}, "transaction": {}, "user": {} } ]

Buscar transacciones (búsqueda rápida)

Solicitud

Obtiene una lista de transacciones basada en parámetros de búsqueda específicos en unos segundos. Es una alternativa a la llamada API Find transactions que devuelve los datos en formato JSON, CSV o XLS.

Aviso

Esta llamada API no contiene el parámetro de ruta project_id, por lo que tiene que usar la clave de API que sea válida en todos los proyectos de la empresa para establecer la autorización.

Seguridad
basicAuth
Ruta
merchant_idintegerrequerido

ID de vendedor.

Consulta
transaction_idinteger

ID de la transacción. Debe indicarse este o external_id, pero no ambos.

external_idstring

ID de la transacción en el juego. Es distinto para cada pago. Debe indicarse este o transaction_id, pero no ambos.

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'

Respuestas

La lista de transacciones se ha devuelto correctamente.

Cuerpoapplication/jsonArray [
payment_detailsobject

Datos del pago.

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

Importe del pago.

payment_details.​payment.​currencystring

Moneda de pago. Código de moneda de tres letras de conformidad con la norma ISO 4217.

transactionobject

Datos de la transacción.

transaction.​external_idstring

ID de la transacción en el juego. Es distinto para cada pago de usuario.

transaction.​idinteger

ID de la transacción.

transaction.​payment_datestring

Fecha del pago en formato AA-MM-DD.

transaction.​projectobject
transaction.​project.​idinteger

ID del proyecto. Se puede encontrar en la Cuenta del editor.

transaction.​project.​namestring

Nombre del proyecto.

transaction.​refund_reasonstring

Motivo del reembolso.

transaction.​statusstring(status.enum)

Estado de la transacción.

Enumeración ValorDescripción
awaitingRefund

La transacción está pendiente de una decisión sobre el reembolso. Cuando el usuario haya solicitado un reembolso, el servicio de atención al cliente de Xsolla procesa la solicitud manualmente y adoptará una decisión sobre el reembolso.

canceled

Hay dos escenarios posibles:

  • La transacción ha sido cancelada en el lado del sistema de pago. Por ejemplo, no había fondos suficientes en la cuenta del usuario.
  • El pago fue reembolsado al usuario.
created

El usuario inició la transacción, pero esta aún no se ha procesado.

done

La transacción fue procesada correctamente.

error

Se produjo un error al procesar la transacción. Estos pagos pueden ser reembolsados si contacta con el equipo de atención al cliente de Xsolla.

partiallyRefunded

El usuario recibió un reembolso parcial.

processing

La transacción está siendo procesada.

refunded

Se hizo un reembolso al saldo de Xsolla del usuario.

review

El pago ha sido suspendido por el sistema antifraude y la transacción está siendo sometida a una verificación adicional.

userobject

Datos del usuario.

user.​countrystring

Código de país de dos letras mayúsculas de conformidad con la norma ISO 3166-1 alpha-2.

user.​emailstring

Correo del usuario.

user.​idstring

ID del usuario.

user.​namestring

Nombre de usuario.

]
Respuesta
application/json
[ { "payment_details": {}, "transaction": {}, "user": {} } ]

Obtener el desglose de los desembolsos en la moneda

Solicitud

Obtiene el desglose de los desembolsos en la moneda.

Aviso

Esta llamada API no contiene el parámetro de ruta project_id, por lo que tiene que usar la clave de API que sea válida en todos los proyectos de la empresa para establecer la autorización.

Seguridad
basicAuth
Ruta
merchant_idintegerrequerido

ID de vendedor.

Consulta
datetime_fromstring(datetime)

Inicio del periodo.

datetime_tostring(datetime)

Fin del periodo.

legal_entity_idinteger

ID de la entidad jurídica del desarrollador.

statusstring

Estado de la transacción.

Enumeración"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'

Respuestas

OK.

Cuerpoapplication/json
Respuesta
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 } ]

Solicitud

Obtiene la información completa de la transacción por ID.

Aviso

Esta llamada API no contiene el parámetro de ruta project_id, por lo que tiene que usar la clave de API que sea válida en todos los proyectos de la empresa para establecer la autorización.

Seguridad
basicAuth
Ruta
merchant_idintegerrequerido

ID de vendedor.

transaction_idintegerrequerido

ID de la transacción.

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

Respuestas

La información de la transacción se devolvió correctamente.

Cuerpoapplication/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)

El importe de la tasa de la disputa en una moneda del pago.

finance_details.​dispute_fee.​currencystring

Moneda de pago. Código de moneda de tres letras de conformidad con la norma ISO 4217.

finance_details.​dispute_fee.​datestring

Fecha de la apertura de la disputa.

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
]
Respuesta
application/json
[ { "customer_details": {}, "finance_details": {}, "payment_details": {}, "subscription_details": {}, "transaction_details": {} } ]

Solicitud

Muestra todos los pagos de un periodo.

Aviso

Esta llamada API no contiene el parámetro de ruta project_id, por lo que tiene que usar la clave de API que sea válida en todos los proyectos de la empresa para establecer la autorización.

Seguridad
basicAuth
Ruta
merchant_idintegerrequerido

ID de vendedor.

Consulta
datetime_fromstring(datetime)

Inicio del periodo.

datetime_tostring(datetime)

Fin del periodo.

legal_entity_idinteger

ID de la entidad jurídica del desarrollador.

statusstring

Estado del desembolso.

Enumeración ValorDescripción
hold

A la espera de una solicitud para proceder.

paid

Desembolso completado.

ready

Desembolso en curso.

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'

Respuestas

OK.

Cuerpoapplication/json
Respuesta
application/json
[ { "canceled": 0, "payout": {}, "rate": 1, "transfer": {} } ]
Operaciones
Operaciones