Skip to main content
POST
Crear 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

Cuerpo

application/json
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 objetos PaymentLinkFormField que representan campos de formulario adicionales que se incluirán en el enlace de pago.

currencyCode
string
requerido

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

discountObjectIds
string[]
requerido

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

enableDefaultCheckoutFees
boolean
requerido

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

feeObjectIds
string[]
requerido

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

fees
object[]
requerido

Un conjunto de objetos FeeRequest que representan las tarifas que se aplicarán al enlace de pago.

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.

lineItemObjectIds
string[]
requerido

Un conjunto de ID de objetos de elementos de pedido asociados al enlace de pago, cada uno representado como una cadena.

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

Un conjunto de elementos de pedido, que pueden ser personalizadas, de un producto o clonadas, según lo definan sus respectivos esquemas.

El nombre del enlace de pago. Es un valor de cadena.

state
enum<string>
requerido

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

Opciones disponibles:
OFF,
ON
taxObjectIds
string[]
requerido

Un conjunto de ID de cadena que representan objetos de impuestos asociados con el enlace de pago.

taxes
object[]
requerido

Un conjunto de objetos TaxRequest, cada uno representando un impuesto asociado al enlace de pago.

automatedSalesTaxEnabled
boolean

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

businessUnitId
string

Una cadena que representa el ID de la unidad de negocio asociada al enlace de pago.

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
dealConfigurations
object
descriptionHtml
string

Una cadena que contiene la descripción HTML del enlace de pago.

discount
object
discountCodeEnabled
boolean

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

discountObjectId
string

Una cadena que representa el ID de objeto de un descuento asociado con el enlace de pago.

domainId
string

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

storePaymentMethodAtCheckout
boolean

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

successUrl
string

Una cadena que define la URL a la que se hará redireccionamiento tras un pago exitoso.

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