fuente cibernética
Esta página proporciona una guía completa para integrar con éxito Cybersource con DEUNA.
Cybersource es una pasarela de pago global de Visa que permite el procesamiento seguro de pagos sin tarjeta presente. DEUNA se integra con Cybersource a través de REST API, lo que admite flujos comerciales estándar y procesamiento especializado de la industria de viajes con campos de datos específicos de las aerolíneas.
Operaciones soportadas
- Autorización
- Captura (completa y parcial)
- Compra (captura automática)
- Cancelar (anular)
- Reembolso (total y parcial)
- Cuotas (solo para MX)
- 3DS MPI
- Se pueden habilitar múltiples capturas parciales y reembolsos a través de la configuración en el Administrador
Métodos de pago admitidos
- visa
- Mastercard
- expreso americano
- Comensales
Países y monedas activos
- Estados Unidos (USD) y MX (MXN)
Integrar Cybersource#
- Busque Cybersource en Conexiones en el Administrador.
- Inicie sesión en su sesión de administrador de DEUNA.
- Clic Conexiones.
- Buscar fuente cibernética y haga clic Conectar.
- En Connections se abrirá el panel de configuración de Cybersource. Ingrese lo siguiente:
- Nombre: Introduzca un nombre para hacer referencia a esta configuración de credenciales.
- Moneda: la moneda utilizada
- Clave Privada: Introduzca su clave privada de la API de Cybersource.
- Clave Pública: Introduzca su clave pública.
- Merchant ID: Ingrese su ID de comerciante de Cybersource.
- Configuración del adquirente(sólo para MX): El comerciante puede elegir qué procesador utilizar. Si no se especifica ninguno, seleccione el Predeterminado option.
- Operaciones: Elija el tipo de operación que desea realizar: Compra o Autorización
- Elige si quieres activar, Captura Parcial Múltiple, Reembolso Parcial Múltiple de DEUNA y/o DEUNA 3DS.
- Clic Conectar. Una vez terminado, recibirá un mensaje de confirmación. Ya puedes consultarlo dentro de la pestaña Conexiones Activas.
Ejemplo interactivoUsa datos de ejemplo y no realiza solicitudes de API.
Pagos
Acme LATAM · ProducciónConexiones
Descubre y administra integraciones de pago, billeteras y antifraude.
| Conexiones | Tipo | Estado | Acción |
|---|---|---|---|
| Adyen | Pasarela de pago | Conectada | |
| Worldpay | Pasarela de pago | Conectada | |
| PayPal | Método de pago | Conectada | |
| Mercado Pago | Método de pago | Sin conectar | |
| Riskified | Motor antifraude | Sin conectar |
Industria de viajes
- DEUNA respalda el procesamiento para la industria aérea y de viajes con Cyberosurce, lo que permite el envío de datos específicos de la aerolínea que califican las transacciones para mejorar las tasas de intercambio y el cumplimiento de los requisitos de la red de tarjetas. _Esto sólo está disponible en el mercado estadounidense.
- Los campos de aerolíneas requieren flujo de autenticación + captura
- Envío de campos de datos de la aerolínea (
orderType": "AIRLINE_ORDER") solo se admite en el paso Captura de un flujo de Autorización + Captura. - Esta es una limitación de Cybersource, no de DEUNA. La operación de compra (captura automática) no admite campos de datos de aerolíneas.
- Para utilizar datos de la aerolínea: configure la conexión en el Admin con Autorización como tipo de operación.
- Envío de campos de datos de la aerolínea (
Campos obligatorios: pedido de aerolínea
| Campo de la DEUNA | Descripción |
|---|---|
order.airline_information.booking_items.legs[].carrier_code | Código de compañía aérea para el segmento de vuelo. IATA 2 caracteres alfabéticos. |
order.airline_information.booking_items.legs[].departure_date | Fecha de salida del segmento de vuelo. |
order.airline_information.booking_items.legs[].origin | Código del aeropuerto de origen. IATA 3 caracteres alfabéticos. |
order.airline_information.booking_items.legs[].destination | Código del aeropuerto de destino. IATA 3 caracteres alfabéticos |
order.airline_information.booking_items.legs[].fare_basis | Código de base de tarifa asociado al billete. Máximo: 6 caracteres. |
order.airline_information.booking_items.passenger_name | Nombre del pasajero. |
order.airline_information.booking_items.pnr | Referencia de reserva / PNR. |
Ejemplo:
JSON
{
"order": {
"airlineInformation": {
"bookingItems": [
{
"legs": [
{
"carrierCode": "AM",
"destination": {
"date": "26-03-26",
"iataCode": "MEX",
"time": "11:50"
},
"fareBasisCode": "Y",
"flightNumber": "411",
"origin": {
"date": "26-03-26",
"iataCode": "EWR",
"time": "08:01"
},
"serviceClass": "V",
"stopoverCode": "O"
},
],
"passenger": {
"firstName": "***dido",
"lastName": "***chez",
"type": "ADT"
},
"pnr": "CSOIUN"
}
]
},
"billingAddress": {
"address1": "***************3626",
"address2": "***** 100",
"addressType": "other",
"city": "Sacramento",
"countryCode": "PE",
"createdAt": "2024-01-24T17:04:18.341610378Z",
"email": "******eira@deuna.com",
"firstName": "Jean",
"identityDocument": "*******5894",
"lastName": "*mith",
"phone": "********7761",
"stateName": "LIM",
"updatedAt": "2024-01-24T17:04:18.34161046Z",
"zipcode": "95864"
},
"currency": "USD",
"itemsTotalAmount": 200,
},
"orderId": "66cc4f9d-293c-41a7-af80-377360a26134",
"subTotal": 200,
"timezone": "America/Mexico_City",
"totalAmount": 200,
"webhookUrls": {
"notifyOrder": "https://webhook.site/cadu"
}
},
"orderType": "AIRLINE_ORDER"
}Consideraciones especiales y limitantes#
Procesamiento asincrónico y actualizaciones de estado
- A diferencia de los procesadores síncronos, Cybersource no devuelve un estado final definitivo inmediatamente después de que se envía una transacción. Las transacciones progresarán a través de estados intermedios hasta que se complete el procesamiento final.
- Cybersource ejecuta su procesamiento por la noche. Durante el día, las transacciones permanecerán en
Processing,CapturingoRefundingstatus. - Luego del proceso completo en el lado de Cybersource, DEUNA actualiza la transacción a su estado final. Los comerciantes deben confiar en el punto final del estado de la transacción de DEUNA para obtener el estado actual de una transacción.