Pular para o conteúdo principal
POST
Criar um link de pagamento

Supported products

Corpo

application/json
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 objetos PaymentLinkFormField que representam campos de formulário adicionais a serem incluídos no link de pagamento.

currencyCode
string
obrigatório

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

enableDefaultCheckoutFees
boolean
obrigatório

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

feeObjectIds
string[]
obrigatório

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

fees
object[]
obrigatório

Uma matriz de objetos FeeRequest, representando as taxas a serem aplicadas ao link de pagamento.

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.

lineItemObjectIds
string[]
obrigatório

Uma matriz de IDs de objetos de item de linha associados ao link de pagamento, cada um representado como uma string.

lineItems
(CUSTOM · object | FROM_PRODUCT · object | CLONE · object)[]
obrigatório

Uma matriz de itens de linha, que podem ser personalizados, de um produto ou clonados, conforme definido por seus respectivos esquemas.

O nome do link de pagamento. É um valor de string.

state
enum<string>
obrigatório

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
taxObjectIds
string[]
obrigatório

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

taxes
object[]
obrigatório

Uma matriz de objetos TaxRequest, cada um representando um imposto associado ao link de pagamento.

automatedSalesTaxEnabled
boolean

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

businessUnitId
string

Uma string que representa o ID da unidade de negócios associado ao link de pagamento.

collectFullBillingAddress
boolean

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

collectShippingAddress
boolean

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

dealConfigurations
object
descriptionHtml
string

Uma string que contém a descrição HTML do link de pagamento.

discount
object
discountCodeEnabled
boolean

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

discountObjectId
string

Uma string que representa o ID de objeto de um desconto associado ao link de pagamento.

domainId
string

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

expirationSettings
object
storePaymentMethodAtCheckout
boolean

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

successUrl
string

Uma string que define o URL para redirecionar após o pagamento bem-sucedido.

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