# Pago

Cuando un usuario finaliza el proceso de pago, Xsolla envía los datos del pago 
en un webhook con el tipo payment a la URL del webhook.

Los códigos de respuesta esperados se describen en la sección Responses, 
pero también puede usar otros códigos de respuesta:


    
    
        Código de respuesta
        Descripción
    
    
    
    
        200, 201, 204
        Una respuesta correcta.
    
    
        4xx
        Se ha producido un error. Por ejemplo, si no se ha encontrado el usuario especificado o se ha transmitido una firma que no es válida.
    
    
        5xx
        Un error temporal del servidor. Cuando se recibe esta respuesta, Xsolla automáticamente volverá a intentar enviar el webhook, aumentando progresivamente el intervalo entre intentos hasta que su agente de escucha confirme la recepción. El número máximo de reintentos es de 12 en un periodo de 48 horas.
    
    


Cuando guarde la URL del webhook en Cuenta del 
editor, también podrá configurar la recepción de información adicional en 
webhooks.


Nota
Si se registró en Cuenta del editor el 22 de enero de 2025 o antes, encontrará las opciones en su proyecto en Settings > Webhooks > Testing > Payments > Advanced settings.




    
        Conmutador
        Descripción
    


    
        Mostrar información sobre la cuenta de pago guardada
        La información sobre el método de pago guardado se transmite en el objeto personalizado payment_account.
    
    
        Mostrar información sobre las transacciones mediante los métodos de pago guardados
        La información se transmite en los siguientes parámetros personalizados del webhook:saved_payment_method:0: no se utilizó el método de pago guardado1: el método de pago se guardó al realizar el pago actual2: se utiliza el método de pago guardado previamentepayment_type:1: pago único2: pago periódico
    
    
        Añadir objeto del pedido al webhook
        La información sobre el pedido se transmite en el objeto order del webhook Pago.
    
    
        Enviar solamente los parámetros de usuario necesarios sin datos confidenciales
        Solamente la siguiente información sobre el usuario se transmite en el webhook:IDpaís
    
    
        Mostrar número de BIC y sufijo de la tarjeta
        La siguiente información sobre el número de tarjeta bancaria se transmite en el webhook:los 6 primeros dígitos del parámetro card_binlos 4 últimos dígitos del card_suffix
    
    
        Mostrar marca de tarjeta
        La marca de la tarjeta empleada para realizar el pago. Por ejemplo, Mastercard o Visa.
    




Aviso
Los campos que se envían en un webhook dependen de:los parámetros establecidos en la configuración avanzada de Cuenta del editorla configuración personalizada establecida en el lado de XsollaSi tiene alguna pregunta, contacte con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com.

Endpoint: POST payment
Version: 1.0

