Transferir para Contas Stone

Faz transferências monetárias para outra conta dentro da Stone.

A transferência pode ser agendada, através do campo scheduled_to. A data usada no campo scheduled_to deve estar entre a data next_available_execution_date e a data limite retornada no campo execution_limit_date da API de caléndario de agendamento chamada com o parâmetro operation_type=internal_transfer.

Caso a data escolhida seja menor do que next_available_execution_date, a transferência será executada imediatamente.
Caso a data seja maior que execution_limit_date, será retornado um erro 422.

A criação e o agendamento de transferências internas pode acontecer em qualquer dia (incluindo fins de semana e feriados) e em qualquer horário.


POST https://sandbox-api.openbank.stone.com.br/api/v1/internal_transfers

BODY PARAMS


amount* int32
Valor da transferência em centavos de Real, ou seja, um real fica 100.


account_id* string
Identificador da conta que está enviando a transferência.


target object
    account object
        account_code* string
        Número da conta. Padrão: ^\d+$


description string
Descrição da transação. Essa descrição será exibida tanto no extrato de quem enviou quanto de quem recebeu (limite 200 caracteres).


scheduled_to string
Formato: yyyy-mm-dd


HEADERS


x-stone-idempotency-key string
Chave de idempotência


As transferências internas estão disponíveis 24hs por dia. Elas se referem a transações entre contas Stone.

Ciclo de vida assíncrono

As transações são executadas de forma assíncrona, então receber o retorno com código 202 não significa que a transação foi executada. É possível enviar uma transação, receber 202 como retorno e logo depois ocorrer uma falha como, por exemplo, saldo insuficiente. Também é importante lembrar que a transferência precisa de uma aprovação.


Response
202 Accepted
content-type: application/json

Body


{
    "amount": 100,
    "approval_expired_at": null,
    "approved_at": "2019-08-02T18:00:27Z",
    "approved_by": "user:08807157-f8e1-439e-a2ec-154ecb4bee13",
    "cancelled_at": null,
    "created_at": "2019-08-02T18:00:27Z",
    "created_by": "user:08807157-f8e1-439e-a2ec-154ecb4bee13",
    "description": "",
    "failed_at": null,
    "failure_reason_code": null,
    "failure_reason_description": null,
    "fee": 0,
    "finished_at": null,
    "id": "c97de6a6-a35a-423d-a3df-add006a0038e",
    "rejected_at": null,
    "rejected_by": null,
    "scheduled_to": null,
    "settled_at": null,
    "status": "APPROVED",
    "target": {
        "account": {
            "account_code": "58859"
        },
        "entity": {
            "name": "Fernando Antonio"
        }
    },
    "target_account_code": "58859",
    "target_account_owner_name": "Fernando Antonio"
}

Última modificação: 02.03.2020