Status - OriPay API

Cobrança (`charge`)

Status	Significa	Final?
`active`	QR válido, aguardando pagamento	Não
`paid`	Pago e creditado na sua conta	Sim
`expired`	Venceu sem pagamento	Sim

Transferência (`transfer`)

Status	Significa	O que fazer
`pending`	Enviado, aguardando liquidação	Esperar o webhook. Não reenviar
`completed`	Dinheiro chegou no destino	Dar baixa
`failed`	Recusado; o valor voltou ao seu saldo	Ver `failure_reason`
`returned`	O banco do recebedor devolveu depois de liquidar	Valor volta ao saldo; evento `transfer.returned`

pending pode durar de segundos a algumas horas. Só confirmamos depois de conferir o extrato do banco. Nunca trate pending como falha e nunca reenvie com outra Idempotency-Key.

Devolução (`refund`)

pending → completed | failed. Um failed não tira dinheiro da sua conta.

PIX recebido (`received`)

Aparece só depois de creditado e conferido no extrato: status único credited.