O Que É Uma Transferência

Conceito

Oferecemos uma API de Transferências, na qual permite-se efetuar a movimentação de fundos entre contas bancárias, podendo ser:

• Transferência interna: Transferência entre duas Contas Stone. O valor transferido é creditado instantaneamente na conta destinatária, independente do horário e dia da efetuação da transação.

• Transferência externa: TED (Transferência Eletrônica Disponível) para outros bancos. Nos dias úteis, entre 6:30 e 17:23, a transação é processada de forma assíncrona e o valor é creditado na conta destino em poucas horas. Caso a operação seja efetuada fora do horário citado e/ou em dias não úteis, a transação será agendada automaticamente para o dia útil seguinte.

Status

Segue abaixo os status possíveis de uma transferência externa:

A transferência externa criada pela parceira aguardará a aprovação do usuário da conta no estado CREATED. Essa transferência pode ser rejeitada pela usuário, concluindo no estado REJECTED, e não será efetuada. Caso ela seja uma transferência agendada, é possível que o prazo do agendamento expire antes dela obter aprovação, encerrando em EXPIRED.

Caso ela seja agendada e aprovada dentro do prazo, seguirá para o estado SCHEDULED, e será efetuada na data do agendamento. É importante observar que caso a criação da transferência externa, tanto pelo parceiro quanto pelo usuário, seja feita fora do horário de 6:30 às 17:23, ela seguirá para um estado de DELAYED_TO_NEXT_BUSINESS_DAY, em que ela será agendada para a próxima janela de execução. É possível que o usuário cancele a transferência antes dela ser efetuada, encerrando no estado CANCELLED.

Quando é o próprio usuário que cria a transação, o fluxo já se inicia no estado APPROVED ou SCHEDULED, caso tenha sido criada com agendamento. A transferência poderá falhar apenas caso não haja fundos e terminará no estado FAILED. Caso tenha sido aprovada e haja fundos, a Stone realizará a transferência para o banco externo, obtendo o estado FINISHED. Caso haja algum problema como, por exemplo, dados incorretos, ele será reembolsado e irá finalizar no estado REFUNDED.

Para a transferência interna o fluxo é similar. Neste caso não haverá o estado REFUNDED, já que antes de realizar a transferência já conferimos a existência da conta destino. Não haverá também o estado DELAYED_TO_NEXT_BUSINESS_DAY, porque não há limites de horário para a realização de transferências para outras contas Stone.

É possível consultar o status de uma transação a qualquer momento para saber em qual estado ela está.

Segue abaixo os status possíveis de uma transferência interna:

Falhas em transferências

Falha é qualquer erro que ocorra entre a criação e a movimentação do dinheiro na conta. Ou seja, qualquer condição que era válida no momento da criação da transferência, mas que mudou nas etapas seguintes.

A seguir listamos algumas das falhas possíveis para transações de transferência, tanto para interna quanto para externa.

Reembolsos em transferências

Reembolsos ocorrem apenas em transferências para outros bancos, já que para transferências internas conferimos a existência da conta destino antes de realizar a transferência.
Abaixo listamos algumas das razões possíveis para ocorrer reembolsos, como também seus códigos correspondentes.