Configuración de pasarela de pago

Una pasarela de pago es lo que realmente mueve el dinero. GCM no mantiene cuentas de comercio — en su lugar, nos conectamos a una pasarela que tú (o la plataforma) ya tiene, y entregamos los datos de la tarjeta para cada cobro.

Este es el mismo motor que impulsa el formulario de donaciones en línea, las donaciones recurrentes y tu facturación mensual de suscripción.

Predeterminado de la plataforma vs tu propia pasarela

Cuando creas una organización, GCM usa por defecto la pasarela de la plataforma — las liquidaciones aterrizan en la cuenta de retención de GCM y remitimos a tu banco semanalmente. Esta es la forma más rápida de empezar a recibir donaciones, y la mayoría de las iglesias se quedan así durante el primer mes.

Cambias a tu propia pasarela cuando:

• Quieres que las liquidaciones aterricen directamente en el banco de la iglesia, sin cuenta de retención en medio.
• Tu procesador ofrece tarifas más bajas que el predeterminado de la plataforma.
• Operas en un país al que el predeterminado de la plataforma no liquida.
• Tu junta tiene razones de cumplimiento para ser dueña de la relación de comercio.

En Configuración → Pasarela de pago, activa Usar tu propia pasarela. Los campos de credenciales aparecen abajo.

TIP

Puedes volver al predeterminado de la plataforma en cualquier momento. Las donaciones recurrentes existentes siguen usando la pasarela que registró su token — pero las nuevas usan la pasarela activa.

Pasarelas admitidas

Pasarela	Tipo	Recurrente	Mejor para
PowerTranz (Direct)	API	sí	Caribe / LATAM; donaciones recurrentes
PowerTranz (Hosted Page)	Redirección	no (solo única vez)	mínimo alcance PCI
Genius Checkout	Redirección	sí (mediante tokens)	cobertura global, checkout alojado

PowerTranz es la pasarela más usada en nuestra base de usuarios por su fuerte cobertura en el Caribe y América Latina. Genius Checkout es la opción global — es una página alojada que liquida en más de 52 monedas.

PowerTranz (Direct)

Direct significa que GCM recoge los datos de la tarjeta y los envía por POST a la API de PowerTranz. El pagador nunca sale de tu dominio. Esto es necesario si quieres donaciones recurrentes — solo el adaptador directo admite tarjeta en archivo tokenizada.

Necesitarás de tu administrador de cuenta de PowerTranz:

• PowerTranz ID — tu ID de comercio, p. ej. 88803195.
• Password — la contraseña de la API (solo escritura — la encriptamos en reposo).
• Acquirer ID — a veces requerido por tu adquirente (p. ej. 464748).
• Environment — staging mientras pruebas, production cuando vayas en vivo.
• Capture mode — Sale (cobrar inmediatamente) o Auth + Capture (retener los fondos, capturar luego).

Tras guardar, haz clic en Probar conexión. Llamamos a un endpoint de bajo costo que confirma que las credenciales llegan correctamente a PowerTranz. Aparece una insignia verde cuando se verifica.

PowerTranz (Hosted Page)

El sabor de página alojada (HPP) de PowerTranz pone el formulario de tarjeta en el dominio de PowerTranz, no en el tuyo. El pagador ingresa los datos de la tarjeta allí y nunca vemos el PAN. Esta es la opción de menor exposición PCI.

Las mismas credenciales que el adaptador directo, más:

• Hosted Page Set — el ID del conjunto de páginas que PowerTranz aprovisionó para ti.
• Hosted Page Name — la página dentro del conjunto.

Compromiso: el adaptador HPP no admite donaciones recurrentes. PowerTranz solo puede tokenizar una tarjeta durante una sesión de navegador, y los cobros recurrentes ocurren en un calendario sin navegador. Si quieres recurrentes con PowerTranz, usa el adaptador directo.

Genius Checkout

Genius Checkout (GC) es nuestra opción preferida para iglesias sin una relación de procesador existente. Es una página de pago alojada como PowerTranz HPP, pero también admite cobros recurrentes mediante tokens de larga duración.

Solo necesitas una credencial:

• GC API key — empieza con gc_test_… o gc_live_….

La integración maneja todo lo demás automáticamente: sesiones de checkout, redirecciones de éxito / fallo, callbacks de webhook firmados, cambios de estado de suscripción. Mapeamos los códigos de moneda numéricos internos ISO 4217 de GCM a los códigos alfabéticos de GC — 52 monedas admitidas, incluyendo USD, EUR, GBP, JMD, KES, NGN, ZAR.

Cómo se almacenan los datos de tarjeta

Una vez que una tarjeta es tokenizada, almacenamos:

• Un token de pasarela (el SpiToken de PowerTranz o el tok_… de GC).
• La marca de la tarjeta (Visa, Mastercard, …).
• Los últimos 4 dígitos.
• El mes + año de vencimiento.

El PAN completo nunca aterriza en nuestra base de datos. Para donaciones recurrentes y tarjetas guardadas, GCM cobra el token — la pasarela lo resuelve de vuelta a la tarjeta subyacente en su lado.

Probar el flujo

Antes de ir en vivo, ejecuta una donación de $1 a través del formulario de donaciones usando una tarjeta de prueba:

Pasarela	Tarjeta aprobada	Tarjeta declinada
PowerTranz	4111 1111 1111 1111	4000 0000 0000 0002
Genius Checkout	4242 4242 4242 4242	4000 0000 0000 9995

Todas las pasarelas aceptan cualquier vencimiento futuro y cualquier CVV de 3 dígitos en modo de prueba.

Reembolsos y anulaciones

Ambas pasarelas admiten reembolsos totales y parciales desde dentro de GCM. Abre una donación en Donaciones → Donaciones, haz clic en el menú de acción y elige Reembolsar. La pasarela procesa la reversión, la fila de donación obtiene un refunded_amount, y se añade una fila a payment_attempts para el rastro de auditoría.

Las anulaciones (poner a cero una autorización antes de la captura) solo tienen sentido en modo Auth + Capture — liberan la retención sin cobrar nunca la tarjeta.

Cambiar de pasarela después

Cuando cambias de pasarela activa:

• Las donaciones de única vez comienzan a usar la nueva pasarela inmediatamente.
• Las donaciones recurrentes siguen cobrándose en la pasarela antigua hasta que migres las tarjetas — los tokens no son portables entre procesadores. Para la mayoría de las iglesias el camino más limpio es enviar a los donantes un enlace de "por favor actualiza tu tarjeta" en lugar de intentar migrar tokens.

Referencias cruzadas

• Formulario de donaciones en línea — donde estas pasarelas se usan realmente.
• Donaciones recurrentes — ciclo de vida del token y manejo de renovaciones.
• Referencia de webhooks — firmas de webhook de la pasarela.