FiveTech Support Forums

FiveWin / Harbour / xBase community
Board index FiveWin para Harbour/xHarbour PDV con pagos por tarjetas
Posts: 3358
Joined: Fri Oct 07, 2005 08:20 PM
PDV con pagos por tarjetas
Posted: Fri Mar 06, 2026 01:42 AM

Amigos del foro:

Tengo en puerta desarrollar una aplicación PDV que recibe pagos por tarjeteas, crédito y débito. necesito validar que la tarjeta sea válida en el banco emisor.

Alguna idea de lo que necesito hacer para validar los pagos con tarjeta?

Saludos

SOI, s.a. de c.v.
estbucarm@gmail.com
http://www.soisa.mex.tl/
http://sqlcmd.blogspot.com/
Tel. (722) 174 44 45
Carpe diem quam minimum credula postero
Posts: 44158
Joined: Thu Oct 06, 2005 05:47 PM
Re: PDV con pagos por tajteas
Posted: Fri Mar 06, 2026 06:52 AM

Estimado Armando,

Validación de Pagos con Tarjeta para PDV

🏗️ Arquitectura General del Pago con Tarjeta

El flujo de un pago con tarjeta involucra varios actores:

Tarjeta → Terminal/PDV → Procesador de Pagos → Red de Tarjetas → Banco Emisor
                              (Gateway)         (Visa/MC/Amex)

Tú NO te conectas directamente al banco emisor. En su lugar, te conectas a un procesador de pagos (Payment Gateway/Acquirer) que se encarga de toda la comunicación con las redes de tarjetas y los bancos.


---

📋 Lo Que Necesitas

1. Contratar un Procesador de Pagos (Adquirente)

Estos son intermediarios certificados que procesan las transacciones por ti. Ejemplos populares en Latinoamérica:

ProcesadorTipoNotas
StripeGateway/APIMuy popular, excelente API REST
Mercado PagoGateway/APIFuerte en LATAM
OpenPay (BBVA)Gateway/APIPopular en México
ConektaGateway/APIEnfocado en México
PayPal / BraintreeGateway/APIGlobal
Fiserv / FirstDataAdquirente tradicionalPara terminales físicas
Prosa / E-GlobalRed de procesamientoMéxico (requiere certificación)

2. Elegir el Tipo de Integración

Hay dos escenarios principales:

📱 Tarjeta Presente (Card Present) — Terminal Física

  • Necesitas un lector de tarjetas (chip/NFC/banda magnética)
  • El lector se conecta a tu PDV por USB, Bluetooth o red
  • Protocolos comunes: EMV (chip), NFC/contactless
  • Los datos sensibles los maneja el lector, no tu software (cumplimiento PCI DSS)

🌐 Tarjeta No Presente (Card Not Present) — Pago Online

  • Integras vía API REST del procesador
  • Usas tokenización (nunca almacenas el número de tarjeta)
  • Ejemplo con Stripe: envías un token → recibes confirmación

3. Cumplimiento PCI DSS

[!CAUTION]
PCI DSS (Payment Card Industry Data Security Standard) es obligatorio. Si manejas datos de tarjeta directamente, necesitas certificación. La forma más fácil de cumplir es nunca tocar los datos de la tarjeta — deja que el procesador/terminal los maneje.

4. Flujo Típico de una Transacción

1. Cliente presenta tarjeta
2. Terminal/lector lee los datos (chip EMV o NFC)
3. Tu PDV envía solicitud de autorización al procesador
4. El procesador envía a la red (Visa/Mastercard)
5. La red consulta al banco emisor
6. Banco emisor responde: APROBADA / RECHAZADA
7. La respuesta regresa por la misma cadena
8. Tu PDV muestra resultado e imprime voucher

Todo esto ocurre en 2-5 segundos.


---

🔧 Opciones de Implementación para tu PDV en Harbour/FiveWin

Opción A: Terminal Integrada (más común)

  • Contratas un servicio como Fiserv, Ingenico, Verifone que te da un dispositivo
  • El dispositivo expone una API local (REST, DLL, o puerto serial)
  • Tu app Harbour llama a esa API para iniciar el cobro
  • El dispositivo maneja toda la seguridad

Opción B: API REST de un Gateway

  • Te registras con Stripe, OpenPay, Conekta, etc.
  • Desde Harbour haces llamadas HTTP (puedes usar hb_curl o la clase THttpClient de FiveWin)
  • Envías: monto, token de tarjeta, datos del comercio
  • Recibes: código de autorización o error

Opción C: Lector de tarjetas USB + SDK

  • Compras un lector EMV (ej: Square Reader, SumUp)
  • Integras su SDK/API con tu aplicación
  • El lector tokeniza los datos, tú solo envías el token

---

🎯 Recomendación

Para un PDV en Harbour/FiveWin, la Opción A (Terminal Integrada) es la más práctica:

  1. Menos complejidad — no manejas datos sensibles
  2. Cumplimiento PCI — la terminal se encarga
  3. Integración sencilla — generalmente exponen una DLL o API REST local
  4. Soporte de chip EMV y contactless incluido

---

Preguntas para Definir el Camino

  1. ¿En qué país operará el PDV? (determina qué procesadores están disponibles)
  2. ¿Ya tienes relación con algún banco adquirente?
  3. ¿Será solo tarjeta presente (tienda física) o también online?
  4. ¿Necesitas manejar MSI (meses sin intereses)?
  5. ¿Tu PDV actual ya maneja algún tipo de pago electrónico?
regards, saludos

Antonio Linares
www.fivetechsoft.com
Posts: 537
Joined: Mon Jan 16, 2006 03:42 PM
Re: PDV con pagos por tajteas
Posted: Fri Mar 06, 2026 03:14 PM

Buenos tardes colegas eso mismo busco aca en chile (webpay)

Saludos

Posts: 3358
Joined: Fri Oct 07, 2005 08:20 PM
Re: PDV con pagos por tajteas
Posted: Fri Mar 06, 2026 08:34 PM

Maestro Antonio:

Más claro ni el agua, excelente explicación.

Muchas gracias por el aporte.

Saludos

SOI, s.a. de c.v.
estbucarm@gmail.com
http://www.soisa.mex.tl/
http://sqlcmd.blogspot.com/
Tel. (722) 174 44 45
Carpe diem quam minimum credula postero

Continue the discussion