Desarrolladores
Referencia de la API
Tarjetas (GET / PUT)

Tarjetas guardadas

Gestión de las tarjetas tokenizadas del sistema. Guía completa: Flujo de tarjetas guardadas.


GET /cards

Lista las tarjetas guardadas de tu sistema, con filtros opcionales.

Auth: requiere x-wpay-key.

Query params

ParamDescripción
emailFiltra por email del titular.
keysLista de identificadores separados por coma (los key que guardaste).

Response 200

[
  {
    "key": "C8F0D2A1B3E4F5A6B7C8D9E0",
    "name": "María Fernández",
    "first_name": "María",
    "last_name": "Fernández",
    "email": "[email protected]",
    "phone": "70000000",
    "direction_1": "Av. Arce 2299",
    "direction_2": "",
    "postal_code": "0000",
    "city": "La Paz",
    "state": "LP",
    "country_code": "BO",
    "card_type": "001",
    "card_last4": "1111",
    "created_at": "2026-07-16 12:00:00"
  }
]

Incluye los datos de facturación completos para prellenar tu formulario de checkout.

Pruébalo

GET/[email protected]⚡ Simulador — se ejecuta en tu navegador
Ver cURL equivalente (producción)
curl -X GET "https://api.wizpay.app/[email protected]" \
  -H "x-wpay-key: wpk_sandbox_demo"

PUT /cards/:key

Actualiza los datos de facturación de una tarjeta guardada. Solo se aplican los campos que envíes; el resto queda igual.

Auth: requiere x-wpay-key.

Campos editables

name · last_name · email · phone · direction_1 · direction_2 · postal_code · city · state · country_code

Response 200

La tarjeta actualizada (misma forma que el listado).

Errores

HTTPMensaje
404Tarjeta no encontrada

Pruébalo

PUT/cards/C8F0D2A1B3E4F5A6B7C8D9E0⚡ Simulador — se ejecuta en tu navegador
Ver cURL equivalente (producción)
curl -X PUT "https://api.wizpay.app/cards/C8F0D2A1B3E4F5A6B7C8D9E0" \
  -H "x-wpay-key: wpk_sandbox_demo" \
  -H "Content-Type: application/json" \
  -d '{ "direction_1": "Calle Nueva 123", "city": "Santa Cruz", "state": "S", "phone": "71234567" }'