Skip to main content
PATCH
Actualizar un enlace de pago

Supported products

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

FlowAuthorization Code
Authorization URL
https://app.hubspot.com/oauth/authorize
Token URL
https://api.hubapi.com/oauth/v1/token
Scopes1
payment-links-write

Parámetros de ruta

Cuerpo

application/json
businessUnitId
object
requerido

Un objeto que representa el ID de la unidad de negocio asociada al enlace de pago.

dealConfigurations
object
requerido

Un objeto con la configuración del negocio.

descriptionHtml
object
requerido

Un objeto que contiene la descripción HTML del enlace de pago.

discountObjectId
object
requerido

Un objeto que representa el ID del objeto de descuento asociado con el enlace de pago.

domainId
object
requerido

Un objeto que representa el ID de dominio asociado al enlace de pago.

successUrl
object
requerido

Un objeto que representa la URL en caso de acción correcta a la que se hace un redireccionamiento al usuario después de una transacción exitosa.

acceptedPaymentMethods
enum<string>[]

Un conjunto de cadenas que indica los métodos de pago aceptados. Los valores válidos incluyen "CREDIT_OR_DEBIT_CARD", "ACH", "SEPA", "BACS" y "PADS".

Opciones disponibles:
CREDIT_OR_DEBIT_CARD,
ACH,
SEPA,
BACS,
PADS,
AFFIRM,
KLARNA
additionalFormFields
object[]

Un conjunto de objetos PaymentLinkFormField que representan campos de formulario adicionales para el enlace de pago.

automatedSalesTaxEnabled
boolean

Un valor booleano que indica si el impuesto sobre las ventas automatizado está habilitado.

collectFullBillingAddress
boolean

Un valor booleano que indica si se debe recoger la dirección de facturación completa durante el proceso de pago.

collectShippingAddress
boolean

Un valor booleano que indica si se debe recoger la dirección de envío durante el proceso de pago.

createContractOnPurchase
boolean
currencyCode
string

El código de divisa para el enlace de pago, representado como una cadena.

discount
object
discountCodeEnabled
boolean

Un booleano que indica si los códigos de descuento están habilitados en el enlace de pago.

discountObjectIds
string[]

Un conjunto de cadenas que representan los ID de los objetos de descuento asociados con el enlace de pago.

enableDefaultCheckoutFees
boolean

Un valor booleano que indica si las tarifas de pago predeterminadas están habilitadas.

feeObjectIds
string[]

Una matriz de cadenas que representan los ID de los objetos de tarifas asociados con el enlace de pago.

fees
object[]

Un conjunto de objetos FeeRequest que representan las tarifas asociadas al enlace de pago.

includeEmailInSuccessRedirect
boolean

Un valor booleano que indica si se debe incluir el correo electrónico en el redireccionamiento en caso de acción correcta.

isOneTimeUseEnabled
boolean

Un valor booleano que indica si el enlace de pago está habilitado para un solo uso.

lineItemObjectIds
string[]

Un conjunto de cadenas que representan los ID de los objetos de elementos de pedido asociados con el enlace de pago.

lineItems
(CUSTOM · object | FROM_PRODUCT · object | CLONE · object)[]

Un conjunto de objetos de elemento de pedido, que pueden ser de los tipos LineItemCustomCreateRequest, LineItemFromProductCreateRequest o LineItemCloneCreateRequest.

El nombre del enlace de pago, representado como una cadena.

state
enum<string>

El estado del enlace de pago, representado como una cadena. Los valores válidos son "ON" y "OFF".

Opciones disponibles:
OFF,
ON
storePaymentMethodAtCheckout
boolean

Un valor booleano que indica si el método de pago se debe guardar al finalizar el pago.

taxObjectIds
string[]

Una matriz de cadenas que representan los ID de los objetos de impuestos asociados con el enlace de pago.

taxes
object[]

Un conjunto de objetos TaxRequest que representan los impuestos asociados con el enlace de pago.

Respuesta

successful operation

acceptedPaymentMethods
enum<string>[]
requerido

Una lista de métodos de pago aceptados para el enlace de pago. Los valores válidos son "CREDIT_OR_DEBIT_CARD", "ACH", "SEPA", "BACS" y "PADS".

Opciones disponibles:
CREDIT_OR_DEBIT_CARD,
ACH,
SEPA,
BACS,
PADS,
AFFIRM,
KLARNA
additionalFormFields
object[]
requerido

Un conjunto de campos de formulario adicionales incluidos en el enlace de pago.

archived
boolean
requerido

Un valor booleano que indica si el enlace de pago está archivado.

automatedSalesTaxEnabled
boolean
requerido

Un booleano que indica si el impuesto de ventas automatizado está habilitado para el enlace de pago.

checkoutFeeIds
string[]
requerido

Un conjunto de ID de cargos de pago asociados al enlace de pago.

collectFullBillingAddress
boolean
requerido

Un valor booleano que indica si se debe recoger la dirección de facturación completa durante el proceso de pago.

collectShippingAddress
boolean
requerido

Un valor booleano que indica si se debe recoger la dirección de envío durante el proceso de pago.

createContractOnPurchase
boolean
requerido
currencyCode
string
requerido

El código de divisa para el enlace de pago, representado como una cadena.

discountCodeEnabled
boolean
requerido

Un booleano que indica si los códigos de descuento están habilitados en el enlace de pago.

discounts
object[]
requerido

Un conjunto de objetos de descuento asociados al enlace de pago.

fees
object[]
requerido

Un conjunto de objetos de tarifas asociados con el enlace de pago.

formGuid
string
requerido

El GUID del formulario asociado al enlace de pago, representado como una cadena.

id
string
requerido

El identificador único del enlace de pago, representado como una cadena.

includeEmailInSuccessRedirect
boolean
requerido

Un valor booleano que indica si se debe incluir el correo electrónico en la URL de redireccionamiento en caso de acción correcta.

isOneTimeUseEnabled
boolean
requerido

Un valor booleano que indica si el enlace de pago está habilitado para un solo uso.

lineItems
object[]
requerido

Un conjunto de elementos de pedido asociados con el enlace de pago.

El nombre del enlace de pago, representado como una cadena.

La URL del enlace de pago, representada como una cadena.

state
enum<string>
requerido

El estado actual del enlace de pago, representado como una cadena. Los valores válidos son "ON" y "OFF".

Opciones disponibles:
OFF,
ON
storePaymentMethodAtCheckout
boolean
requerido

Un booleano que indica si se debe guardar el método de pago al finalizar el pago.

taxes
object[]
requerido

Un conjunto de objetos de impuestos asociados con el enlace de pago.

archivedAt
string<date-time>

La fecha y hora en que se archivó el enlace de pago, en formato ISO 8601.

businessUnitId
string

El ID de la unidad de negocio asociado al enlace de pago, representado como una cadena.

createdAt
string<date-time>

La fecha y hora en que se creó el enlace de pago, en formato ISO 8601.

dealConfigurations
object
descriptionHtml
string

La descripción HTML del enlace de pago, representada como una cadena.

domainId
string

El ID de dominio asociado al enlace de pago, representado como una cadena.

successUrl
string

La URL a la que se hará redireccionamiento tras un pago exitoso, representada como una cadena.

updatedAt
string<date-time>

La fecha y hora de la última actualización del enlace de pago, en formato ISO 8601.

Última modificación el 6 de octubre de 2026