# 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.
    
    


Al guardar la URL del webhook en la cuenta, también puede configurar la recepción de información adicional en 
los webhooks.


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




    
        Opción
        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 sensibles
        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.
    
    
        Mostrar la retención fiscal del país y las comisiones de adquisición de usuarios.
        Los objetos payment_details.​country_wht y payment_details.​user_acquisition_fee se transmitirán en el webhook. Esta opción está activada por defecto.
    
    
        Enviar información de 3DS.
        El objeto cards que contiene datos sobre la verificación 3-D Secure se transmitirá en el webhook.
    




Aviso
Los campos que se envían en un webhook dependen de:la configuración avanzada establecida en la cuentala configuración personalizada establecida en el sistema de XsollaSi tiene alguna pregunta, contacte con su gestor de é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)
    Objeto con datos sobre los costes de retención fiscal en origen aplicados en determinados países por transacciones transfronterizas.

  - `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)
    Porcentaje de la tasa de costes de retención fiscal en origen.

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

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

  - `payment_details.direct_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.direct_wht.percent` (number)
    Tipo de retención fiscal directa.

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

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

  - `payment_details.payment.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.payment_method_fee` (object)
    Comisión del sistema de pago.

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

  - `payment_details.payment_method_fee.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.payment_method_sum` (object)
    Importe cargado en el sistema de pago.

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

  - `payment_details.payment_method_sum.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.payout` (object)
    Datos del desembolso (objeto).

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

  - `payment_details.payout.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.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.repatriation_commission.amount` (number)
    Importe.

  - `payment_details.repatriation_commission.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.sales_tax` (object)
    Impuesto sobre las ventas (objeto; solo en EE. UU. y Canadá).

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

  - `payment_details.sales_tax.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.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.amount` (number)
    Importe.

  - `payment_details.user_acquisition_fee.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.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.amount` (number)
    Importe.

  - `payment_details.vat.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.vat.percent` (number)
    Tipo de IVA.

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

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

  - `payment_details.xsolla_balance_sum.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.xsolla_fee` (object)
    Comisión de Xsolla (objeto).

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

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

  - `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.checkout.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `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, active la opción Add order object to webhook en su [cuenta](/es/webhooks/overview/#business-accounts), en 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.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `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.

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

  - `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](/es/webhooks/overview/#business-accounts), 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