tiptap goDocumentaciónAPI v1
Mis API keys

API de TipTap Go

Cobra con tarjeta desde tu propio sistema: crea links de pago, guarda la tarjeta de tus clientes para cobrarles después, consulta tus cobros y controla cuánto te vamos a transferir.

1. Crea tu API key

En el panel, sección Desarrolladores.

2. Crea un link de pago

Un POST y ya tienes URL para cobrar.

3. Escucha los webhooks

Te avisamos cuando el pago entra.

Cómo funciona

TipTap Go es el agregador: los cobros pasan por nuestro comercio ante el procesador, el dinero llega a TipTap Go y nosotros lo transferimos a tu cuenta bancaria (eso es una liquidación). Tú no necesitas contrato con el banco adquirente ni certificación PCI: los datos de tarjeta nunca pasan por tu servidor ni por el nuestro — el checkout usa los campos alojados del procesador.

El ciclo completo de una integración es:

  1. Creas un link de pago por API con el monto y la descripción.
  2. Mandas la url a tu cliente (WhatsApp, correo, tu propio checkout…).
  3. El cliente paga en la página de TipTap Go. Nosotros manejamos tarjeta, 3‑D Secure y reintentos.
  4. Recibes el webhook payment.succeeded y marcas la orden como pagada en tu sistema.
  5. TipTap Go acumula lo cobrado y te lo transfiere; lo ves en GET /v1/balance y en GET /v1/settlements.

URL base

text
https://go.paytiptap.com/api/v1

Todas las respuestas son JSON. Los montos son números decimales en la moneda de tu cuenta (USD en Panamá) y las fechas son ISO‑8601 en UTC.

Prueba en 30 segundos

Crea una llave en Desarrolladores y verifica que responde:

GET/v1/me
curl
curl https://go.paytiptap.com/api/v1/me \
  -H "Authorization: Bearer tiptap_sk_TU_LLAVE"
respuesta
{
  "object": "account",
  "id": "cmqa48of50000jyjj4zwnflhi",
  "name": "Panadería La Espiga",
  "charges_enabled": true,
  "currency": "USD",
  "timezone": "America/Panama"
}

charges_enabled

Si es false, tu cuenta todavía no pasó la verificación (KYC) y los endpoints que mueven dinero responden 403 activation_required. Puedes integrarte y probar el resto de la API mientras tanto.

Cobra tu primer pago

curl
curl -X POST https://go.paytiptap.com/api/v1/payment_links \
  -H "Authorization: Bearer tiptap_sk_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Orden #1042",
    "amount": 25.00,
    "metadata": { "orden_id": "1042" }
  }'

La respuesta trae url: esa es la página de cobro. Ábrela con una tarjeta de prueba y verás el pago aparecer en GET /v1/payments.

Qué puedes hacer

  • Links de pago — cobros de un solo uso o reutilizables, con vencimiento y cupo.
  • Clientes — guarda la tarjeta de tu cliente una vez y cóbrale después sin que tenga que hacer nada.
  • Pagos — historial de todos los intentos de cobro con su estado real.
  • Liquidaciones — cuánto te debemos, cuánto va en camino y qué transacciones entraron en cada transferencia.
  • Webhooks — eventos firmados para no tener que hacer polling.

Lo que la API todavía no hace

  • Devoluciones (refunds): se piden por soporte; no hay endpoint aún.
  • Idempotencia fuera de los cobros: Idempotency-Key funciona en POST /v1/customers/{id}/charges. En los demás POST, dos llamadas iguales todavía crean dos objetos: controla esos reintentos de tu lado (por ejemplo, guardando el id del link que ya creaste para esa orden).
  • Suscripciones por API: los planes recurrentes se administran desde el panel; por API puedes replicarlos creando un cobro por período.
Autenticación →