Conectar una cuenta de pago: Stripe y PayTR

En la app, En línea es un cuarto método de pago junto a Efectivo y Tarjeta: muestras al cliente un enlace de pago o un código QR y, en cuanto llega el pago, la salida del vehículo se completa sola. Esta página explica cómo conectar esa cuenta.

¿Adónde va el dinero?

Directamente a tu propia cuenta de pago. El dinero nunca pasa por Tanrikulu Apps; Tanrikulu Apps no guarda saldo ni cobra comisión.

Cliente

Escanea el código QR o toca el enlace y paga con tarjeta.

→

Stripe / PayTR

Tu propia cuenta de comercio. El pago queda en tu cuenta.

→

Tu cuenta bancaria

El dinero llega según el calendario de liquidación del proveedor.

Qué hace Tanrikulu Apps: la app nunca mueve el dinero; solo recibe del proveedor el aviso «pagado» y completa la salida. Por eso conectas la cuenta tú mismo y el cobro se hace a tu nombre.

Primero, entiende el modo de prueba

La casilla Modo de prueba (sandbox) de Ajustes decide si estás cobrando dinero de verdad. Es el ajuste más caro de equivocar.

Modo de prueba activado

No hacen falta claves, puedes probar al instante.
El cliente parece haber pagado.
No llega dinero a tu cuenta.
Solo para probar.

Modo de prueba desactivado (real)

Conectas tu propia cuenta.
El cliente paga de verdad.
El dinero llega a tu cuenta.
Este es el uso diario.

La app te avisa y pide confirmación antes de activar el modo de prueba. Antes de empezar a cobrar dinero real, desmarca la casilla y conecta tu propia cuenta.

¿Cuál te corresponde?

Fuera de Turquía

Stripe. PayTR solo atiende a negocios establecidos en Turquía.

En Turquía

PayTR. Stripe no abre cuentas a negocios turcos.

No necesitas los dos: la pantalla de salida solo ofrece los proveedores que has conectado.

Conectar Stripe

1Completa la cuenta

Crea una cuenta de Stripe y termina los datos de tu negocio; una cuenta incompleta no puede cobrar pagos reales.

→

2Copia la clave secreta

Dashboard → Developers → API keys. El valor que necesitas empieza por sk_.

→

3Pégala en la app

Ajustes → Cuenta de pago → Stripe → Conectar

Stripe → Developers → API keys → sk_live_… → Ajustes → Cuenta de pago → Stripe → Conectar

Los tipos de clave y su manejo seguro se explican en la propia página de Stripe: Claves de API. Si su interfaz cambia, esa página se mantiene actualizada.

La clave se muestra una sola vez. Stripe enseña una clave secreta recién creada solo en ese momento; si la pierdes, creas una nueva. La app tampoco vuelve a mostrar la clave después de guardarla: solo ves la insignia «Conectada».

Conectar PayTR

1Cuenta de comercio

Solicítala a PayTR; tu panel de comercio se abre cuando la aprueban.

→

2Permiso de enlace de pago

Se solicita aparte en el panel. Una cuenta básica no puede crear enlaces por sí sola.

→

3Introduce tres valores

Tómalos de Panel → Información y pégalos en la app.

Panel de PayTR → Información → merchant id merchant key merchant salt → Ajustes → Cuenta de pago → PayTR → Conectar

PayTR explica paso a paso la solicitud y el paso a modo real: Integración de enlace de pago (Payment Link).

Monedas: el servicio de enlace de pago de PayTR acepta TRY, EUR, USD y GBP. No puede crear enlaces para un negocio que trabaja en otra moneda; ahí usa Stripe. Para EUR/USD/GBP, tu cuenta de comercio de PayTR también necesita una cuenta definida en esa moneda.

Qué pasa en la salida

1Elige En línea

Elige En línea como método de pago en la pantalla Salida de vehículo.

→

2Crea el enlace

Aparece un código QR; el cliente lo escanea o tú le envías el enlace.

→

3La salida se completa sola

En cuanto llega el pago, la salida del vehículo se completa automáticamente.

El botón de salida no aparece hasta que llega el dinero, así que nunca queda una salida que parece pagada y no lo está. Los cobros en línea van en una línea aparte en la caja de fin de día y en los informes; nunca se mezclan con Tarjeta, que es el dinero cobrado con tu propio datáfono.

También para abonados y saldos de clientes

En línea no se limita a la salida de vehículos: aparece como cuarto método en Abonados → Cobrar y Clientes → Cobrar. Muestras el código QR y, en cuanto llega el pago, el cobro se registra solo y aparece en la línea En línea de la caja. El botón de cobrar no aparece hasta que llega el dinero.

Panel de escaparate: cuando eliges En línea en la salida y creas el enlace, el código QR también aparece en el panel de la TV («Escanea con el móvil para pagar»), así el cliente que está junto al coche no tiene que mirar el teléfono del empleado. Sin En línea, el panel muestra el código QR de seguimiento de siempre.

Preguntas frecuentes

«No se pudo crear el enlace de pago» — en pantalla se muestra el motivo que devolvió el proveedor. Los dos más habituales: el permiso de enlace de pago aún no está activo, o una moneda que el proveedor no acepta.
Al tocar En línea dice que no hay cuenta conectada — aún no has conectado ninguna. Ve a Ajustes → Cuenta de pago y añádela.
En línea no aparece — no se pudo leer la lista de proveedores (normalmente por la conexión). Vuelve en cuanto hay internet; mientras tanto Efectivo y Tarjeta siguen funcionando.
Corregí el modo pero el enlace anterior sigue sin funcionar — un enlace pertenece al modo (prueba/real) en que se creó. Tras cambiar el modo, vuelve a abrir la pantalla de salida y se crea un enlace nuevo automáticamente; si no, usa el botón Crear un enlace nuevo bajo la línea roja. Un registro ya pagado nunca se renueva.
Se hizo un pago pero no llegó dinero — puede que el modo de prueba siga activado. Desmarca la casilla en Ajustes; el modo real usa tu propia cuenta.

Sobre la seguridad de las claves: las claves nunca se descargan al teléfono ni se guardan dentro de la app; se conservan cifradas en el servidor. Tanrikulu Apps nunca necesita pedírtelas: las introduces tú en tu propia pantalla de ajustes.