Listar tarjetas inscritas
curl --request GET \
--url https://api.tupana.ai/v1/master-entities/{master_entity_id}/payment-methods/ \
--header 'Authorization: <api-key>'import requests
url = "https://api.tupana.ai/v1/master-entities/{master_entity_id}/payment-methods/"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.tupana.ai/v1/master-entities/{master_entity_id}/payment-methods/', 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}/payment-methods/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.tupana.ai/v1/master-entities/{master_entity_id}/payment-methods/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.tupana.ai/v1/master-entities/{master_entity_id}/payment-methods/")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tupana.ai/v1/master-entities/{master_entity_id}/payment-methods/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"results": [
{
"payment_method_id": 814,
"type": "card",
"is_default": true,
"email": "juan@ejemplo.com",
"card_last4": "6623",
"card_type": "Visa",
"card_expiration": "12/2030",
"provider": "transbank_oneclick",
"payer": {
"id": 482,
"tax_id": "11.111.111-1",
"name": "Juan Soto"
},
"created_at": "2026-04-06T12:00:00Z"
}
]
}Medios de pago
Listar tarjetas inscritas
Retorna las tarjetas activas inscritas que el destinatario (master entity actuando como client) puede cobrar. Hoy solo se exponen tarjetas vía Transbank OneClick.
GET
/
master-entities
/
{master_entity_id}
/
payment-methods
/
Listar tarjetas inscritas
curl --request GET \
--url https://api.tupana.ai/v1/master-entities/{master_entity_id}/payment-methods/ \
--header 'Authorization: <api-key>'import requests
url = "https://api.tupana.ai/v1/master-entities/{master_entity_id}/payment-methods/"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.tupana.ai/v1/master-entities/{master_entity_id}/payment-methods/', 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}/payment-methods/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.tupana.ai/v1/master-entities/{master_entity_id}/payment-methods/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.tupana.ai/v1/master-entities/{master_entity_id}/payment-methods/")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tupana.ai/v1/master-entities/{master_entity_id}/payment-methods/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"results": [
{
"payment_method_id": 814,
"type": "card",
"is_default": true,
"email": "juan@ejemplo.com",
"card_last4": "6623",
"card_type": "Visa",
"card_expiration": "12/2030",
"provider": "transbank_oneclick",
"payer": {
"id": 482,
"tax_id": "11.111.111-1",
"name": "Juan Soto"
},
"created_at": "2026-04-06T12:00:00Z"
}
]
}¿Para qué se usa?
Obtiene las tarjetas activas inscritas que un destinatario (master entity) puede cobrar. Útil para mostrar al destinatario qué pagadores tienen tarjeta inscrita y poder ofrecerles cobros recurrentes o cobros directos sin redirigir al checkout cada vez.Qué hace
- Retorna las tarjetas con
is_active=Truecuya master entity de cobro coincide conmaster_entity_id. - Por cada tarjeta incluye los datos del pagador (RUT, nombre), los últimos 4 dígitos, la marca, el vencimiento y el proveedor.
- Hoy solo se exponen tarjetas vía Transbank OneClick.
Consideraciones importantes
Scope por API Key
La API Key debe pertenecer a un usuario con acceso a la master entity indicada en la URL. Si no, el endpoint responde403.
Tarjetas inactivas
Una tarjeta puede quedar inactiva si el pagador la dio de baja, si Transbank rechazó el OneClick o si se reemplazó por otra del mismo pagador (solo un método activo por pagador para esa master entity). El endpoint no las retorna.Hoy las tarjetas se inscriben desde el frontend de Tupana (no hay endpoint público de inscripción). Este endpoint te sirve para consultar el estado actual.
Authorizations
API Key para autenticación. Formato: Api-Key YOUR-API-KEY
Path Parameters
ID del destinatario (MasterEntity) que cobra con estas tarjetas.
Response
Lista de tarjetas inscritas (puede ser vacía)
Show child attributes
Show child attributes
