Tarjetas guardadas y cobros masivos

tilopay_saved_cards_list_groups

Lista los grupos de cobro con tarjetas almacenadas (afiliados) en Tilopay.

Parámetros

Sin parámetros.

Devuelve

{ result }

Respuesta cruda del API de Tilopay bajo la llave `result`.

tilopay_saved_cards_list_affiliates

Lista los afiliados (clientes con tarjeta almacenada) de un grupo de cobro.

Parámetros

Devuelve

{ result }

Respuesta cruda del API de Tilopay bajo la llave `result`.

tilopay_saved_cards_list_collections

Lista los cobros masivos realizados con tarjetas almacenadas en Tilopay.

Parámetros

Sin parámetros.

Devuelve

{ result }

Respuesta cruda del API de Tilopay bajo la llave `result`.

tilopay_saved_cards_collection_detail

Obtiene el detalle de un cobro masivo. Requiere el `code` del cobro (campo `code` devuelto por tilopay_saved_cards_list_collections).

Parámetros

Devuelve

{ result }

Respuesta cruda del API de Tilopay bajo la llave `result`.

tilopay_tokenize_card

Genera el enlace seguro de Tilopay donde el cliente ingresa su tarjeta para dejarla guardada (tokenizada). El comercio nunca ve ni recibe los datos de la tarjeta. Una vez guardada, se le puede cobrar con tilopay_saved_cards_create_payments (esa sí pide código de confirmación por correo). Si se indica un contacto o teléfono, también devuelve un enlace de WhatsApp con el mensaje listo para enviarle al cliente.

Operación del API: POST /api/v1/processTokenize

Parámetros

Devuelve

{ tokenize_url, whatsapp_url, email, contact }

tokenize_url = enlace seguro donde el cliente ingresa su tarjeta para guardarla; whatsapp_url = enlace de WhatsApp listo para enviárselo. La tarjeta la digita el cliente: el agente nunca recibe el número.

tilopay_list_customer_cards

Lista las tarjetas que un cliente ya tiene guardadas (tokenizadas) en Tilopay, identificadas por su correo. Devuelve el token de cada tarjeta, que es lo que necesita tilopay_charge_saved_card para cobrarle. Solo se pueden cobrar tarjetas guardadas con el enlace de este asistente o del MCP. No cobra nada.

Parámetros

Devuelve

{ cards, count }

cards = tarjetas ya guardadas de ese cliente, con marca, últimos dígitos y su identificador para cobrar; count = cuántas hay. Nunca devuelve el número completo de la tarjeta.

tilopay_payment_methods

Lista los métodos de pago habilitados para el comercio en el checkout de Tilopay (tarjetas, SINPE Móvil, Yappy, cuotas o tasa cero cuando están activos) y si la cuenta responde en producción o en pruebas. Úsala cuando el comercio pregunte qué puede ofrecerle a su cliente o si tiene cuotas / tasa cero.

Parámetros

Devuelve

{ methods, installments, cards, environment, currency }

methods = métodos de pago habilitados para el comercio; installments = cuotas disponibles cuando el método las admite; cards = tarjetas guardadas del cliente si se envió su correo; environment = production o test.

tilopay_charge_saved_card

Cobra un monto a una tarjeta ya guardada (tokenizada) de un cliente. Requiere el correo del cliente y el token de la tarjeta (se obtiene con tilopay_list_customer_cards). Operación sensible: mueve dinero real y requiere segundo factor. Llámela primero sin `confirmation_code`: se envía un código de 6 dígitos al correo del comercio y la respuesta trae `requires_confirmation`. Repita la misma llamada, con los mismos parámetros, agregando `confirmation_code`.

Operación del API: POST /api/v1/processRecurrentPayment

Parámetros

Devuelve

{ result, approved, orderNumber, currency, receipt_code, receipt_url, receipt_image_url }

Cobra a una tarjeta ya guardada del cliente: approved = si el cobro fue aprobado; orderNumber = número de orden generado; receipt_* = comprobante del cobro cuando se generó. Exige segundo factor por correo.

tilopay_remove_saved_card

Elimina una tarjeta guardada (token) de un cliente en Tilopay. Operación sensible: requiere segundo factor. Llámela primero sin `confirmation_code` y repítala luego con el código de 6 dígitos que llega al correo del comercio.

Operación del API: POST /api/v1/user/card-remove

Parámetros

Devuelve

{ result }

result = respuesta del API al eliminar la tarjeta guardada del cliente. Exige segundo factor por correo.

tilopay_saved_cards_create_payments

Crea cobros a afiliados y/o grupos con tarjetas almacenadas en Tilopay. Solo se permiten afiliados cuya tarjeta se guardó con el enlace de este asistente o del MCP (tilopay_tokenize_card); los demás se rechazan. Operación sensible: afecta dinero real y requiere segundo factor. Llámela primero sin `confirmation_code`: se envía un código de 6 dígitos al correo del comercio y la respuesta trae `requires_confirmation`. Repita la misma llamada, con los mismos parámetros, agregando `confirmation_code`.

Parámetros

Devuelve

{ result }

Respuesta cruda del API de Tilopay bajo la llave `result`.