These docs are for v2. Click to read the latest docs for v5.

Configurações do Checkout

❗️

Você está na versão correta da documentação?

Verifique na sua Dashboard a versão da API que você está usando. Você deve usar a documentação correspondente. Para saber mais, veja: Versionamento.

O checkout possui diversos outros campos de customização que podem ser passados na sua construção. Segue um overview de todos parâmetros possíveis:

Configurações da versão formulário

Tag

Padrão

Descrição

data-encryption-key


Chave de encriptação disponível na sua Dashboard.
Tipo: string

data-amount


Valor da transação (em centavos) a ser capturada pelo Checkout. Ex: R$14,79 = 1479
Tipo: integer

data-button-text

Pagar

Texto mostrado no botão de pagamento.
Tipo: string

data-button-class


Classe CSS a ser adicionada no botão de pagamento.
Tipo: string

data-boleto-discount-amount


Valor, em centavos, do desconto caso o meio de pagamento seja boleto. Ex: desconto de R$10,00 = 1000. OBS: você não pode adicionar essa tag caso a tag de desconto percentual já esteja presente.
Tipo: integer

data-boleto-discount-percentage


Percentual de desconto caso o meio de pagamento seja boleto. Ex: desconto de 25% = 25. OBS: você não pode adicionar essa tag caso a tag de desconto por valor já esteja presente.
Tipo: integer

data-boleto-helper-text


Mensagem opcional que aparece embaixo do botão de pagamento Boleto.
Tipo: string

data-credit-card-helper-text


Mensagem opcional que aparece embaixo do botão de pagamento Cartão de Crédito.
Tipo: string

data-payment-methods

credit_card, boleto

Meios de pagamento disponíveis no Checkout.
Tipo: string

data-card-brands

elo, amex, diners, jcb, hipercard, visa, aura, discover, mastercard

Você deve especificar aqui quais bandeiras quer aceitar.
Tipo: string

data-default-installment


Número de parcelas que virá selecionado ao abrir o checkout
Tipo: integer

data-max-installments

1

Número máximo de parcelas aceitas, de 1 a 12.
Tipo: integer

data-min-installments


Número mínimo de parcelas aceitas, de 1 a 12.
Tipo: integer

data-ui-color

#1a6ee1

Cor primária da interface de Checkout.
Tipo: string

data-postback-url


Endereço da URL de postback do seu sistema, que recebe as notificações das alterações de status das transações
Tipo: string

data-create-token

true

Habilita a geração do token para autorização da transação.
OBS: Caso você queira apenas pegar os dados do cliente, deixe esse atributo com o valor false, e realize a transação normalmente no seu backend, com os dados informados no formulário do Checkout.
Tipo: boolean

data-customer-data

true

Habilita os campos de endereço, telefone, nome e email do cliente. Caso você não queira capturar estes dados pelo Checkout, configure como false.
Tipo: boolean

data-customer-name


Nome do cliente (Obrigatório)
Tipo: string

data-customer-document-number


CPF ou CNPJ do cliente (Obrigatório)
Tipo: string

data-customer-email


E-mail do cliente (Obrigatório)
Tipo: string

data-customer-address-street


Nome do logradouro do cliente
Tipo: string

data-customer-address-street-number


Número do imóvel do cliente
Tipo: integer

data-customer-address-complementary


Complemento do endereço do cliente
Tipo: string

data-customer-address-neighborhood


Bairro do cliente
Tipo: string

data-customer-address-city


Cidade do cliente
Tipo: string

data-customer-address-state


Estado (unidade federativa) do cliente
Tipo: string

data-customer-address-zipcode


Código de endereçamento postal (CEP) da cidade do cliente
Tipo: string

data-customer-phone-ddd


DDD do telefone do cliente
Tipo: integer

data-customer-phone-number


Número do telefone do cliente
Tipo: integer

data-disable-zero-document-number

false

Não aceita CPF ou CNPJ em que todos os números são zeros
Tipo: boolean

data-interest-rate


Taxa de juros a ser cobrada na transação.

  • *OBS**: Apenas para cartão de crédito.
    Tipo: integer

data-free-installments


Número de parcelas que não terão juros cobrados
Tipo: integer

data-default-installment

1

Define a parcela padrão selecionada ao abrir o Checkout
Tipo: integer

