4Geeks Payments

note

Esta documentación se encuentra sólo en Español.

4Geeks Payments es un API que permite procesar la mayoría de marca de tarjetas bancarias de forma fácil y segura, e integrarlo en minutos en tu sitio web, plataforma o aplicación móvil. Incluyendo Visa, MasterCard y American Express.

Esta guía te permitirá entender a profundad el funcionamiento del API, así como explicaciones y ejemplos de integración en distintos lenguajes de programación y frameworks.

Existen librerías cliente que puedes usar integrar el API con tu plataforma en pocas líneas de código. Estas librerías son mantenidas y soportadas, en su mayoría, por la comunidad. Entonces puedes encontrar librerías cliente para Ruby on Rails, Python, .NET, Go y WooCommerce/Wordpress. Sin embargo, siempre puedes consumir el API mediante métodos HTTP, o escribir tus propias librerías.

tip

Aunque 4Geeks Payments sólo está disponible para comercios basados en Costa Rica, siempre puedes procesar la mayoría de marcas de tarjetas emitidas globalmente.

El siguiente ejemplo es un cargo simple, el cual no requiere que registres ni tarjetas, ni clientes, solamente unas lineas de código.

await gpApi.charges.create({
amount: 90.32,
description: 'Plan 1 service charge',
entity_description: 'Plan 1',
currency: 'usd',
credit_card_number: 4242424242424242,
credit_card_security_code_number: 123,
exp_month: 11,
exp_year: 2020
})

Todos los endpoints de autenticación, pagos y reportes los puede consultar en API.


Sandbox

4Geeks Payments es un servicio orientado a desarrolladores, programadores e ingenieros. Cada comercio que desee recibir pagos de sus clientes a través de tarjetas por medio de sus paginas web, y quiera utilizar 4Geeks Payments para esto, debe suscribirse una única vez. Automáticamente recibirás credenciales del modo de prueba, que debes usar en cada llamada al API.

Esto con el fin de que cada desarrollador pueda asegurarse que el flujo de negocio corre según lo espera realizando la cantidad de simulaciones necesarias. En este modo puedes usar las tarjetas de prueba, que proveemos.

Al crear la cuenta, también tendrás acceso al Panel de Administración; ésto te permitirá ver todos los datos de tus transacciones de forma interactiva, con gráficos y otros recursos.


Producción

Cuando este listo para solicitar la activacion de produccion, y asi procesar tarjetas reales de clientes reales puedes hacerlo desde el panal de administracion, completar un formulario y adjuntar los documentos requeridos que prueben la validez de tu empresa.

Los documentos básicos que debes presentar son:

  • Foto de la cedula (o pasaporte) del representante legal, por ambos lados.
  • RUT (Registro Único Tributario).
  • Personería jurídica (en caso de ser persona juridica).

Para recibir API Keys de producción, debes aplicar. Entonces ve a tu perfil en el Panel de Control, y luego hacer click sobre aplicar a credenciales de producción.

tip

Un negocio puede ser representado por persona física o persona jurídica.

Nuestro equipo le podrá solicitar información adicional para validar identidad, veracidad de la información, actividad que deseas desempeñar y otra información administrativa.

Al momento en que solicitar la activación, se realizará un estudio para otorgar acceso la activación de producción.

Se podrá negar tu activación si se comprueba que la información que nos brindaste no es válida, realizas actividades que se encuentran dentro de nuestros modelos de negocios no permitidos, etc.

En caso de que se le haya negado la activación, te lo notificaremos.


Payouts

Los pagos corresponde al monto cargado a sus clientes, lo recibirá cada viernes, lo recibirá automátiacmente en su cuenta bancaria en cualquier banco registrado en Costa Rica. El corte del pago corresponderá a la semana anterior.

Podrás llevar un control detallado de cada pago desde Saldo, en el Panel de Administrador. Tal como las transacciones que ya fueron pagadas y las que aun no ha sido pagadas. En cuanto a las transacciones pagadas, podrás obtener el número de referencia bancaria, asi confirmando que el pago fue efectuado.

Según su banco, es posible que incurras en atrasos. Cuando detectes un atraso en un pago, por favor comunícate directamente con tu banco. Los pagos se realizaran a la cuenta bancaria de la persona fisica o juridica por la cual se aplicó.

