Skip to main content
Las tarjetas se pueden asignar a titulares y configurar con límites de gasto para un gasto controlado. Usa la API de Cards para emitir tarjetas, listar las tarjetas de una cuenta o un usuario, recuperar los datos de una tarjeta activa, como el número de tarjeta y el CVC, y listar las transacciones realizadas con ellas.

Endpoints

Atributos

string
requerido
ID de la tarjeta, con el prefijo icrd_.
object | null
requerido
La dirección de facturación.

Propiedades

string | null
requerido
Ciudad de facturación.
string | null
requerido
Código de país de facturación.
string | null
requerido
Línea 1 de la dirección.
string | null
requerido
Línea 2 de la dirección.
string | null
requerido
Código postal de facturación.
string | null
requerido
Región o estado de facturación.
string | null
requerido
Cuándo se canceló la tarjeta.
string | null
requerido
Cuándo se creó la tarjeta.
string[] | null
requerido
Las billeteras digitales a las que se ha añadido la tarjeta. List Cards, Update Card y los payloads de webhooks devuelven null, al igual que Retrieve Card cuando no se pueden recuperar las billeteras.Opciones disponibles: apple_pay, google_pay
string | null
requerido
Mes de vencimiento de la tarjeta.
string | null
requerido
Año de vencimiento de la tarjeta.
boolean
requerido
true una vez que el emisor ha emitido la tarjeta. false para una tarjeta invitada que aún espera la incorporación o revisión de su titular, o una que el emisor rechazó; no tiene número de tarjeta hasta que se emite.
string | null
requerido
Últimos cuatro dígitos del número de tarjeta. null para tarjetas con invitación pendiente.
object | null
requerido
La configuración del límite de gasto.

Propiedades

number
requerido
El importe del límite en dólares.
string
requerido
El periodo al que se aplica el importe del límite. per_transaction limita cada autorización individual y es lo que informa un límite establecido con transaction_limit.Opciones disponibles: daily, weekly, monthly, one_time, per_transaction
string | null
requerido
Nombre para mostrar de la tarjeta.
string
requerido
object | null
Datos confidenciales de la tarjeta. Presente solo en GET /cards/:id para tarjetas activas; null cuando la tarjeta está inactiva o no se pueden recuperar los datos.

Propiedades

string
requerido
Número completo de la tarjeta.
string
requerido
Código de verificación de la tarjeta.
string | null
requerido
Nombre del titular impreso en la tarjeta.
string | null
requerido
El PIN de la tarjeta. Solo se devuelve cuando la solicitud está autenticada como el usuario al que está asignada la tarjeta; null para todos los demás llamadores, incluidas las claves de API de cuenta.
integer | null
requerido
Gasto total en los últimos 30 días, en centavos.
string | null
requerido
El estado de la tarjeta. denied significa que el emisor rechazó al titular, por lo que la tarjeta nunca se emitirá.Opciones disponibles: active, frozen, canceled, invited, denied
string | null
requerido
El tipo de tarjeta.Opciones disponibles: virtual, physical
string | null
requerido
ID de usuario del titular, con el prefijo user_, cuando está asignada.
Card