API Reference
Log In

Cancela um checkout

Este endpoint tem como objetivo fazer o cancelamento de um checkout. O checkout não é deletado de fato do sistema, apenas é alterado o status para cancelado

📘

INFO
Se o checkout já tiver sido pago, estiver expirado ou já estiver cancelado, não será possível fazer o cancelamento

Respostas das requisições

VariávelTipoDescrição
checkoutIdBigIntegerIdentificador do link de pagamento
expirationDateLocalDateTimeData-hora da expiração do checkout representado yyyy-MM-dd HH:mm:ss
totalValueBigIntegerValor total do link de pagamento
statusCheckout.StatusStatus do link de pagamento
urlStringLink para pagamento de um checkout
maxInstallmentsIntegerNúmero máximo de parcelas que aquele checkout pode ter
paymentOptionsList<.PaymentOption>Lista com as opções de pagamento (se existirem)
maxPaymentsIntQuantidade máxima de pagamentos que o checkout pode ter
currentPaymentsIntQuantidade de vezes que o checkout já foi pago
paymentsList<.Payment>Lista com os pagamentos realizados para um checkout
orderStringNúmero de ordem de um checkout (o mesmo enviado na requisição de criação)

Checkout.Status​
Os status de um checkout podem ser:

  • PAYED - Se um checkout já foi pago completamente (todos os pagamentos já forem realizados)
  • PENDING - Status pendente aguardando pagamento
  • EXPIRED - Status expirado (quando passou a data de vencimento e não foi pago)
  • CANCELED - Status cancelado para quando um cliente deeseja cancelar o checkout
  • PROCESSING - Status para quando a transação está sendo processada (cliente inserindo dados da transação). Normalmente utilizado para que não aconteça a troca do token durante a opperação de pagamento, evitando erro.
  • BLOCKED - Status usado quando um checkout é bloqueado dado um lojista bloqueado

PaymentOption​
Opções de pagamento que podem aparecer na listagem:

  • MULTI_PAYMENT - Essa forma de pagamento permite um link ser pago mais de uma vez. Para mais detalhes sobre formas de pagamento, visite a página inicial da API de checkout.

Payment

VariávelTipoDescrição
idBigIntegerId do pagamento
payedValueBigIntegerValor pago no determinado pagamento
statusPayment.StatusStatus de um pagamento
completionDateTimeLocalDateTimeData-hora em que o pagamento foi dado como completo
transactionsList<.Transaction>Lista de transações que foram realizadas para o pagamento do ckeckout
customerCustomerCliente que realizou o determinado pagamento (diferente do portador do cartão)

Payment.Status​
Os pagamentos podem assumir os seguintes status:

  • COMPLETE - O pagamento foi realizado completamente (valor total foi pago)
  • INCOMPLETE - O pagamento está incompleto (valor total ainda não foi pago)
  • PROCESSING - O pagamento está sendo processado

Customer

VariávelTipoDescrição
nameStringNome do cliente ao qual pertence o pagamento
phoneStringTelefone do cliente
emailStringEmail do cliente no formato de email válido
legalDocumentStringDocumento legal do cliente ao qual pertence o pagamento
addressAddressDados de endereço do cliente

Transaction

VariávelTipoDescrição
idBigIntegerId da transação
localCodeStringCódigo identificador da transação para possível cancelamento
statusTransaction.StatusStatus da transação
installmentsIntQuantidade de parcelas em que a transação ocorreu
valueBigIntegerValor da transação
dateTimeLocalDateTimeData-hora da transação representado yyyy-MM-dd HH:mm:ss
Language
Authorization
Header
Click Try It! to start a request and see the response here!