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 connexió bancària: API per crear un enllaç de renovació
L’endpoint de Didit per renovar una connexió bancària crea un enllaç de renovació per a una connexió, un atall per crear un enllaç amb 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.
L’identificador de la connexió i cada identificador de compte es mantenen igual.
Respon amb 409 renewal_not_needed mentre queden més de 30 dies.
Consulta Renova un consentiment bancari.Autoritzacions
La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau principal té accés complet. Una clau amb nom es pot limitar: cap, lectura o escriptura per recurs, limitada a alguns fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 vol dir que la clau és incorrecta, revocada o caducada; 403 vol dir que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud ve d'una adreça fora de la seva llista d'adreces IP; 404 en una ruta de sessió vol dir que la sessió queda fora dels fluxos de treball o estats de la clau. Una clau sense accés a multimèdia rep les URL d'imatges, vídeos i PDF com a null, i una clau sense escriptura de sessions rep els enllaços i els tokens de sessió com a null. Vegeu https://docs.didit.me/console/api-keys.
Capçaleres
Clau opcional de seguretat per a reintents que tu tries per a una operació, de fins a 255 caràcters (un UUID funciona). Una sol·licitud repetida amb la mateixa clau, endpoint, consulta i cos rep la primera resposta, amb el mateix codi d'estat i el mateix cos, i no s'executa ni es factura una segona vegada. La mateixa clau amb un altre endpoint, consulta o cos retorna 409 idempotency_key_reused, i mentre la primera sol·licitud encara s'està processant, 409 idempotency_key_in_progress amb Retry-After. Una sol·licitud fallida (qualsevol 4xx o 5xx) no s'emmagatzema, de manera que pots tornar-la a enviar amb la mateixa clau. Les claus pertanyen a la teva aplicació, tant si crides amb una clau d'API com amb un token d'accés. Consulta Reintents i idempotència.
1 - 255Cos
Configuració opcional d'un enllaç de renovació. La resta prové de la connexió.
On va el navegador al final. En una aplicació de sandbox, una adreça http simple de localhost, 127.0.0.1 o [::1] no necessita registre. Qualsevol altra adreça respon 400 redirect_url_not_registered: encara no està disponible el registre d'altres adreces.
2048Resposta
L'enllaç de renovació.
Una execució de Bank Link per a una persona: connectar un banc o renovar una connexió. Confirma tu mateix un enllaç amb get_link: no confiïs mai en un identificador enviat pel navegador.