No incurrirás en comisiones extra por concepto de envío de dinero a su cuenta bancaria. En Costa Rica pagamos en dólares estadounidenses y colones costarricenses. Toma en cuenta que se harán pagos semanales donde el acumulado sea igual o mayor $5 USD.


Moneda

Las monedas en las que puedes procesar montos es colones costarricenses CRC y dólares estadounidense USD. Sin embargo, con AMEX sólo es permitido procesar en dólares estadounidenses (USD).


Marcas de tarjetas

Puedes procesar Visa, MasterCard y AMEX, emitidas en cualquier país.


Precio

El modelo en que 4Geeks Payments cobra es mediante una comisión pequeña por transacción de 5.5% + $0.30 USD por cada transacción satisfactoria mas IVA (Impuesto del Valor Agregado) sobre la comisión.

No hay mensualidades, ni cobros por configurar una cuenta, ni cargos ocultos adicionales u ocultos.


Legal

Suspensión de cuentas

Nosotros podremos suspender de manera preventiva su cuenta de producción si nos percatamos que su negocio se comprueba que los documentos proporcionados por usted o su equipo son falsos o alterados, si existe evidencia de Actividades no Autorizadas en su cuenta, si usted no otorgas los productos ofrecidos a sus clientes, si tenemos una sospecha fundada de que existen actividades relacionadas con cualquier tipo de fraude, lavado de dinero o que el sitio con el cual aplico se encuentra inactivo o varios sitios bajo las mismas credenciales de producción etc. En dicho caso sus montos se congelaran por un periodo de 3 meses como garantia.

Para que podamos reactivar su baja, usted contarás con 24 horas a partir de la baja preventiva para exhibir cualquier prueba que aclaren los hechos que dieron pie a dicha baja, de no lograr acreditar o comprobar lo contrario, la cuenta será dada de baja formalmente.

Negocios no permitidos

Estamos dispuestos a apoyar a la mayor cantidad de negocios posibles, sin embargo se debe de cumplir con ciertos requisitos que el departamento legal revisará minuciosamente.

Cualquier negocio puede crear una cuenta, y automáticamente obtendrá credenciales de prueba. Sin embargo, debe presentar documentación que garantice su legalidad y correcto funcionamiento bajo las leyes del país.

La documentación que le solicitaremos puede variar, sin embargo en este video encontrarás los requisitos básicos siendo una persona jurídica o personas física.

Algunos negocios que no podemos soportar:

La venta de medicamentos controlados o de prescripción médica, sustancias ilegales/altamente reguladas, ingeribles, inhalables, inyectables; farmacéuticos o productos farmacéuticos sin aprobación/permisos de la autoridad regulatoria correspondiente, macrobióticas, tiendas de ingredientes y perecederos; servicios médicos y hospitalarios; nutriólogos, psicólogos y planes alimenticios, tés relacionados con la salud, esteroides, blanqueadores de dientes, limpiador de colon y otros productos de desintoxicación, píldoras de dieta y productos relacionados, asesoría y consulta médica, réplicas sin autorización de marca, venta de animales, medios y software sin copyright o autorización, comercios relacionados con actividades violentas, equipo y software para jailbreak, materiales de hackeo y craqueo, pornografía, prostitución y abuso infantil, servicios de migración, créditos de muy alto interés, reparación o modificación de crédito, reducción de deudas, multas judiciales (sin permiso de gobierno), armas, armas deportivas, municiones y fuegos pirotécnicos, drogas, substancias y productos ilegales, cigarros electronicos, productos y servicios para adultos, casinos y apuestas, macrobióticas, comercialización multinivel, servicios de limpieza, cryptomonedas, medicamentos que no requieran receta médica, seguros, videojuegos, wallets, crowdfunding y fondos de inversión, servicios financieros de ahorro, préstamos y subvenciones, marketing, telemarketing, venta de software, creación y diseño de software y paginas web, diseño grafico, servicios y asesorías legales, servicios y asesorías contables, servicios y asesorías administrativas, casas de cambio, incluido compra venta de cualquier divisa; organizaciones políticas y religiosas, asociaciones civiles, inmobiliaria y renta de inmuebles (incluye Co-Working) venta de medios de transporte, aerolíneas, servicios de viajes, renta de autos, reservas hoteleras, operadores de viajes turísticos, servicios de transporte para aeropuertos, actividades vacacionales, mensajería y paquetería.

Cabe la posibilidad que no podamos soportar su negocio, inclusive si no está listado arriba.