Listar los métodos de pago guardados de un cliente
Los métodos de pago que el cliente guardó en tu cuenta, del más nuevo al
más viejo, para mostrárselos en tu app y elegir con cuál cobrar
(POST /one_time_payments con payment_method_id) sin guardar datos de
tarjeta de tu lado. La misma tarjeta guardada dos veces aparece dos veces,
cada una con su id. No aparecen los métodos anulados. Hoy los métodos
que se guardan son tarjetas (incluidas las de Apple Pay).
Authentication
Tu clave secreta de API.
Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.
La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).
Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.
Path parameters
Query parameters
Solo los métodos de este tipo. card incluye las tarjetas en Apple Pay. Hoy los métodos que se guardan son tarjetas; los demás tipos responden una lista vacía.
Elementos por página (igual que items).
Elementos por página.
Página a devolver. La respuesta trae los encabezados link, current-page, total-pages y total-count.
Response
Los métodos de pago guardados del cliente
Tipo de método. Trae un objeto con el mismo nombre con sus detalles.
ID del cliente en el que está guardado. Si se guardó en varios clientes de tu cuenta (alguien pagó el checkout de otro con ella), el primero.
Siempre active; los métodos anulados no se listan.
Cuándo se guardó el método.
Aún no se puede guardar metadata en un método de pago; siempre null.
Presente cuando type es card.