Actualizar cuenta bancaria
curl --request PUT \
--url https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"account_number": "9876543210"
}
'import requests
url = "https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/"
payload = { "account_number": "9876543210" }
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({account_number: '9876543210'})
};
fetch('https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'account_number' => '9876543210'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/"
payload := strings.NewReader("{\n \"account_number\": \"9876543210\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"account_number\": \"9876543210\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_number\": \"9876543210\"\n}"
response = http.request(request)
puts response.read_body{
"id": 456,
"bank": 7,
"bank_detail": {
"id": 7,
"name": "BANCO SANTANDER-CHILE",
"sbif_code": "037",
"additional_brands": "Banefe",
"is_active": true
},
"account_type": "checking",
"account_type_display": "Cuenta Corriente",
"account_number": "1234567890",
"include_in_emails": true,
"created_at": "2026-04-06T12:00:00Z",
"updated_at": "2026-04-06T12:00:00Z"
}Cuenta Bancaria
Actualizar cuenta bancaria
Actualiza uno o más campos de la cuenta bancaria registrada. Solo se modifican los campos incluidos en el request. Cada destinatario tiene una sola cuenta bancaria, por eso no hace falta enviar un id de cuenta.
PUT
/
master-entities
/
{master_entity_id}
/
banking-info
/
Actualizar cuenta bancaria
curl --request PUT \
--url https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"account_number": "9876543210"
}
'import requests
url = "https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/"
payload = { "account_number": "9876543210" }
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({account_number: '9876543210'})
};
fetch('https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'account_number' => '9876543210'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/"
payload := strings.NewReader("{\n \"account_number\": \"9876543210\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"account_number\": \"9876543210\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_number\": \"9876543210\"\n}"
response = http.request(request)
puts response.read_body{
"id": 456,
"bank": 7,
"bank_detail": {
"id": 7,
"name": "BANCO SANTANDER-CHILE",
"sbif_code": "037",
"additional_brands": "Banefe",
"is_active": true
},
"account_type": "checking",
"account_type_display": "Cuenta Corriente",
"account_number": "1234567890",
"include_in_emails": true,
"created_at": "2026-04-06T12:00:00Z",
"updated_at": "2026-04-06T12:00:00Z"
}¿Para qué se usa?
Actualiza uno o más campos de la cuenta bancaria registrada para un destinatario. Solo se modifican los campos que incluís en el request.Qué hace
- Actualiza parcialmente los datos de la cuenta bancaria. Como cada destinatario tiene una sola cuenta, no hace falta enviar un id de cuenta en la URL.
- Para cambiar el banco puedes enviar
sbif_code(ej"037") obank(ID interno). Mira la tabla de códigos SBIF en el endpoint de creación.
Consideraciones importantes
Impacto en cobros activos
Las sesiones de cobro creadas antes de actualizar la cuenta no se ven afectadas. Los nuevos depósitos van a la cuenta actualizada.Authorizations
API Key para autenticación. Formato: Api-Key YOUR-API-KEY
Path Parameters
ID del destinatario (MasterEntity).
Body
application/json
Todos los campos son opcionales: solo se actualizan los enviados.
Código SBIF del banco (3 dígitos).
| Código | Banco |
|---|---|
001 | Banco de Chile |
009 | Banco Internacional |
014 | Scotiabank Chile |
016 | Banco de Crédito e Inversiones (BCI) |
028 | Banco BICE |
031 | HSBC Bank (Chile) |
037 | Banco Santander-Chile |
039 | Banco Itaú Chile |
049 | Banco Security |
051 | Banco Falabella |
053 | Banco Ripley |
055 | Banco Consorcio |
059 | Banco BTG Pactual Chile |
062 | Tanner Banco Digital |
Available options:
001, 009, 014, 016, 028, 031, 037, 039, 049, 051, 053, 055, 059, 062 Example:
"037"
Example:
7
Available options:
checking, savings, current Example:
"9876543210"
Response
Cuenta bancaria actualizada
Example:
456
ID en BD del banco.
Example:
7
Información expandida del banco.
Show child attributes
Show child attributes
Available options:
checking, savings, current Example:
"checking"
Etiqueta legible en español del tipo de cuenta.
Example:
"Cuenta Corriente"
Example:
"1234567890"
Example:
true
Example:
"2026-04-06T12:00:00Z"
Example:
"2026-04-06T12:00:00Z"
