curl -X POST 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/renew/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"redirect_url": "https://app.example.com/bank/return",
"language": "es"
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.renew_connection(
"11111111-2222-3333-4444-555555555555",
redirect_url="https://app.example.com/bank/return",
language="es",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.renewConnection("11111111-2222-3333-4444-555555555555", {
redirect_url: "https://app.example.com/bank/return",
language: "es",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.RenewConnection(ctx, "11111111-2222-3333-4444-555555555555", didit.BankRenewConnectionParams{
Body: didit.BankRenewLinkRequest{
RedirectURL: didit.String("https://app.example.com/bank/return"),
Language: didit.String("es"),
},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.BankRenewLinkRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().renewConnection("11111111-2222-3333-4444-555555555555", BankRenewLinkRequest.builder()
.redirectUrl("https://app.example.com/bank/return")
.language("es")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->renewConnection('11111111-2222-3333-4444-555555555555', [
'redirect_url' => 'https://app.example.com/bank/return',
'language' => 'es',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.renew_connection(
"11111111-2222-3333-4444-555555555555",
redirect_url: "https://app.example.com/bank/return",
language: "es"
)
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.RenewConnectionAsync("11111111-2222-3333-4444-555555555555", new BankRenewLinkRequest
{
RedirectUrl = "https://app.example.com/bank/return",
Language = "es",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"id": "0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40",
"mode": "renew",
"access": "ongoing",
"status": "created",
"url": "https://verify.didit.me/bank/link/example-link-token",
"client_token": "example-client-token",
"expires_at": "2026-11-21T13:00:00Z",
"connection_id": "5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35",
"check_id": null,
"reused": false,
"error": null,
"quote": {
"id": "7a3e9c52-1d84-4b06-8f2a-c5e0b9d17a43",
"lines": [
{
"meter": "bank_data_connection_month",
"unit": "connection_month",
"price_usd": "0.9000"
}
],
"fallback_lines": null,
"total_usd": "0.9000",
"valid_until": "2026-11-21T13:00:00Z",
"scopes": [
"accounts",
"balances",
"transactions"
]
},
"vendor_data": "client-7731"
}Renovar uma ligação bancária API: criar uma ligação de renovação
O endpoint Renew a Bank Connection da Didit cria uma ligação de renovação para uma ligação, um atalho para criar uma ligação com mode: renew.
curl -X POST 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/renew/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"redirect_url": "https://app.example.com/bank/return",
"language": "es"
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.renew_connection(
"11111111-2222-3333-4444-555555555555",
redirect_url="https://app.example.com/bank/return",
language="es",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.renewConnection("11111111-2222-3333-4444-555555555555", {
redirect_url: "https://app.example.com/bank/return",
language: "es",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.RenewConnection(ctx, "11111111-2222-3333-4444-555555555555", didit.BankRenewConnectionParams{
Body: didit.BankRenewLinkRequest{
RedirectURL: didit.String("https://app.example.com/bank/return"),
Language: didit.String("es"),
},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.BankRenewLinkRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().renewConnection("11111111-2222-3333-4444-555555555555", BankRenewLinkRequest.builder()
.redirectUrl("https://app.example.com/bank/return")
.language("es")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->renewConnection('11111111-2222-3333-4444-555555555555', [
'redirect_url' => 'https://app.example.com/bank/return',
'language' => 'es',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.renew_connection(
"11111111-2222-3333-4444-555555555555",
redirect_url: "https://app.example.com/bank/return",
language: "es"
)
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.RenewConnectionAsync("11111111-2222-3333-4444-555555555555", new BankRenewLinkRequest
{
RedirectUrl = "https://app.example.com/bank/return",
Language = "es",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"id": "0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40",
"mode": "renew",
"access": "ongoing",
"status": "created",
"url": "https://verify.didit.me/bank/link/example-link-token",
"client_token": "example-client-token",
"expires_at": "2026-11-21T13:00:00Z",
"connection_id": "5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35",
"check_id": null,
"reused": false,
"error": null,
"quote": {
"id": "7a3e9c52-1d84-4b06-8f2a-c5e0b9d17a43",
"lines": [
{
"meter": "bank_data_connection_month",
"unit": "connection_month",
"price_usd": "0.9000"
}
],
"fallback_lines": null,
"total_usd": "0.9000",
"valid_until": "2026-11-21T13:00:00Z",
"scopes": [
"accounts",
"balances",
"transactions"
]
},
"vendor_data": "client-7731"
}mode: renew.
O ID da ligação e os IDs de todas as contas permanecem iguais.
Responde com 409 renewal_not_needed enquanto restarem mais de 30 dias.
Consulte Renovar um consentimento bancário.Autorizações
A chave de API da sua aplicação, obtida em Developers -> API keys na Business Console. A chave principal tem acesso total. Uma chave com nome pode ter o âmbito limitado: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou apenas a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que não foi enviada nenhuma chave, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe os URLs de imagem, vídeo e PDF como null, e uma chave sem escrita em sessões recebe os links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.
Cabeçalhos
Chave opcional, à sua escolha, para garantir a segurança de novas tentativas numa operação, com até 255 caracteres (um UUID funciona). Um pedido repetido com a mesma chave, endpoint, parâmetros de query e corpo recebe a primeira resposta, com o mesmo código de estado e o mesmo corpo, e não é executado nem faturado uma segunda vez. A mesma chave com outro endpoint, outros parâmetros de query ou outro corpo devolve 409 idempotency_key_reused. Enquanto o primeiro pedido ainda estiver em execução, devolve 409 idempotency_key_in_progress com Retry-After. Um pedido falhado (qualquer 4xx ou 5xx) não é guardado, pelo que pode ser enviado novamente com a mesma chave. As chaves pertencem à sua aplicação, quer chame a API com uma chave de API, quer com um token de acesso. Consulte Novas tentativas e idempotência.
1 - 255Corpo
Definições opcionais de uma ligação de renovação. O restante vem da ligação.
Para onde o navegador vai no fim. Numa aplicação de sandbox, um endereço http simples de localhost, 127.0.0.1 ou [::1] não precisa de registo. Qualquer outro endereço responde 400 redirect_url_not_registered: o registo de outros endereços ainda não está disponível.
2048Resposta
A ligação de renovação.
Uma execução do Bank Link para uma pessoa: ligar um banco ou renovar uma ligação. Confirme pessoalmente a ligação com get_link: nunca confie num id enviado pelo navegador.