Corporate Cards

Esta API permite ver los detalles de las tarjetas corporativas dentro de la plataforma

Descripción General

La API de tarjetas permite visibilizar las tarjetas de tu empresa.

Endpoints

Base URL

https://api.xpendit.com/public/v1/enterprises/{enterprise_id}/corporate-cards/

Reemplaza {enterprise_id} con el ID de tu empresa.

1. Obtener Tarjeta

Obtiene la información detallada de un usuario específico.

Endpoint

GET /public/v1/enterprises/{enterprise_id}/corporate-cards/{card_id}/

Query Parameters

Parámetro	Tipo	Descripción
expand	string	Campos adicionales a incluir. Valores:bank,user

Ejemplo

HTTP

GET /public/v1/enterprises/660e8400-e29b-41d4-a716-446655440000/corporate-cards/550e8400-e29b-41d4-a716-446655440000/
Authorization: Api-Key en_sk_xxxxx

Response 200 OK:

JSON

 {
   "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
   "user_id": "a1b2c3d4-e5f6-7890-abcd-ef1234561234",
   "last_four_digits": "1245",
   "bank_id": "b3fb2c3d4-e5f6-7890-abcd-ef123456123",
   "national_balance_currency": "CLP",
   "international_balance_currency": "USD",
   "billing_day": 24,
   "billing_mode": "bank_movements",
   "error": "",
	 "status": 200
 }

Ejemplo con Expand

HTTP

GET /public/v1/enterprises/660e8400-e29b-41d4-a716-446655440000/corporate-cards/550e8400-e29b-41d4-a716-446655440000/?expand=user
Authorization: Api-Key en_sk_xxxxx

Response 200 OK:

JSON

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "user": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234561234",
    "first_name": "María José",
    "last_name": "González Rodríguez",
    "phone": "[phone]",
    "email": "[email protected]",
    "internal_id": "EMP-2024-001",
    "government_id": "12.345.678-9"
  },
  "last_four_digits": "1245",
  "bank_id": "b3fb2c3d4-e5f6-7890-abcd-ef123456123",
  "national_balance_currency": "CLP",
  "international_balance_currency": "USD",
  "billing_day": 24,
  "billing_mode": "bank_movements",
   "error": "",
	 "status": 200
}

---

2. Listar Tarjetas

Obtiene la lista paginada de tarjetas de tu empresa.

Endpoint

GET /public/v1/enterprises/{enterprise_id}/corporate-cards/

Query Parameters

Parámetro	Tipo	Descripción
expand	string	Campos adicionales. Valores:bank,user
page	integer	Número de página (inicia en 1)
page_size	integer	Cantidad de resultados por página (máx: 100)

Ejemplo: Todos las tarjetas corporativas

HTTP

GET /public/v1/enterprises/660e8400-e29b-41d4-a716-446655440000/corporate-cards/
Authorization: Api-Key en_sk_xxxxx

Response 200 OK:

JSON

{
  "count": 25,
  "next": "https://api.xpendit.com/public/v1/enterprises/660e8400-e29b-41d4-a716-446655440000/corporate-cards/?page=2",
  "previous": null,
  "results": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "user_id": "a1b2c3d4-e5f6-7890-abcd-ef1234561234",
      "last_four_digits": "1245",
      "bank_id": "b3fb2c3d4-e5f6-7890-abcd-ef123456123",
      "national_balance_currency": "CLP",
      "international_balance_currency": "USD",
      "billing_day": 24,
      "billing_mode": "bank_movements"
    },
    {
      "id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
      "user_id": "a1b2c3d4-e5f6-7890-abcd-f2345678901",
      "last_four_digits": "1447",
      "bank_id": "b3fb2c3d4-e5f6-7890-abcd-ef123456123",
      "national_balance_currency": "CLP",
      "international_balance_currency": "USD",
      "billing_day": 20,
      "billing_mode": "bank_movements"
    }
  ]
}