These docs are for v4. 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:

TagPadrãoDescrição
amount
Valor da transação (em centavos) a ser transacionado pelo Checkout. Ex: R$14,79 = 1479
Tipo: integer
buttonTextPagarTexto do botão de pagamento.
Tipo: string
buttonClass
Classe CSS a ser adicionada no botão de pagamento.
Tipo: string
customerDatatrueCaso não deseje capturar dados do cliente pelo Checkout, setar como false.
Tipo: boolean
reviewInformationsfalseMostra os dados inseridos pelo cliente para revisão no formulário do checkout.Para que isso aconteça, o campo customerData precisa estar como true e os objetos customer, billing e shipping precisam estar presentes no JSON de dados do checkout.Tipo: boolean
paymentMethodscredit_card, boleto, pixMeios de pagamento disponíveis no Checkout.
Tipo: string
card_brandselo, amex, diners, jcb, hipercard, visa, aura, discover, mastercardVocê deve especificar aqui quais bandeiras quer aceitar.
Tipo: string
maxInstallments1Nú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#1a6ee1Cor 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
createTokentrueHabilita 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
customer
Informações do cliente
Tipo: object
customer.external_id
Número de identificação do cliente na loja
Tipo: string
customer.name
Nome do cliente
Tipo: string (Obrigatório)
customer.type
Tipo de cliente (individual ou corporation)
Tipo: string
customer.country
País de origem do cliente
Tipo: string
customer.email
Email do cliente
Tipo: string (Obrigatório)
customer.documents
Lista de documentos do cliente
Tipo: array (Obrigatório)
customer.documents.type
Tipo do documento (CPF ou CNPJ)
Tipo: string (Obrigatório)
customer.documents.number
Número do documento
Tipo: string (Obrigatório)
customer.phone_numbers
Lista de telefones do cliente
Tipo: array
customer.birthday
Data de nascimento do cliente
Tipo: string
billing
Informações de cobrança (obrigatório em caso de createToken:true e customerData:false)
Tipo: object
billing.name
Nome da entidade de cobrança
Tipo: string
billing.address
Dados de endereço de cobrança
Tipo: object
billing.address.street
Rua
Tipo: string
billing.address.street_number
Número
Tipo: string
billing.address.zipcode
CEP
Tipo: string
billing.address.country
País. Deve seguir o padão ISO 3166-1 alpha-2
Tipo: string
billing.address.state
Estado
Tipo: string
billing.address.city
Cidade
Tipo: string
billing.address.neighborhood
Bairro
Tipo: string
billing.address.complementary
Complemento. Não deve ser uma string vazia nem null.
Tipo: string
shipping
Informações de entrega (obrigatório quando há bens físicos entre os itens vendidos)
Tipo: object
shipping.name
Nome do comprador
Tipo: string
shipping.fee
Taxa de envio cobrada do comprador. Por exemplo, se a taxa de envio é de dez reais e três centavos (R$10,03), o valor deve ser fornecido como ‘1003’
Tipo: integer
shipping.address
Dados de endereço de cobrança
Tipo: object
shipping.address.street
Rua
Tipo: string
shipping.address.street_number
Número
Tipo: string
shipping.address.zipcode
CEP
Tipo: string
shipping.address.country
País. Deve seguir o padão ISO 3166-1 alpha-2
Tipo: string
shipping.address.state
Estado
Tipo: string
shipping.address.city
Cidade
Tipo: string
shipping.address.neighborhood
Bairro
Tipo: string
shipping.address.complementary
Complemento. Não deve ser uma string vazia nem null.
Tipo: string
items
Itens comprados
Tipo: array
item.id
Número de identificação na loja
Tipo: string
item.title
Nome do item vendido
Tipo: string
item.unit_price
Valor unitário em centavos
Tipo: integer
item.quantity
Número de unidades vendidas
Tipo: integer
item.tangible
Caracteriza o produto como bem físico ou não. Por bem físico, entende-se produtos que devem ser enviados fisicamente ao comprador, como calçados, eletrônicos e brinquedos. Se for um bem físico deve conter true (sim), caso contrário, deve conter false (não)
Tipo: string
headerTextTotal 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
paymentButtonTextPagarDefine o texto do botão final de pagamento.
Tipo: string
boletoDiscountPercentage
Define a porcentagem de desconto no boleto.
Tipo: number
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
pixExpirationDate
Define a data de validade do PIX. Ex.: '2021-12-31' ou '2021-12-31T23:59:59'
Tipo: string
creditCardDiscountPercentage
Define a porcentagem de desconto na primeira parcela de cartão de crédito (pagamento à vista).
Tipo: number
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

Todos esses parâmetros adicionais são passados no momento que o checkout é aberto (checkout.open), segue exemplo:

<script>
checkout.open({
  paymentButtonText: 'Finalizar',
  amount: 10000,
  maxInstallments: 12,
  defaultInstallment: 1,
  customerData: 'true',
  createToken: 'true',
  paymentMethods: 'boleto,credit_card',
  uiColor: '#1ea51c',
  boletoDiscountPercentage: 0,
  boletoExpirationDate: '12/12/2020',
  postbackUrl: "postback-cool.com",
  items: [{
    id: '1',
    title: 'ItemZero',
    unit_price: 10000,
    quantity: 1,
    tangible: 'false'
  }]
});

</script>
👍

Exemplo do Checkout

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


Próximo