data-header-text

Total a pagar {price_info}

Define o texto do cabeçalho.
OBS: Você pode utilizar a variável {price_info} para injetar o valor do pagamento no texto.
Tipo: string

data-payment-button-text

Pagar

Define o texto mostrado no botão de confirmação de pagamento.
Tipo: string

Configurações da versão API

Tag

Padrão

Descrição

amount


Valor da transação (em centavos) a ser capturada pelo Checkout. Ex: R$14,79 = 1479
Tipo: integer

buttonText

Pagar

Texto mostrado no botão de pagamento.
Tipo: string

buttonClass


Classe CSS a ser adicionada no botão de pagamento.
Tipo: string

customerData

true

Caso não queira capturar dados do cliente pelo Checkout, configurar como false.
Tipo: boolean

paymentMethods

credit_card, boleto

Meios de pagamento disponíveis no Checkout.
Tipo: string

card_brands

elo, amex, diners, jcb, hipercard, visa, aura, discover, mastercard

Você deve especificar aqui quais bandeiras quer aceitar.
Tipo: string

maxInstallments

1

Número máximo de parcelas aceitas, de 1 a 12.
Tipo: integer

defaultInstallments


Número de parcelas que virá selecionado ao abrir o checkout
Tipo: integer

minInstallments


Número mínimo de parcelas aceitas, de 1 a 12.
Tipo: integer

freeInstallments


Quantidade de parcelas onde não haverá cobrança de juros
Tipo: integer

interestRate


Percentual de juros que serão aplicados a partir de uma determinada parcela
Tipo: decimal

uiColor

#1a6ee1

Cor primária da interface de Checkout.
Tipo: string

postbackUrl


Endereço da URL de postback do seu sistema, que receberá as notificações das alterações de status das transações
Tipo: string

createToken

"true"

Habilita a geração do token para autorização da transação.
Obs.: Caso você deseje apenas utilizar o checkout como formulário, deixe esse atributo com o valor false, e realize a transação normalmente no seu backend.
Tipo: boolean

customerName


Nome do cliente (Obrigatório)
Tipo: string

customerDocumentNumber


CPF ou CNPJ do cliente (Obrigatório)
Tipo: string

customerEmail


E-mail do cliente (Obrigatório)
Tipo: string

customerAddressStreet


Nome do logradouro do cliente
Tipo: string

customerAddressStreetNumber


Número do imóvel do cliente
Tipo: integer

customerAddressComplementary


Complemento do endereço do cliente
Tipo: string

customerAddressNeighborhood


Bairro do cliente
Tipo: string

customerAddressCity


Cidade do cliente
Tipo: string

customerAddressState


Estado (unidade federativa) do cliente
Tipo: string

customerAddressZipcode


Código de endereçamento postal (CEP) da cidade do cliente
Tipo: string

customerPhoneDdd


DDD do telefone do cliente
Tipo: integer

customerPhoneNumber


Número do telefone do cliente
Tipo: integer

disableZeroDocumentNumber

"false"

Não aceita CPF ou CNPJ em que todos os números são zeros
Tipo: boolean

interestRate


Taxa de juros a ser cobrada na transação
Tipo: integer

headerText

Total a pagar {price_info}

Define o texto do cabeçalho.
OBS: Você poderá utilizar a variável {price_info} para injetar o valor do pagamento no texto.
Tipo: string

paymentButtonText

Pagar

Define o texto do botão final de pagamento.
Tipo: string

boletoDiscountPercentage


Define a porcentagem de desconto no boleto.
Tipo: integer

boletoDIscountAmount


Define o valor de desconto (em centavos) no boleto. Ex: R$10.00 de desconto = 1000.
Tipo: integer

boletoExpirationDate


Define a data de validade do boleto. Ex.: '20/12/2020'
Tipo: string

creditCardDiscountPercentage


Define a porcentagem de desconto na primeira parcela de cartão de crédito (pagamento à vista).
Tipo: integer

creditCardDiscountAmount


Define o valor de desconto (em centavos) na primeira parcela de cartão de crédito (pagamento à vista). Ex: R$10.00 de desconto = 1000.
Tipo: integer

👍

Exemplo do Checkout

É possível testar os parâmetros que irá utilizar clicando aqui.