Pular para o conteúdo principal
PATCH
Atualizar um link de pagamento

Supported products

Parâmetros de caminho

O identificador exclusivo do link de pagamento a ser atualizado.

Corpo

application/json
businessUnitId
object
obrigatório

Um objeto que representa o ID da unidade de negócio associado ao link de pagamento.

dealConfigurations
object
obrigatório

Um objeto que contém as configurações de um negócio.

descriptionHtml
object
obrigatório

Um objeto que contém a descrição HTML do link de pagamento.

discountObjectId
object
obrigatório

Um objeto que representa o ID do objeto de desconto associado ao link de pagamento.

domainId
object
obrigatório

Um objeto que representa o ID do domínio associado ao link de pagamento.

expirationSettings
object
obrigatório

Um objeto que representa as configurações de expiração do link de pagamento.

successUrl
object
obrigatório

Um objeto que representa o URL de sucesso para onde o usuário é redirecionado após uma transação bem-sucedida.

acceptedPaymentMethods
enum<string>[]

Uma matriz de strings que indica os métodos de pagamento aceitos. Os valores válidos incluem "CREDIT_OR_DEBIT_CARD", "ACH", "SEPA", "BACS" e "PADS".

Opções disponíveis:
CREDIT_OR_DEBIT_CARD,
ACH,
SEPA,
BACS,
PADS,
AFFIRM,
KLARNA
additionalFormFields
object[]

Uma matriz de objetos PaymentLinkFormField que representam campos de formulário adicionais para o link de pagamento.

automatedSalesTaxEnabled
boolean

Um booleano que indica se o imposto de vendas automatizado está ativado.

collectFullBillingAddress
boolean

Um booleano que indica se o endereço de cobrança completo deve ser coletado durante o checkout.

collectShippingAddress
boolean

Um valor booleano que indica se o endereço de entrega deve ser coletado durante o checkout.

createContractOnPurchase
boolean

Um booleano que indica se um contrato deve ser criado no momento da compra.

currencyCode
string

O código da moeda para o link de pagamento, representado como uma string.

discount
object
discountCodeEnabled
boolean

Um booleano que indica se os códigos de desconto estão ativados para o link de pagamento.

enableDefaultCheckoutFees
boolean

Um booleano indicando se as taxas de checkout padrão estão ativadas.

feeObjectIds
string[]

Uma matriz de strings que representam os IDs de objetos de taxas associados ao link de pagamento.

fees
object[]

Uma matriz de objetos FeeRequest que representam as taxas associadas ao link de pagamento.

includeEmailInSuccessRedirect
boolean

Um valor booleano que indica se o e-mail deve ser incluído no redirecionamento bem-sucedido.

isOneTimeUseEnabled
boolean

Um booleano que indica se o link de pagamento está ativado para uso único.

lineItemObjectIds
string[]

Uma matriz de strings que representam os IDs de objetos de item de linha associados ao link de pagamento.

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

Uma matriz de objetos de item de linha, que podem ser dos tipos LineItemCustomCreateRequest, LineItemFromProductCreateRequest ou LineItemCloneCreateRequest.

O nome do link de pagamento, representado como uma string.

state
enum<string>

O status do link de pagamento, representado como uma string. Os valores válidos são "ON" e "OFF".

Opções disponíveis:
OFF,
ON
storePaymentMethodAtCheckout
boolean

Um booleano que indica se o método de pagamento deve ser armazenado no checkout.

taxObjectIds
string[]

Uma matriz de strings que representam os IDs de objetos de imposto associados ao link de pagamento.

taxes
object[]

Uma matriz de objetos TaxRequest que representam os impostos associados ao link de pagamento.

Resposta

successful operation

acceptedPaymentMethods
enum<string>[]
obrigatório

Uma matriz de métodos de pagamento aceitos para o link de pagamento. Os valores válidos incluem "CREDIT_OR_DEBIT_CARD", "ACH", "SEPA", "BACS" e "PADS".

Opções disponíveis:
CREDIT_OR_DEBIT_CARD,
ACH,
SEPA,
BACS,
PADS,
AFFIRM,
KLARNA
additionalFormFields
object[]
obrigatório

Uma matriz de campos de formulário adicionais incluídos no link de pagamento.

archived
boolean
obrigatório

Um booleano que indica se o link de pagamento está arquivado.

automatedSalesTaxEnabled
boolean
obrigatório

Um booleano que indica se o imposto de vendas automatizado está ativado para o link de pagamento.

checkoutFeeIds
string[]
obrigatório

Uma matriz de IDs de taxas de checkout associadas ao link de pagamento.

collectFullBillingAddress
boolean
obrigatório

Um booleano que indica se o endereço de cobrança completo deve ser coletado durante o checkout.

collectShippingAddress
boolean
obrigatório

Um valor booleano que indica se o endereço de entrega deve ser coletado durante o checkout.

completedPurchaseCount
integer<int32>
obrigatório

O número de compras concluídas feitas por meio deste link de pagamento.

createContractOnPurchase
boolean
obrigatório

Um booleano que indica se um contrato deve ser criado no momento da compra.

currencyCode
string
obrigatório

O código da moeda para o link de pagamento, representado como uma string.

discountCodeEnabled
boolean
obrigatório

Um booleano que indica se os códigos de desconto estão ativados para o link de pagamento.

discounts
object[]
obrigatório

Uma matriz de objetos de desconto associados ao link de pagamento.

fees
object[]
obrigatório

Uma matriz de objetos de taxa associados ao link de pagamento.

formGuid
string
obrigatório

O GUID do formulário associado ao link de pagamento, representado como uma string.

id
string
obrigatório

O identificador exclusivo do link de pagamento, representado como uma string.

includeEmailInSuccessRedirect
boolean
obrigatório

Um booleano que indica se o e-mail deve ser incluído no URL de redirecionamento bem-sucedido.

isOneTimeUseEnabled
boolean
obrigatório

Um booleano que indica se o link de pagamento está ativado para uso único.

lineItems
object[]
obrigatório

Uma matriz de itens de linha associados ao link de pagamento.

O nome do link de pagamento, representado como uma string.

O URL do link de pagamento, representado como uma string.

state
enum<string>
obrigatório

O estado atual do link de pagamento, representado como uma string. Os valores válidos incluem "ON" e "OFF".

Opções disponíveis:
OFF,
ON
storePaymentMethodAtCheckout
boolean
obrigatório

Um booleano que indica se o método de pagamento deve ser armazenado no checkout.

taxes
object[]
obrigatório

Uma matriz de objetos de impostos associados ao link de pagamento.

archivedAt
string<date-time>

A data e a hora em que o link de pagamento foi arquivado, no formato ISO 8601.

businessUnitId
string

O ID da unidade de negócio associada ao link de pagamento, representado como uma string.

createdAt
string<date-time>

A data e a hora em que o link de pagamento foi criado, no formato ISO 8601.

dealConfigurations
object
descriptionHtml
string

A descrição HTML do link de pagamento, representada como uma string.

domainId
string

O ID de domínio associado ao link de pagamento, representado como uma string.

expirationSettings
object
successUrl
string

O URL ao qual redirecionar após o pagamento bem-sucedido, representado como uma string.

updatedAt
string<date-time>

A data e a hora da última atualização do link de pagamento, no formato ISO 8601.

Última modificação em 6 de outubro de 2026