Documentación / API / Emisores (merchants)

Obtener emisor

GEThttps://api.cfdi.express/v1/merchants/{id}API key

Devuelve un emisor con los metadatos de su CSD (número de serie, vigencia y si ya está registrado con el PAC).

Autenticación
Authorization: Bearer sk_test_... | sk_live_...

Parámetros

Parámetros de ruta

CampoTipoDescripción
idreqstringId del emisor.

Ejemplos

cURL
curl https://api.cfdi.express/v1/merchants/mkq2f8v3x1t7p9d4n6c0b5rz \
  -H "Authorization: Bearer sk_test_..."

Respuesta

200 OK
{
  "id": "mkq2f8v3x1t7p9d4n6c0b5rz",
  "object": "merchant",
  "livemode": false,
  "rfc": "EKU9003173C9",
  "legalName": "ESCUELA KEMPER URGATE",
  "regimenFiscal": "601",
  "zip": "42501",
  "serie": "A",
  "defaultClaveProdServ": "01010101",
  "defaultClaveUnidad": "E48",
  "csd": {
    "object": "csd",
    "serialNumber": "30001000000500003416",
    "rfc": "EKU9003173C9",
    "validFrom": "2023-05-18T00:00:00.000Z",
    "validTo": "2027-05-18T00:00:00.000Z",
    "status": "active",
    "registeredWithPac": true,
    "updatedAt": "2026-08-18T16:24:51.002Z"
  },
  "logoUrl": "https://files.cfdi.express/logos/mkq2f8...png?X-Amz-Expires=900&...",
  "createdAt": "2026-08-18T16:20:03.114Z"
}

Errores

StatuscodeCuándo aparece
401unauthorizedFalta el header Authorization o la llave es inválida.
404not_foundEl emisor no existe en tu cuenta.

Notas

  • logoUrl es una URL firmada con vigencia de 15 minutos. No la guardes: pide el emisor de nuevo cuando la necesites.

Continuar