Skip to main content
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>'
{
  "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=True cuya master entity de cobro coincide con master_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 responde 403.

​
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 Tu Pana (no hay endpoint público de inscripción). Este endpoint te sirve para consultar el estado actual.

Authorizations

​
Authorization
string
header
required

API Key para autenticación. Formato: Api-Key YOUR-API-KEY

Path Parameters

​
master_entity_id
integer
required

ID del destinatario (MasterEntity) que cobra con estas tarjetas.

Response

Lista de tarjetas inscritas (puede ser vacía)

​
results
object[]