flutter_paymentez_sdk

Description:

flutter paymentez sdk

PaymentezSDK una solución estable, eficiente y fácil de implementar. ofreciendo una experiencia de integración sin
fisuras en aplicaciones Dart y Flutter. Con un enfoque en la estabilidad y cobertura de código completa, este SDK es
ideal tanto para empresas 🏢 como para 🧑🏻‍💻desarrolladores👨🏻‍💻 independientes que buscan integrar las capacidades de pago
avanzadas de Paymentez, evitando las complicaciones técnicas habituales.
📑 NOTA: Es importante destacar que Paymentez ha sido adquirida por Nuvie. Como resultado de
esta adquisición, los servicios de Paymentez continuarán estando disponibles exclusivamente en Ecuador hasta el año
2027-2028 🗓.
Características #
PaymentezSDK ofrece una gama completa de funcionalidades para facilitar y optimizar la integración de pagos en sus
aplicaciones Flutter. Estas son algunas de las características clave:
Gestión del Baúl de Paymentez
Crear Tarjetas 💳: Permite a los usuarios añadir tarjetas de crédito/débito al baúl de Paymentez de forma segura.
Listar Tarjetas 💳: Obtenga una lista de todas las tarjetas guardadas asociadas a un usuario.
Eliminar Tarjetas 💳: Ofrece a los usuarios la posibilidad de eliminar tarjetas guardadas en el baúl de Paymentez.
Procesamiento de Pagos
Con PCI: Permite procesar pagos directamente, manejando datos de tarjetas y cumpliendo con los estándares de
seguridad de PCI.
Sin PCI usando el bauld: Facilita el procesamiento de pagos sin manejar directamente los datos de la tarjeta,
utilizando el sistema de baul de Paymentez.
Devoluciones: Capacidad integrada para realizar devoluciones de pagos, permitiendo una gestión completa del ciclo
de vida de las transacciones.
3D Secure: Incorpora métodos para soportar la autenticación 3D Secure, añadiendo una capa adicional de seguridad
en las transacciones en línea.
Validación de Pagos con OTP: Permite la validación de pagos mediante el uso de OTP, asegurando una mayor seguridad
y cumplimiento en las transacciones.
Instalación #
Nunca debe exponer sus credenciales de servidor en el código del lado del cliente de ningún sitio web público.
Para iniciar la integración, deberá solicitar a Nuvie Team [email protected] una cuenta de
Desarrollo/Sandbox. Por favor envíanos tu correo electrónico para identificarte como desarrollador y el nombre de tu
empresa.
Configuración Inicial #

final sdk = PaymentezSDK(
clientApplicationCode: 'APP.....CODE.....CLIENT',
clientAppKey: 'L38fv.....KEY.....RXQoz',
serverApplicationCode: 'APP.....CODE.....SERVER',
serverAppKey: 'voRXQ.....KEY......Kn9v6I',
);
copied to clipboard
Ejemplos de Uso #
Guardar un Tarjeta
Es una función típicamente utilizada en plataformas de procesamiento de pagos como Paymentez para agregar una tarjeta de
crédito o débito en un baúl de protección donde se tokenizan las tarjetas agregadas para garantizar la seguridad y la
privacidad de los datos, donde cada tarjeta agregada está vinculada a un usuario específico.

final addCardRequest = AddCardRequest(
user: UserCard(
id: '5a9b9072-4d60-4846-be71-d533d3851901',
email: '[email protected]',
),
card: NewCard(
number: '4111111111111111',
holderName: 'citlali calderon',
expiryMonth: 9,
expiryYear: 2025,
cvc: '123',
),
);

final (addCardResponse, paymentezError) = await
sdk.addCard
(
addCardRequest
);
copied to clipboard
Eliminar Tarjeta:
La eliminación de una tarjeta del baul de protección de Paymentez es un proceso seguro que garantiza que la información
de la tarjeta se elimine completamente de la base de datos. Esto es crucial para mantener la seguridad de los datos del
usuario y para darles control sobre sus métodos de pago almacenados. La función deleteCard es especialmente importante
para gestionar tarjetas que han expirado, se han perdido o han sido reemplazadas.
copied to clipboard
Listar Tarjetas guardafas:
Esta lista incluye detalles relevantes como el tipo de tarjeta, los últimos cuatro dígitos, la fecha de vencimiento y el
nombre del titular, proporcionando una manera clara y segura de visualizar y gestionar sus métodos de pago. Esta función
es útil para que los usuarios revisen rápidamente sus tarjetas guardadas y seleccionen la más adecuada para sus
transacciones.
copied to clipboard
Pay with token card
Esta función permite a los usuarios realizar compras utilizando una orden tokenizada. En este método, la información de
la tarjeta del usuario ya ha sido previamente tokenizada y almacenada de forma segura. Al realizar una compra, el
usuario simplemente referencia el token de su tarjeta almacenado, en lugar de ingresar los detalles de la tarjeta cada
vez. Esto no solo agiliza el proceso de compra, sino que también mejora la seguridad, ya que los datos sensibles de la
tarjeta no se transmiten durante la transacción. Es ideal para los usuarios que realizan compras recurrentes o quieren
una experiencia de pago más rápida y segura.

final model = PayRequest(
user: UserPay(
id: '5a9b9072-4d60-4846-be71-d533d3851901',
email: '[email protected]',
phone: '+593555555555',
),
order: OrderPay(
taxPercentage: 12,
taxableAmount: 292.86,
vat: 35.14,
amount: 328,
description: 'pozole',
devReference: 'cod_order_buy_001',
),
card: CardToken(
token: '14329172493919123772',
),
);

final (payResponse, paymentezError) = await
sdk.debit
(
model
);
copied to clipboard
Pay with card direct
Esta función permite a los usuarios realizar compras ingresando los detalles de su tarjeta de crédito o débito
directamente en cada transacción. A diferencia de las órdenes tokenizadas, aquí se proporciona la información de la
tarjeta en cada compra, lo que puede ser preferible para usuarios que no desean almacenar sus datos de tarjeta o para
transacciones únicas. A pesar de requerir más pasos en cada compra, esta opción mantiene altos estándares de seguridad,
incluyendo la validación de datos y posiblemente la autenticación 3D Secure, para proteger contra el fraude y el uso
indebido de la tarjeta.

final payPCIRequest = PayPCIRequest(
user: UserPay(
id: '5a9b9072-4d60-4846-be71-d533d3851901',
email: '[email protected]',
phone: '+593555555555',
),
order: OrderPay(
taxPercentage: 12,
taxableAmount: 292.86,
vat: 35.14,
amount: 328,
description: 'pozole',
devReference: 'cod_order_buy_001',
),
card: CardPCI(
number: '4111111111111111',
holderName: 'citlali calderon',
expiryMonth: 9,
expiryYear: 2025,
cvc: '123',
),
);

final (payResponse, paymentezError) = await
sdk.debitCC
(
payPCIRequest
);
copied to clipboard
Manejo de Errores #
Contribuciones #