Crear tarjeta de crédito

Crea una nueva tarjeta de crédito en el sistema, asociada a la compañía de la cuenta Pymes. numeroTarjeta debe ser único; se persiste enmascarado (solo se exponen los últimos 4 dígitos), el número completo nunca vuelve a exponerse por esta API. entidadFinanciera es obligatoria y, a diferencia de Cuentas Bancarias, acepta tanto el uuid de la entidad financiera (EE_COMPCOM) como el NIT del tercero asociado. franquicia debe ser un código del catálogo de franquicias que esté clasificado como tipo crédito (una franquicia de débito se rechaza). cupoTotal debe ser mayor a cero.

estrucEmpre y moneda no se reciben en la petición: se resuelven siempre internamente (nodo raíz de la compañía, y moneda base de la compañía, respectivamente) y no son editables por el cliente. La cuenta contable (cuenta, del libro base) es opcional: si NO se envía, la tarjeta se crea igual, pero queda suspendida en vez de activa cuando la compañía maneja contabilidad.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Datos para crear una tarjeta de crédito. La compañía se resuelve automáticamente de la cuenta Pymes. estrucEmpre y moneda no forman parte de este comando: se resuelven siempre internamente (nodo raíz de la compañía, y moneda base de la compañía, respectivamente) y no son editables por el cliente.

string
required
length ≤ 25

Número completo de la tarjeta. Se persiste enmascarado ("****" + últimos 4 dígitos); el número completo se conserva internamente, pero esta API nunca vuelve a exponerlo sin enmascarar.

string | null
string
required

UUID de la entidad financiera (EE_COMPCOM) emisora de la tarjeta, o el NIT del tercero asociado — a diferencia de Cuentas Bancarias, aquí sí se acepta el NIT además del uuid.

number
required
> 0

Cupo total de la tarjeta de crédito. Debe ser mayor a cero.

string
enum
required

Código del catálogo de franquicias (FI_FRANQUICIA, columna FCODE); solo se admiten franquicias clasificadas como tipo crédito (una franquicia de débito se rechaza). El catálogo puede ampliarse con nuevos códigos sin requerir un cambio de contrato; estos son los vigentes hoy.

string | null

UUID o código de la cuenta contable (del libro base) a la que se contabiliza la tarjeta. Opcional: si NO se envía, la tarjeta se crea igual, pero queda suspendida en vez de activa, cuando la compañía maneja contabilidad.

Responses

401

No autorizado.

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json