Introducción
Una billetera digital por etapas es una billetera en la que el cliente primero carga un saldo y luego lo gasta, en dos transacciones de tarjeta separadas. Ambas transacciones las cobra el operador de la billetera, la empresa que la administra, y no la tienda en la que el cliente compra finalmente. Por eso, las redes de tarjetas exigen que cada transacción se marque como tráfico SDWO (Staged Digital Wallet Operators). Marcarla correctamente es lo que le da a la transacción el interchange adecuado, el tratamiento de cumplimiento correcto y una tasa de aprobación limpia. SDWO no es un método de pago nuevo. En ambas transacciones el método de pago sigue siendo la tarjeta del cliente, y envías la misma solicitud Create payment que ya envías. Lo que cambia son los datos que le adjuntas, que Yuno traduce a la estructura de billetera que espera el proveedor.Las dos operaciones
La presencia del objeto
account_funding es el único campo que diferencia las dos operaciones. No envías un tipo de operación, un código de procesamiento ni un ID de billetera: Yuno deriva los valores específicos del proveedor a partir del objeto que envías y de la configuración de tu conexión.
Este es el mismo objeto
account_funding descrito en Account Funding Transactions (AFTs). SDWO es el caso de billetera por etapas de una AFT: el cash-in es una transacción de fondeo de cuenta, y la compra es la segunda transacción, que solo existe en las billeteras por etapas.Proveedores compatibles
Rede es el único proveedor con compatibilidad con SDWO hoy. El objeto
account_funding es el mismo que lee toda integración de fondeo de cuenta de Yuno, por lo que habilitar otro proveedor más adelante no cambia tu integración.
Crear un cash-in
Envía un pago normal con tarjeta más el objetoaccount_funding, que identifica quién fondea la operación y quién recibe el saldo, y seller_details, que identifica al operador de la billetera.
Cash-in request
Campos del cash-in
Crear una compra
La compra es un pago estándar con tarjeta con el submerchant enseller_details y sin el objeto account_funding.
Purchase request
seller_details describe al submerchant que recibe el pago, no al operador de la billetera.
Respuesta
SDWO no agrega campos a la respuesta. Recibes el objeto de pago estándar y sigues el estado del pago exactamente como lo haces con cualquier pago con tarjeta. Los datos de la billetera que enviaste se usan para construir la solicitud al proveedor; no se devuelven en el pago ni en llamadasGET posteriores, así que conserva tu propio registro de la cuenta de billetera que fondeó cada pago.
Lo que Yuno gestiona por ti
Nunca envías valores de billetera específicos del proveedor. Yuno los deriva de tu conexión y de la red de tarjetas:- El código de operación. Para Rede, el
processingTypeque marca la transacción como01compra o02cash-in. - El ID de la billetera. Se registra en cada red de tarjetas y se almacena en tu conexión, con un formato distinto para cada una.
- El destino del pago. El código que le indica al proveedor qué tipo de cash-in es. Se define en tu conexión, no en cada solicitud. Consulta la limitación más abajo.
- Las reglas de cada red de tarjetas. Qué datos incluye cada una: Mastercard no admite los datos del remitente, Elo exige la dirección completa del submerchant y el soft descriptor se trunca a 18 caracteres.
Antes de salir a producción
- Registra tu ID de billetera en cada red de tarjetas que vayas a procesar. Tu proveedor lo solicita para Mastercard y Visa; Elo lo solicitas tú directamente a la red. Sin un ID de billetera registrado, el proveedor rechaza la transacción de billetera.
- Pide a tu proveedor que habilite el alcance de billetera en tu cuenta de comercio. Las operaciones de billetera se habilitan por cuenta de comercio, y una cuenta que no las tiene devuelve un error de parámetro no permitido incluso cuando la solicitud es correcta.
- Usa una conexión dedicada para el tráfico SDWO. SDWO se habilita a nivel de conexión, por lo que una conexión con SDWO activado marca todos los pagos con tarjeta que se enrutan por ella. Mantén tus ventas regulares con tarjeta en una conexión separada.
Limitaciones
- Una variante de cash-in por conexión. El destino del pago se configura en tu conexión en el dashboard de Yuno, no se envía en cada solicitud, por lo que una sola conexión siempre produce el mismo tipo de cash-in. Si tu negocio necesita más de una variante, pide a tu contacto de Yuno una conexión por variante.
- Consumer Bill Payment Service (CBPS) no es compatible. Pagar una factura o un boleto con saldo de billetera como programa de pago de facturas de una red de tarjetas no está disponible hoy.
- El campo
funding_typeno se usa. La API aceptaaccount_funding.funding_type, pero ninguna integración con proveedores lo lee todavía, por lo que no cambia cómo se procesa la operación.