Cancela um checkout

POST https://sandbox.staging.justa.com.vc/payment-provider/api/checkout/{checkout-id}

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ável	Tipo	Descrição
checkoutId	BigInteger	Identificador do link de pagamento
expirationDate	LocalDateTime	Data-hora da expiração do checkout representado yyyy-MM-dd HH:mm:ss
totalValue	BigInteger	Valor total do link de pagamento
status	Checkout.Status	Status do link de pagamento
url	String	Link para pagamento de um checkout
maxInstallments	Integer	Número máximo de parcelas que aquele checkout pode ter
paymentOptions	List<.PaymentOption>	Lista com as opções de pagamento (se existirem)
maxPayments	Int	Quantidade máxima de pagamentos que o checkout pode ter
currentPayments	Int	Quantidade de vezes que o checkout já foi pago
payments	List<.Payment>	Lista com os pagamentos realizados para um checkout
order	String	Nú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ável	Tipo	Descrição
id	BigInteger	Id do pagamento
payedValue	BigInteger	Valor pago no determinado pagamento
status	Payment.Status	Status de um pagamento
completionDateTime	LocalDateTime	Data-hora em que o pagamento foi dado como completo
transactions	List<.Transaction>	Lista de transações que foram realizadas para o pagamento do ckeckout
customer	Customer	Cliente 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ável	Tipo	Descrição
name	String	Nome do cliente ao qual pertence o pagamento
phone	String	Telefone do cliente
email	String	Email do cliente no formato de email válido
legalDocument	String	Documento legal do cliente ao qual pertence o pagamento
address	Address	Dados de endereço do cliente

Transaction

Variável	Tipo	Descrição
id	BigInteger	Id da transação
localCode	String	Código identificador da transação para possível cancelamento
status	Transaction.Status	Status da transação
installments	Int	Quantidade de parcelas em que a transação ocorreu
value	BigInteger	Valor da transação
dateTime	LocalDateTime	Data-hora da transação representado yyyy-MM-dd HH:mm:ss