## Request fields (application/json):

  - `custom_parameters` (object)
    Sus parámetros personalizados.

  - `notification_type` (string, required)
    Tipo de notificación.

  - `payment_details` (object, required)
    Datos del pago (objeto).

  - `payment_details.country_wht` (object)
    Retención fiscal aplicada en determinados países debido a transacciones transfronterizas (objeto).

  - `payment_details.country_wht.amount` (number)
    Importe.

  - `payment_details.country_wht.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.country_wht.percent` (number)
    Tipo de retención fiscal del país, %.

  - `payment_details.direct_wht` (object)
    Retención fiscal directa.

  - `payment_details.direct_wht.percent` (number)
    Tipo de retención fiscal directa.

  - `payment_details.payment` (object)
    Importe pagado por el usuario (objeto).

  - `payment_details.payment_method_fee` (object)
    Comisión del sistema de pago.

  - `payment_details.payment_method_sum` (object)
    Importe cargado en el sistema de pago.

  - `payment_details.payout` (object)
    Datos del desembolso (objeto).

  - `payment_details.payout_currency_rate` (string)
    Tipo de cambio entre las monedas de pago y de desembolso.

  - `payment_details.repatriation_commission` (object)
    Objeto con datos sobre costes de repatriación, que son impuestos a Xsolla por terceros.

  - `payment_details.sales_tax` (object)
    Impuesto sobre las ventas (objeto; solo en EE. UU. y Canadá).

  - `payment_details.sales_tax.percent` (number)
    Tipo impositivo sobre las ventas.

  - `payment_details.user_acquisition_fee` (object)
    Importe total de los costes de adquisición del usuario deducidos por las compras realizadas mediante redes de afiliación e influencers (objeto).

  - `payment_details.user_acquisition_fee.percent` (number)
    Tasa del coste de adquisición del usuario, %.

  - `payment_details.vat` (object)
    Datos sobre el IVA (objeto; solo en la UE).

  - `payment_details.vat.percent` (number)
    Tipo de IVA.

  - `payment_details.xsolla_balance_sum` (object)
    Importe cargado en el saldo de Xsolla.

  - `payment_details.xsolla_fee` (object)
    Comisión de Xsolla (objeto).

  - `purchase` (object)
    Datos de la compra (objeto).

  - `purchase.checkout` (object)
    Datos del proceso de pago (objeto).

  - `purchase.checkout.amount` (number)
    Importe de la compra.

  - `purchase.coupon` (object)
    Detalles del cupón (objeto; si se utilizó un cupón al crear la suscripción).

  - `purchase.coupon.campaign_code` (string)
    Código de campaña.

  - `purchase.coupon.coupon_code` (string)
    Código de cupón.

  - `purchase.gift` (object)
    Datos del regalo (objeto).

  - `purchase.gift.giver_id` (string)
    ID del obsequiador.

  - `purchase.gift.hide_giver_from_receiver` (string)
    Si se oculta la identidad del obsequiador al destinatario.

  - `purchase.gift.message` (string)
    Mensaje del obsequiador.

  - `purchase.gift.receiver_email` (string)
    Correo electrónico del destinatario del regalo.

  - `purchase.gift.receiver_id` (string)
    ID del destinatario del regalo.

  - `purchase.order` (object)
    Objeto que contiene información sobre un pedido. Para recibir esta información, ponga el conmutador Añadir objeto de pedido a webhook en la posición On en [Cuenta del editor](https://publisher.xsolla.com/) en la sección Project settings > Webhooks > Advanced settings.

  - `purchase.order.id` (integer)
    ID de pedido.

  - `purchase.order.lineitems` (array)
    Matriz de parámetros que contienen información sobre los artículos.

  - `purchase.order.lineitems.price` (object)
    Objeto que contiene información sobre el precio de un artículo.

  - `purchase.order.lineitems.price.amount` (number)
    Precio total del artículo en la moneda seleccionada.

  - `purchase.order.lineitems.price.currency` (string)
    Moneda del precio del artículo.

  - `purchase.order.lineitems.quantity` (integer)
    Cantidad del artículo.

  - `purchase.order.lineitems.sku` (string)
    Código (SKU) del artículo.

  - `purchase.promotions` (array)
    Promociones aplicadas a esta transacción.

  - `purchase.promotions.id` (integer)
    ID de promoción.

  - `purchase.promotions.technical_name` (string)
    Nombre técnico de la promoción.

  - `purchase.subscription` (object)
    Datos de la suscripción (objeto).

  - `purchase.subscription.amount` (number)
    Precio en moneda real.

  - `purchase.subscription.date_create` (string)
    Fecha de creación de la suscripción. Fecha y hora de conformidad con la norma [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `purchase.subscription.date_next_charge` (string)
    Próxima fecha de facturación. Fecha y hora de conformidad con la norma [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `purchase.subscription.plan_id` (string)
    ID del plan (externo si el plan se creó usando una API).

  - `purchase.subscription.product_id` (string)
    ID del producto (si se envía en el token de acceso).

  - `purchase.subscription.subscription_id` (integer)
    ID de suscripción en la base de datos de Xsolla.

  - `purchase.subscription.tags` (array)
    Etiquetas del plan.

  - `purchase.total` (object, required)
    Precio total de la compra (objeto).

  - `purchase.total.amount` (number)
    Importe total del pago.

  - `settings` (object)
    Configuración del proyecto personalizada (objeto).

  - `settings.merchant_id` (integer)
    ID de vendedor.

  - `settings.project_id` (integer)
    ID del proyecto. Encontrará este parámetro en su cuenta [Publisher](https://publisher.xsolla.com/) junto al nombre del proyecto.

  - `transaction` (object, required)
    Datos de la transacción (objeto).

  - `transaction.agreement` (integer)
    ID del acuerdo.

  - `transaction.dry_run` (integer)
    Transacción de prueba. El parámetro tiene el valor 1 si es una transacción de prueba, o no se envía si la transacción es real.

  - `transaction.external_id` (string)
    ID externo de la transacción. Consulte [FAQs](/es/doc/pay-station/references/faq/#faq_payments_q_new_transaction_external_id) para obtener información detallada.

  - `transaction.id` (integer)
    ID de la transacción.

  - `transaction.payment_date` (string)
    Fecha del pago.

  - `transaction.payment_method` (integer)
    ID del método de pago.

  - `transaction.payment_method_name` (string)
    Nombre del método de pago.

  - `transaction.payment_method_order_id` (string)
    ID de pago en el sistema de pago.

  - `user` (object)
    Datos del usuario (objeto).

  - `user.country` (string)
    Código de país. Dos letras mayúsculas de conformidad con la norma [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

  - `user.email` (string)
    Correo electrónico del usuario.

  - `user.id` (string, required)
    ID de usuario.

  - `user.ip` (string)
    IP del usuario.

  - `user.name` (string)
    Nombre de usuario.

  - `user.phone` (string)
    Teléfono del usuario.

  - `user.zip` (string)
    Código postal o ZIP del usuario.

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)

  - `error.message` (string)


## Response 204 fields

## Response 500 fields