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"
}续期银行连接 API:创建续期链接
Didit 的续期银行连接端点可为连接创建续期链接,是创建 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 链接的快捷方式。
连接 ID 和每个账户 ID 保持不变。
当剩余有效期仍超过 30 天时,端点会返回 409 renewal_not_needed。
请参阅续签银行同意。授权
您的应用 API 密钥,可在 Business Console 的开发者 -> API 密钥中获取。主密钥拥有完全访问权限。命名密钥可以设置范围:可按资源设置无权限、只读或读写,可限定为部分工作流或已批准的会话,可限定为一组 IP 地址,并可设置过期日期。401 表示密钥错误、已被撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或执行该操作,或请求来自其 IP 列表之外的地址;会话相关路由返回 404,表示该会话不在密钥的工作流或状态范围内。没有媒体访问权限的密钥会将图片、视频和 PDF 的 URL 返回为 null;没有会话写入权限的密钥会将会话链接和令牌返回为 null。请参阅 https://docs.didit.me/console/api-keys。
请求头
您为单次操作选择的可选重试安全密钥,最长 255 个字符(可使用 UUID)。使用相同密钥、endpoint、查询参数和请求体重复发送的请求,会返回第一次的响应,状态码和响应体均相同,且不会再次运行或计费。同一密钥若用于其他 endpoint、查询参数或请求体,将返回 409 idempotency_key_reused;若第一个请求仍在处理中,则返回 409 idempotency_key_in_progress 及 Retry-After。失败的请求(任何 4xx 或 5xx)不会被存储,因此您可以使用相同密钥再次发送。无论您使用 API 密钥还是访问 token 调用,密钥都归属于您的应用。请参阅重试与幂等性。
1 - 255请求体
续期链接的可选设置。其余设置来自该连接。
响应
续期链接。
为单个用户执行的一次银行链接运行:连接银行,或续期连接。请使用 get_link 自行确认链接,切勿信任浏览器发送的 ID。