Ciclo de vida das transações

Cada transação passa por diferentes status definidos com base em dois parâmetros:

• status : status simplificado da transação
• detailedStatus : status detalhado da transação

Parâmetro status

O parâmetro status contém o status simplificado da transação:

• Permite simplesmente saber se a transação foi paga ou não,
• Permanece o mesmo seja qual for o meio de pagamento.

Os diferentes valores possíveis estão apresentados no quadro abaixo. Se a coluna FIN estiver assinalada, o status da transação não poderá mais mudar sem uma ação específica do Estabelecimento Comercial (como cancelamento).

status	Descrição	fim
PAID	A transação foi paga.	✔
RUNNING	O processamento da transação está em andamento
UNPAID	A transação não foi paga.	✔
ABANDONED	A transação não foi criada e portanto não está exibida no bom.	✔

Parâmetro detailedStatus

O parâmetro detailedStatus fornece informações detalhadas sobre o status do pagamento. Cada um dos status é restrito ao meio de pagamento usado.

detailedStatus	status	Descrição	fim
ACCEPTED	PAID	Status de uma transação de tipo VERIFICATION cuja autorização ou solicitação de informação foi aceita. Este status não pode evoluir. As transações com o status “ACCEPTED” nunca são capturadas no banco. Uma transação de tipo VERIFICATION é criada quando atualizar ou criar um Token sem pagamento.	✔
AUTHORISED	PAID	O valor é autorizado e vai ser capturado automaticamente.
CAPTURED	PAID	O valor da transação foi autorizado.	✔
PRE_AUTHORISED	PAID	Status de uma transação de tipo PRE_AUTHORISATION cuja autorização foi aceita. Este status não pode evoluir. As transações com o status “PRE_AUTHORISED” nunca são capturadas no banco.	✔
AUTHORISED_TO_VALIDATE	RUNNING	A transação, criada em validação manual, está autorizada. O Estabelecimento Comercial deve validar manualmente a transação para lançar a solicitação de autorização e a captura no banco. Pode-se validar a transação enquanto a data de vencimento da solicitação de autorização não for ultrapassada. Se esta data está vencida, então o pagamento tem o status EXPIRED. O status Vencido é definitivo.
WAITING_AUTHORISATION	RUNNING	A transação ainda não foi autorizada porque o prazo de captura é superior ao tempo de validade da autorização. A solicitação de autorização será automaticamente efetuada a D-1 antes da data de captura no banco. A captura no banco será automática.
WAITING_AUTHORISATION_TO_VALIDATE	RUNNING	O meio de pagamento foi verificado mas a transação ainda não foi autorizada porque o prazo de captura é superior ao prazo de validade da autorização A solicitação de autorização será inciada automaticamente em D-1 antes da data de captura no banco. Uma intervenção manual será necessária para confirmar a autorização Nada garante que a solicitação de autorização seja aceita.
WAITING_FOR_PAYMENT	RUNNING	A transação foi criada em pagamento pendente. Este status não é definitivo.
UNDER_VERIFICATION	RUNNING	Aguardando resposta do comprador. Este status é temporário. Para as transações Paypal, este valor significa que Paypal segura a transação por causa de uma suspeita de fraude.
PENDING	RUNNING	Reembolso : O reembolso está em andamento . Marketplace : O pagamento foi feito com sucesso. A ou as transações correspondentes são criadas e com captura em andamento, ou eventualmente à espera de uma validação manual.
INITIAL	RUNNING	Este status é temporário. É retornado se nenhuma resposta for recebida do adquirente ou o prazo de resposta do 'adquirente ultrapassa o tempo da sessão do pagamento na plataforma de pagamento.
REFUSED	UNPAID	A transação foi recusada.	✔
ERROR	UNPAID	Ocorreu um erro não esperado.	✔
CAPTURE_FAILED	UNPAID	A captura da transação falhou. Entrar em contato com o Suporte.	✔
CANCELLED	UNPAID	A transação foi cancelada.	✔
EXPIRED	UNPAID	A transação venceu (o Estabelecimento Comercial não validou a transação dentro do prazo).	✔

Transação e pedido

Durante a criação de uma transação, esta fica encapsulada no objeto de alto nível: o objeto Payment. Este objecto contém diferentes estatutos na encomenda, assim como uma lista de transacções.

O status do pedido é definido a partir dos dois parâmetros seguintes:

• orderCycle : pode valer OPEN ou CLOSED.
• orderStatus : consolidação do parâmetro status das transações associadas ao pedido.

Para maiores detalhes, consultar: Referência de objeto Pagamento.