curl -X POST 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/refresh/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.refresh_connection(
"11111111-2222-3333-4444-555555555555",
wait=True,
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.refreshConnection("11111111-2222-3333-4444-555555555555", {
wait: true,
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.RefreshConnection(ctx, "11111111-2222-3333-4444-555555555555", didit.BankRefreshConnectionParams{
Body: didit.BankRefreshRequest{
Wait: didit.Bool(true),
},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.BankRefreshConnectionParams;
import me.didit.types.BankRefreshRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().refreshConnection("11111111-2222-3333-4444-555555555555", BankRefreshConnectionParams.builder()
.wait_(true)
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->refreshConnection('11111111-2222-3333-4444-555555555555', [
'wait' => true,
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.refresh_connection(
"11111111-2222-3333-4444-555555555555",
wait: true
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.RefreshConnectionAsync("11111111-2222-3333-4444-555555555555", new BankRefreshRequest
{
Wait = true,
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"id": "d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14",
"connection_id": "5e1d2a70-6b3c-4f8e-a1d9-0c7b2e4f8a36",
"trigger": "requested",
"status": "succeeded",
"started_at": "2026-11-21T12:30:02Z",
"finished_at": "2026-11-21T12:30:09Z",
"results": [
{
"account_id": "a71f0c2e-4d85-4b1a-9e63-2f8c0d5b7a14",
"resource": "transactions",
"outcome": "succeeded",
"added": 3,
"modified": 0,
"removed": 1,
"error": null
}
],
"outcome": "succeeded",
"balances_changed": true,
"error": null
}Atualizar conexão bancária API: sincronizar agora
Endpoint da Didit para atualizar uma conexão bancária: 202 com o sync_id, ou 200 com a sincronização concluída se aguardar até 25 segundos.
curl -X POST 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/refresh/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.refresh_connection(
"11111111-2222-3333-4444-555555555555",
wait=True,
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.refreshConnection("11111111-2222-3333-4444-555555555555", {
wait: true,
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.RefreshConnection(ctx, "11111111-2222-3333-4444-555555555555", didit.BankRefreshConnectionParams{
Body: didit.BankRefreshRequest{
Wait: didit.Bool(true),
},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.BankRefreshConnectionParams;
import me.didit.types.BankRefreshRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().refreshConnection("11111111-2222-3333-4444-555555555555", BankRefreshConnectionParams.builder()
.wait_(true)
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->refreshConnection('11111111-2222-3333-4444-555555555555', [
'wait' => true,
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.refresh_connection(
"11111111-2222-3333-4444-555555555555",
wait: true
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.RefreshConnectionAsync("11111111-2222-3333-4444-555555555555", new BankRefreshRequest
{
Wait = true,
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"id": "d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14",
"connection_id": "5e1d2a70-6b3c-4f8e-a1d9-0c7b2e4f8a36",
"trigger": "requested",
"status": "succeeded",
"started_at": "2026-11-21T12:30:02Z",
"finished_at": "2026-11-21T12:30:09Z",
"results": [
{
"account_id": "a71f0c2e-4d85-4b1a-9e63-2f8c0d5b7a14",
"resource": "transactions",
"outcome": "succeeded",
"added": 3,
"modified": 0,
"removed": 1,
"error": null
}
],
"outcome": "succeeded",
"balances_changed": true,
"error": null
}202 e o sync_id.
Envie "wait": true para aguardar até 25 segundos e receber a sincronização concluída em uma única chamada, sem custo adicional.
O banco limita o acesso não supervisionado, por isso a chamada pode responder 429 refresh_limit_reached com Retry-After.
Consulte Atualizar dados bancários sob demanda.Autorizações
A chave de API da sua aplicação, obtida em Developers -> API keys no Business Console. A chave principal tem acesso completo. Uma chave nomeada pode ter escopo limitado: nenhum, leitura ou escrita por recurso, restrita a alguns fluxos ou a sessões aprovadas, a uma lista de endereços e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição partiu de um endereço fora da lista de endereços da chave; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status permitidos para a chave. Uma chave sem acesso a mídia recebe as URLs de imagem, vídeo e PDF como null, e uma chave sem escrita de sessões recebe os links e tokens de sessão como null. Veja https://docs.didit.me/console/api-keys.
Cabeçalhos
Chave opcional de segurança para novas tentativas, que você escolhe para uma operação, com até 255 caracteres (um UUID funciona). Uma requisição repetida com a mesma chave, endpoint, query e corpo recebe a primeira resposta, com o mesmo status e o mesmo corpo, e não é executada nem cobrada uma segunda vez. A mesma chave com outro endpoint, query ou corpo retorna 409 idempotency_key_reused. Enquanto a primeira requisição ainda estiver em execução, retorna 409 idempotency_key_in_progress com Retry-After. Uma requisição com falha (qualquer 4xx ou 5xx) não é armazenada, então você pode enviá-la novamente com a mesma chave. As chaves pertencem à sua aplicação, seja você chamando com uma chave de API ou um token de acesso. Veja Novas tentativas e idempotência.
1 - 255Corpo
Corpo opcional de uma atualização.
true mantém a chamada aguardando por até 25 segundos e responde 200 com a sincronização concluída, de modo que uma única requisição retorna dados atualizados. Se o banco não tiver respondido nesse prazo, a chamada responde 202: consulte a sincronização com get_sync_run, usando o sync_id, ou assine bank.sync.completed. bank.data.updated é enviado somente quando a sincronização armazena alterações. O cabeçalho Prefer: wait=<seconds> (até 25) faz o mesmo.
Resposta
A sincronização terminou em até 25 segundos.
Uma sincronização finalizada retornada por uma atualização com wait: a execução de sincronização com seu outcome, as contagens por conta em results e balances_changed.