Desarrolladores

Todo lo que necesitas para integrar iPagos en tu producto: APIs REST, SDKs oficiales, webhooks, ambientes de prueba y guías paso a paso.

Empezar ahora

Solicitar API key

API Reference

Clientes

El recurso Customer te permite guardar información del tarjetahabiente, almacenar métodos de pago tokenizados y reutilizarlos en cargos futuros.

El objeto Customer

{
  "id": "cus_8B2nM1Q9TfYr",
  "object": "customer",
  "email": "[email protected]",
  "name": "Ana Hernández",
  "phone": "+525512345678",
  "default_source": "src_4242",
  "sources": {
    "object": "list",
    "data": [
      { "id": "src_4242", "brand": "visa", "last4": "4242" }
    ]
  },
  "metadata": { "external_id": "USR-1042" },
  "created_at": "2026-06-04T17:42:11Z"
}

Endpoints

POST

/v1/customers

Crea un nuevo cliente.

GET

/v1/customers/:id

Recupera un cliente.

POST

/v1/customers/:id

Actualiza los datos del cliente.

DEL

/v1/customers/:id

Elimina el cliente y sus métodos de pago asociados.

POST

/v1/customers/:id/sources

Agrega un método de pago tokenizado al cliente.

Cobrar a un cliente existente

curl https://api.ipagos.lat/v1/payments \
  -u sk_sandbox_xxxxxxxxxxxxxxxxxxxxx: \
  -d customer=cus_8B2nM1Q9TfYr \
  -d amount=49900 \
  -d currency=MXN \
  -d description="Plan Pro mensual"