A Trio utiliza webhooks para enviar atualizações de maneira assíncrona sobre os endpoints de uma Connection.

O webhook pode ser configurado através do dashboard.

Em cada notificação a Trio executa um POST com um payload no format JSON na URL cadastrada. Se a resposta da requisição não retornar o código 2XX, faremos mais 3 tentativas com alguns minutos de diferença entre elas.

Eventos

Todas as notificações disparados na Trio seguem um padrão de acordo com o exemplo abaixo:

{
  "id": "aadf41a1fc8e4f79a49f7f04027ac999",
  "category": "BALANCES",
  "code": "balances_updated",
  "connection_id": "439b3caa-06dd-416b-aee0-cb9501789123",
  "status": "completed", //completed or failed
  "data": {}, //when completed with success
  "error": {} //when failed
}

Balances

Com os webhooks vinculados a Balance é possível receber notificações sempre que houver uma atualização de saldo na instituição financeira.

Atualização do saldo

Você receberá o hook balances_updated toda a vez que um processo de atualização na instituição financeira for concluído e receberá um payload como este:

{
  "id": "aadf41a1fc8e4f79a49f7f04027ac999",
  "category": "BALANCES",
  "code": "balances_updated",
  "connection_id": "439b3caa-06dd-416b-aee0-cb9501789123",
  "status": "completed",
  "data": {
    "balance": 1233
  }
}

Se durante a atualização acontecer algum erro por falha de autenticação ou indisponibilidade você receberá uma resposta como esta:

{
  "id": "aadf41a1fc8e4f79a49f7f04027ac999",
  "category": "BALANCES",
  "code": "balances_updated",
  "connection_id": "439b3caa-06dd-416b-aee0-cb9501789123",
  "status": "failed",
  "error": {
    "code":"unexpected_error",
    "message":"Unexpected error occurred"
  }
}

Transactions

Com os webhooks vinculados a Transaction é possível receber notificações sempre que houver uma atualização das transações na instituição financeira ou integração recorrente.

Atualização das transações

Você receberá o hook transactions_updated toda a vez que um processo de atualização na instituição financeira for concluído e receberá um payload como este:

{
  "id": "aadf41a1fc8e4f79a49f7f04027ac999",
  "category": "TRANSACTIONS",
  "code": "transactions_updated",
  "connection_id": "439b3caa-06dd-416b-aee0-cb9501789123",
  "status": "completed",
  "data": {
    "total_transactions": 123
  }
}

Se durante a atualização acontecer algum erro por falha de autenticação ou indisponibilidade você receberá uma resposta como esta:

{
  "id": "aadf41a1fc8e4f79a49f7f04027ac999",
  "category": "TRANSACTIONS",
  "code": "transactions_updated",
  "connection_id": "439b3caa-06dd-416b-aee0-cb9501789123",
  "status": "failed",
  "error": {
    "code":"unexpected_error",
    "message":"Unexpected error occurred"
  }
}

Did this page help you?