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 una conexión bancaria API: crear un enlace de renovación
El endpoint Renovar una conexión bancaria de Didit crea un enlace de renovación para una conexión, un atajo para crear un enlace con 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.
El id de la conexión y el de cada cuenta no cambian.
Responde con 409 renewal_not_needed mientras queden más de 30 días.
Consulta Renovar un consentimiento bancario.Autorizaciones
La clave de API de tu aplicación, desde Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener permisos limitados: ninguno, lectura o escritura por recurso, restringida a algunos flujos o solo a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, está revocada o ha caducado; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud procede de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, vídeos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.
Encabezados
Clave opcional que eliges para garantizar la seguridad de los reintentos en una operación, de hasta 255 caracteres (puede usarse un UUID). Una solicitud repetida con la misma clave, endpoint, parámetros de consulta y cuerpo recibe la primera respuesta, con el mismo código de estado y el mismo cuerpo, y no se ejecuta ni se factura de nuevo. La misma clave con otro endpoint, otros parámetros de consulta o un cuerpo distinto devuelve 409 idempotency_key_reused. Si la primera solicitud sigue en curso, devuelve 409 idempotency_key_in_progress con Retry-After. Una solicitud fallida (cualquier 4xx o 5xx) no se almacena, así que puedes volver a enviarla con la misma clave. Las claves pertenecen a tu aplicación, tanto si llamas con una clave de API como con un token de acceso. Consulta Reintentos e idempotencia.
1 - 255Cuerpo
Configuración opcional de un enlace de renovación. El resto proviene de la conexión.
Adónde va el navegador al final. En una aplicación de sandbox, una dirección http simple de localhost, 127.0.0.1 o [::1] no requiere registro. Cualquier otra dirección responde 400 redirect_url_not_registered: el registro de otras direcciones todavía no está disponible.
2048Respuesta
El enlace de renovación.
Una ejecución de Bank Link para una persona: conectar un banco o renovar una conexión. Confirma tú mismo un enlace con get_link: nunca confíes en un id enviado por el navegador.