Leia a transação como um conjunto
status descreve o andamento da jornada. decision expressa pending, approved ou rejected. decision_reason, quando presente, acrescenta o motivo documentado. Consulte a referência para o objeto completo e os enums vigentes; não infira a decisão apenas pelo nome de uma etapa.
| Cenário | Tratamento no seu sistema |
| --- | --- |
| created e etapas intermediárias | Mantenha o processo pendente |
| manual_review_pending | Aguarde o resultado da revisão; não libere como aprovado |
| approved com decision=approved | Aplique suas regras para continuar o processo |
| rejected com decision=rejected | Trate a recusa conforme seu procedimento |
| expired | Encerre ou reinicie o processo conforme sua política |
Estados como liveness_passed ou document_passed descrevem uma etapa concluída e não substituem a decisão final. Uma conexão interrompida também não é evidência de rejeição ou aprovação.
Sincronize sua decisão de negócio
Armazene a relação entre seu processo e a transação. Ao receber um evento, valide a origem, reconheça duplicidades e consulte o estado atual antes de executar efeitos irreversíveis. Eventos antigos não devem rebaixar uma decisão mais recente por ordem de chegada.
A aprovação de KYC não determina aprovação de crédito, ausência de fraude em uma compra ou validade de poderes de representação. Essas análises continuam na sua operação. Confira reentrega e reconciliação e teste todos esses cenários no simulador.