Acepta pagos con tarjeta

Conoce el paso a paso de cómo crear un pago con tarjeta en Perú.

Crear un pago con tarjeta en Perú consiste en capturar los datos necesarios del cliente para el pago y hacer una solicitud a través de nuestra API con un Bearer Token y una secretKey. De esta forma, las transacciones se autentican y se realizan de forma segura.

Los pagos con tarjeta cuentan con la herramienta automatizada Decision Manager (DM) del motor de gestión de riesgos y prevención de fraude de Cybersource (A Visa Solution), junto con el sistema 3DS, el cual activa los desafíos (challenges) correspondientes para validar o rechazar transacciones.



¿Cómo funciona?

Pagos con Tarjeta es un servicio que permite aceptar pagos con tarjetas de crédito y débito en Perú. Para completar una transacción utilizando este método de pago, el cliente debe seleccionar la opción "Paga con Tarjeta" e ingresar los datos de su tarjeta, incluyendo número, fecha de expiración y código CVV.

El proceso de pago con tarjeta en Perú consta de cinco etapas principales:

  1. Selección de método. El cliente elige pagar con tarjeta en tu sitio web o aplicación.
  2. Ingreso de datos. El cliente llena los datos requeridos en el formulario de pago con tarjeta, como: número de tarjeta, fecha de vencimiento, CVV, nombre y correo electrónico. Si tienes activadas las opciones, el cliente verá también la opción de pagar en cuotas y la de recordar tarjeta.
  3. Validación de datos. Se verifican los datos con el emisor de la tarjeta.
  4. Autorización y Captura. Se verifica que existan los fondos suficientes, y se mueven desde el banco del cliente hacia la cuenta de tu comercio.
  5. Confirmación. El cliente ve en pantalla el resultado de la transacción. A su vez, tu comercio recibe la confirmación a través de los webhooks que hayas configurado.

Especificaciones

El pago con tarjeta en Perú cuenta con características extras. Algunas de ellas las puedes activar o desactivar en el Portal de servicios, según lo requieras. A continuación se detallan.

Pago en cuotas

El sistema detectará automáticamente si se está realizando un pago con tarjeta de crédito o débito, en caso de ser tarjeta de crédito, la opción de cuotas se mostrará en automático en el formulario. El número de cuotas son definidas por el emisor de la tarjeta, así como por el banco del usuario.

Recordar tarjeta

Si el cliente desea recordar su tarjeta para futuras compras, contamos con un campo extra dentro del formulario de pago. Podrá asignarle un alias a cada tarjeta que decida guardar:

📘

Tarjetas guardadas por monedas

Si el cliente guarda una tarjeta después de un pago en soles, esa tarjeta guardada solo se podrá utilizar para pagos futuros en soles. Si desea usarla en dólares, deberá guardarla nuevamente en dólares.

Pago con tarjetas foráneas

Nuestro sistema cuenta con soporte de pagos con tarjetas foráneas. Se detectará en automático cuando se trata de una tarjeta de este tipo, con lo cual, el cliente verá dos campos extras en su formulario de pagos (ciudad y país de la tarjeta):

📘

Marcas de tarjetas aceptadas

Consulta el listado de marcas de tarjetas aceptadas en transacciones a través de ProntoPaga para Perú, Chile y Ecuador en este artículo.


Crea un nuevo pago

Tu front-end será el encargado de recopilar los datos de información del usuario. Los datos sensibles, como el número de tarjeta o CVV, son ingresados por tu cliente en el enlace recibido para procesar el pago. Tu back-end luego recibirá el estado de la transacción.



Motivos de rechazo

A continuación se muestran varios posibles casos de rechazo junto con su código y descripción. Además, incluimos posibles datos de prueba para utilizar en cada caso:

CódigoDescripción
0Afiliación a REC no exitosa
101Tarjeta vencida
102Operación no permitida para esta tarjeta
113Monto no permitido
116Fondos insuficientes
118Tarjeta inválida
129Tarjeta no operativa
180Tarjeta inválida
190Contactar emisor
191Contactar emisor
208Tarjeta perdida
209Tarjeta robada
599Operacion denegada. Problemas de comunicacion
666Problemas de comunicacion
670Transacción denegada por posible fraude
679Error de autenticación
754Comercio no válido


Devolución de un pago

Para solicitar la devolución de un pago exitoso realizado con este método, debes ingresar al Portal de servicios de ProntoPaga.



Personalizar el formulario de pago

Puedes ajustar la apariencia de tu formulario con el parámetro opcional theme, cambiando el color de fondo o creando versiones en modo claro y modo oscuro con este endpoint. A continuación, se muestra un ejemplo del body request:

{
  "currency": "PEN",
  "country": "PE",
  "amount": "100.90",
  "clientName": "John Doe",
  "clientEmail": "[email protected]",
  "clientPhone": "999999999",
  "clientDocument": "12345678912",
  "paymentMethod": "pe_card_payment",
  "urlConfirmation": "https://www.webhook.com",
  "urlFinal": "https://sandbox.prontopaga.com/successful",
  "urlRejected": "https://sandbox.prontopaga.com/declined",
  "order": "XYZ789",
  "theme": {
    "bgColor": "transparent", 
    "mode": "dark"
	},
  "sign": "Signature of the parameters"
}


Límites transaccionales

Ten en cuenta que cada banco establece sus propios límites transaccionales. Estos límites pueden variar dependiendo del tipo de cuenta o sistema de autenticación del banco.

Consulta los límites transaccionales para el comercio, del procesador y de ProntoPaga en el siguente artículo:



Prueba tu integración

Contamos con un catálogo de datos de prueba que puedes usar para comprobar que tu integración está lista, así como para ver el flujo de pago que seguirá tu cliente. Además, puedes hacer pruebas con nuestros demos:



Certifica tu integración

La certificación de la integración en sandbox es un paso obligatorio que todos los comercios deben realizar antes de recibir sus credenciales de producción. Su propósito es asegurar que la integración cumpla con los estándares técnicos, funcionales y de seguridad requeridos por ProntoPaga. Dentro de esta sección, se establecen los requisitos que deben cumplirse sin excepción para que la certificación sea aprobada.

Requisitos de certificación

A continuación, encontrarás los distintos requisitos necesarios para completar tu certificación:

  • ❌ El documento de identidad del cliente no debe ser modificable en ningún punto de la transacción.

  • ✅ Es recomendable que este dato no se muestre en el checkout. Solo puede estar disponible en la sección de perfil del usuario autenticado.

  • ⚠️ Esta medida tiene como objetivo prevenir fraudes y evitar que se realicen transacciones en nombre de terceros o menores de edad.


Did this page help you?