Cybersource

Esta página provee los pasos necesarios para integrar Cybersource como motor anti-fraude en DEUNA.

Requerimientos

El siguiente contenido enlista los requirimientos para una integracion exitosa con Cybersource.

• Cuenta en Cybersource
  • Cybersource secret
  • Cybersource Merchand ID
  • Cybersource Key
  • Nombre de tu organización en Cybersource
  • Username
  • Contraseña
• Cuenta en el ADMIN
  • Acesso al ambiente de pruebas DEUNA

Integrar Cybersource

Integra Cybersource en tu solución de pagos:

1. Conecta Cybersource en modo de prueba

Actva el modo prueba en el Admin y añade a Cybersource como motor anti-fraude:

1. Ve a Conexiones.
2. Busca a Cybersource y haz clic en Conectar.
3. Agrega tus credenciales de Cybersource para conectar el proveedor a DEUNA:
   • Nombre del comercio.
   • Private Key
   • Public Key
   • Merchant ID
4. Define las operaciones que deseas realizar:
   • Purchase
   • Authorize
5. Haz clic en Conectar para terminar.

2. Configura Cybersource como proveedor anti-fraude

Usa las credenciales de prueba para configurar Cybersource en tu estrategia de pagos:.

1. Ve a Estrategias de Pago
2. Busca la regla donde añadir a Cybersource.
3. Haz clic en Editar.
4. Añade a Cybersource como proveedor anti-fraude
5. Habilita la revisión manual.
6. Habilita la ejecución automática de operaciones.
7. Haz clic en Activar para activar la regla.

📘

Procesa el Riesgo Medio para activar la revisión manual.

3. Crea usuarios en Cybersource

Accede a Cybersource y crea usuarios para pruebas:

1. Ve al Panel de control de Cybersource.
2. Ve a Cuentas y selecciona Usuarios.
3. Haz clic en Crear usuario.
4. Crea los usuarios necesarios para pruebas.

4. Crea reglas de simulación

Crea listas de decisiones para simular escenarios de prueba:

1. Ve a Decision Manager.

2. Elige Shared Configuration.

3. Haz clic en Custom Lists.

   

4. Crea las listas de decisión:

   • Lista positiva: Añade emails que requieren ser siempre aceptados.
   • Lista de revisión :Añade emails que requieren revisión manual.
   • Lista negativa: Añade emails que requieren ser siempre rechazados.
   

📘

Para pruebas con MercadPago se necesita una sintaxis especial para mails de aprobación:

• [email protected] para listas positivas.
• [email protected] para listas de revisión.
• [email protected] para listas negativas.

5. Crea perfiles y reglas en Cybersource

Ahora, crea un perfil y dale prioridad a las reglas:

1. Ve a Decision Manager.
2. Elige Configuration.
3. Haz clic en Profiles.
4. Añade el perfil con reglas centralizadas.

📘

Usualmente un perfil preseleccionado llamado A-Test se encuentra disponible.

Crea reglas de decisión para puebas de aceptación, rechazo, y revisión manual de órdenes:

1. Ve a Decision Manager.
2. Elige Configuration.
3. Haz clic en Custom Rules.
4. Haz clic en Add Rule.
5. Añade las siguientes reglas:

Edita la configuración de reglas:

1. Ve a Decision Manager.
2. Elige Configuration.
3. Haz clic en Custom Rules.
4. Haz clic en Edit Rule.
5. Modifica las reglas segunsegún el perfil:

6. Haz clic en Update para terminar.

Configura la URL para recibir los resultados de las revisiones manuales:

1. Ve a Decision Manager.
2. Elige Configuration .
3. Haz clic en Extended settings.
4. Haz clic en Developer settings.
5. Activa Habilitar notificación del estado del pedido.
6. En Notification URL to receive notification pega https://api.sandbox.deuna.io/post-transactions/cybersource.
7. Haz clic en TEST URL.
8. En Notify for selecciona Reviewer decisions.
9. Haz clic en UPDATE SETTINGS para terminar.

6. Crea campos personalizados (MDDs)

Realiza dos configuraciones para crear campos personalizados (MDDS):

• En el Dashboard de Cybersource
• En tu configuración de perfil en DEUNA

Dashboard de Cybersource

1. Ve al panel de control de Cybersource
2. Ve a Decision Manager
3. Haz clic en Configuración compartida.
4. Elige Campos personalizados.
5. Haz clic en Agregar campo personalizado.
6. Usa las configuraciones sugeridas.

Campos sugeridos

Configuración de perfil en DEUNA

Crea los campos personalizados (MDDs) para la configuración del backend:

1. Crea valores constantes que se mapeen como MDD como se muestra en la siguiente solicitud:

curl --location --request PUT 'https://api.stg.deuna.io/merchant/89c0d37b-981e-4fdd-928a-947813fb38b7/profile' \
--header 'Content-Type: application/json' \
--header 'Cookie: AWSALB=sezOm4eWdkRjRNhNikLbvgWT1fCBHVtYAZA0Cl83Gf3DDhVAzvKl7+A7pkkU3g034zsrFPB9UVwYIji32bmmAoxvXr1uM/lbP6IaGc3lT7dNjeP0mBbajbQ67B4q; AWSALBCORS=sezOm4eWdkRjRNhNikLbvgWT1fCBHVtYAZA0Cl83Gf3DDhVAzvKl7+A7pkkU3g034zsrFPB9UVwYIji32bmmAoxvXr1uM/lbP6IaGc3lT7dNjeP0mBbajbQ67B4q; AWSALB=IdENTlkIaa9SGGBdZ8Dd/LAcvyqscwq/UwRh6DKiVzfS+RQ9ZZ0jBT9e+mrX8FTEeKs8wfcXEVFmVKNhNcy/qW1zh5MGxj5/+jQdMwrqyFuSpEAl4mGjfQYO3DbI; AWSALBCORS=IdENTlkIaa9SGGBdZ8Dd/LAcvyqscwq/UwRh6DKiVzfS+RQ9ZZ0jBT9e+mrX8FTEeKs8wfcXEVFmVKNhNcy/qW1zh5MGxj5/+jQdMwrqyFuSpEAl4mGjfQYO3DbI' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IlZOUDlOVGM2SWdxVDhhYVRqYlFnOTRPa2wzZHgtLWZfQjdNdXdTNmYzdmMiLCJ0eXAiOiJKV1QifQ.eyJlbWFpbCI6ImRldmVsb3BlcnNAZ2V0ZHVuYS5jb20iLCJleHAiOjE3MTYwMDUyMDMsImlhdCI6MTcxNTc0NjAwMywibWVyY2hhbnRfaWQiOm51bGwsIm5ldHdvcmtfaWQiOm51bGwsInJvbGUiOiJzdXBlcmFkbWluIiwic3RvcmVfY29kZSI6bnVsbCwic3ViIjoiMSJ9.ZxpZuwIgbJPOTO67-iO_77qRwgaFHI5f8POv-SfZLpH3Auehrlm7T9gQhQK2D0a-spnUouauCFaKj82ZWX8PpRpw0xzyFsIpvDdNKrgxbMtX_g7ve-FsLCxFL8tWhBj6yKG2f8Hzr88FqNFmSO5Vd0NVCon_WkUgKZ3mDHZ4Uf3Uy5HoYPXyLqIaIkG4oCJtC9BZGGax3san8kat-xZRu-SeMXnCwyofeUSkDfpFCYBz1wlkz7KoPDkPSgHdiBBnRi5z-bp_l6bSjir8BHMBc6xa5tdh0bq_UNIbi-wteJaoYuVyvjEO2q04jwCsrnEDV9qVql26PpyyYPveEaY6hMKWRUMpPk0NxOm_hEkgMpR2qyylYXB0X5bb_kzIYCMAKl7F5k6tY6LjRuAQLe20ibQpZmJ7--E_qI3uQsawtptbnGirDu7KeqcBLEJ_K7LoRYeDShJ_DY1MV8Di2Rrnx11g5nNOTNDLzh8PNrEMWEgpwk81oQSG2UcZhOuMCReiZ9abZtnaGVhPjB0pmTty1zhEOzXxbAA87QxwRaY-2hky7RcyCo07tvqKUXFrQomDj5NikMLTUYwydy9jNNJ3vmD3j9fo-7fMCDcic2K3qFHcbujfxnwcMWRkhj1oc3pNSysEBjUKuOGKmoSq8QxzRiihV7_FoOaXqX6pkVrB69Q' \
--data '{
 
    "merchant_information": {
        "business_line": "ecommerce"   
    }
}'

📘

Los valores disponibles para MDsD son los objetos de facturación, envío, artículos, y los valores calculados como se muestra en los ejeplos.

2. Envía una solicitud para declarar la merchant_custom_information que se usa como MDD en Cybersource.
3. Si quieres usar campos de metadatos para enviar como campos personalizados (MDDS):
   1. Envia los campos de metadatos a DEUNA en el objeto additive_data dentro del objet metadata.
   2. Mapea los campos para mapeo a Cybersource bajo el objeto merchantCustomInformation.additional_data con el nombre del campo de metadatos más el número de campo definido (MDD).
4. Declara el nombre del objeto en tu configuración si usas un nombre de objeto diferente.

curl --location --request PUT 'https://api.stg.deuna.io/merchant/89c0d37b-981e-4fdd-928a-947813fb38b7/profile' \
--header 'Content-Type: application/json' \
--header 'Cookie: AWSALB=sezOm4eWdkRjRNhNikLbvgWT1fCBHVtYAZA0Cl83Gf3DDhVAzvKl7+A7pkkU3g034zsrFPB9UVwYIji32bmmAoxvXr1uM/lbP6IaGc3lT7dNjeP0mBbajbQ67B4q; AWSALBCORS=sezOm4eWdkRjRNhNikLbvgWT1fCBHVtYAZA0Cl83Gf3DDhVAzvKl7+A7pkkU3g034zsrFPB9UVwYIji32bmmAoxvXr1uM/lbP6IaGc3lT7dNjeP0mBbajbQ67B4q; AWSALB=IdENTlkIaa9SGGBdZ8Dd/LAcvyqscwq/UwRh6DKiVzfS+RQ9ZZ0jBT9e+mrX8FTEeKs8wfcXEVFmVKNhNcy/qW1zh5MGxj5/+jQdMwrqyFuSpEAl4mGjfQYO3DbI; AWSALBCORS=IdENTlkIaa9SGGBdZ8Dd/LAcvyqscwq/UwRh6DKiVzfS+RQ9ZZ0jBT9e+mrX8FTEeKs8wfcXEVFmVKNhNcy/qW1zh5MGxj5/+jQdMwrqyFuSpEAl4mGjfQYO3DbI' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IlZOUDlOVGM2SWdxVDhhYVRqYlFnOTRPa2wzZHgtLWZfQjdNdXdTNmYzdmMiLCJ0eXAiOiJKV1QifQ.eyJlbWFpbCI6ImRldmVsb3BlcnNAZ2V0ZHVuYS5jb20iLCJleHAiOjE3MTYwMDUyMDMsImlhdCI6MTcxNTc0NjAwMywibWVyY2hhbnRfaWQiOm51bGwsIm5ldHdvcmtfaWQiOm51bGwsInJvbGUiOiJzdXBlcmFkbWluIiwic3RvcmVfY29kZSI6bnVsbCwic3ViIjoiMSJ9.ZxpZuwIgbJPOTO67-iO_77qRwgaFHI5f8POv-SfZLpH3Auehrlm7T9gQhQK2D0a-spnUouauCFaKj82ZWX8PpRpw0xzyFsIpvDdNKrgxbMtX_g7ve-FsLCxFL8tWhBj6yKG2f8Hzr88FqNFmSO5Vd0NVCon_WkUgKZ3mDHZ4Uf3Uy5HoYPXyLqIaIkG4oCJtC9BZGGax3san8kat-xZRu-SeMXnCwyofeUSkDfpFCYBz1wlkz7KoPDkPSgHdiBBnRi5z-bp_l6bSjir8BHMBc6xa5tdh0bq_UNIbi-wteJaoYuVyvjEO2q04jwCsrnEDV9qVql26PpyyYPveEaY6hMKWRUMpPk0NxOm_hEkgMpR2qyylYXB0X5bb_kzIYCMAKl7F5k6tY6LjRuAQLe20ibQpZmJ7--E_qI3uQsawtptbnGirDu7KeqcBLEJ_K7LoRYeDShJ_DY1MV8Di2Rrnx11g5nNOTNDLzh8PNrEMWEgpwk81oQSG2UcZhOuMCReiZ9abZtnaGVhPjB0pmTty1zhEOzXxbAA87QxwRaY-2hky7RcyCo07tvqKUXFrQomDj5NikMLTUYwydy9jNNJ3vmD3j9fo-7fMCDcic2K3qFHcbujfxnwcMWRkhj1oc3pNSysEBjUKuOGKmoSq8QxzRiihV7_FoOaXqX6pkVrB69Q' \
--data '{
    "merchant_custom_information": {
        "installments": "37",
        "items_0_title": "22",
        "items_1_brand": "25",
        "items_1_title": "26",
        "items_2_title": "28",
        "items_3_brand": "32",
        "items_3_title": "31",
        "items_4_brand": "35",
        "items_4_title": "34",
        "items_5_brand": "57",
        "items_5_title": "56",
        "items_6_brand": "59",
        "items_6_title": "58",
        "items_7_brand": "61",
        "items_7_title": "60",
        "items_8_brand": "63",
        "items_8_title": "62",
        "billing_address": {
            "city": "4",
            "phone": "8",
            "zipcode": "7",
            "address2": "5",
            "last_name": "2",
            "first_name": "1",
            "state_name": "3"
        },
        "shipping_amount": "9",
        "shipping_address": {
            "city": "46",
            "phone": "50",
            "zipcode": "49",
            "addres2": "47",
            "last_name": "44",
            "first_name": "43",
            "state_name": "45"
        },
        "is_coupon_applied": "40",
        "is_installments_msi": "36",
        "items_0_description": "21",
        "items_2_description": "29",
        "get_spanish_day_of_week": "55",
        "get_full_billing_address": "6",
        "get_full_shipping_address": "48",
        "get_channel_from_user_agent": "54",
        "get_total_quantity_products": "18",
        "get_total_discount_percentage": "39",
        "get_full_name_shipping_address": "70",
        "get_max_unit_price_product_name": "19"
    }
}'

📘

Para billing en Estados Unidos y Canada, usa los siguientes valores para cada estado o provincia:

US States- JSONCanada States - JSON

uspsStateCodes = map[string]bool{
		"AL": true,
		"AK": true,
		"AS": true,
		"AZ": true,
		"AR": true,
		"CA": true,
		"CO": true,
		"CT": true,
		"DE": true,
		"DC": true,
		"FM": true,
		"FL": true,
		"GA": true,
		"GU": true,
		"HI": true,
		"ID": true,
		"IL": true,
		"IN": true,
		"IA": true,
		"KS": true,
		"KY": true,
		"LA": true,
		"ME": true,
		"MH": true,
		"MD": true,
		"MA": true,
		"MI": true,
		"MN": true,
		"MS": true,
		"MO": true,
		"MT": true,
		"NE": true,
		"NV": true,
		"NH": true,
		"NJ": true,
		"NM": true,
		"NY": true,
		"NC": true,
		"ND": true,
		"MP": true,
		"OH": true,
		"OK": true,
		"OR": true,
		"PW": true,
		"PA": true,
		"PR": true,
		"RI": true,
		"SC": true,
		"SD": true,
		"TN": true,
		"TX": true,
		"UT": true,
		"VT": true,
		"VI": true,
		"VA": true,
		"WA": true,
		"WV": true,
		"WI": true,
		"WY": true,
	}

canadaPostProvinceCodes = map[string]bool{
		"AB": true,
		"BC": true,
		"MB": true,
		"NB": true,
		"NL": true,
		"NS": true,
		"NT": true,
		"NU": true,
		"ON": true,
		"PE": true,
		"QC": true,
		"SK": true,
		"YT": true,
	}

Ejemplo de metadata

        "metadata": {
            "additional_data.account_name": "Nelson",
            "additional_data.identity_type": "DNI"
            
        },

Ejemplo de configuración

{
    "merchant_custom_information": {
        "merchant_information": {
            "business_line": "22",
            "merchant_identifier": "1"  
        },     
        "metadata": {
            "additional_data.merchant_terminal": "2",
            "additional_data.account_name": "4",            
            "additional_data.created_at_date": "6",
            "additional_data.created_at_time": "7",
            "additional_data.item_category_name": "23",
            "additional_data.item_category_code": "24",
            "additional_data.total_discount": "25",
            "additional_data.giftcard": "28"
        },
        "installments": "17",
        "billing_address": {
            "identification_type": "18",
            "identification": "19",
            "phone": "21"
        },
        "email": "20",
        "shipping_options": {
            "type": "26"
        },
        "shipping_address": {
            "city": "27",
            "address1": "30"
        },
        "get_full_name_billing_address_uppercase": "31"    
    }   
} 

Tabla de campos

7. Configura el Device Fingerprint para Cybersource

El Device Fingerprint para Cybersource es un código generado por un script que se ejecuta durante el proceso de pago.

El código se envía a tus servidores y debe debe enviarse en la solicitud de compra para que Cybersource pueda identificarlos.

Ejemplo

org_id=1snn5n9w&session_id=deuna_dmbfd62cb3-108b-552f-920a-15da86adb622

El código está compuesto por:

• org_id: Un código de envío a tu tienda, cambia dependiendo del ambiente.
• session_id: Un código compuesto por el nombre de tu tienda y su UUID.

Parámetros requeridos

• cs_orgId debe ser igual a:
  • 1snn5n9w para ambiennte sandbox o prueba.
  • k8vif92e para ambiente productivo.
• El valorcs_merchantId es asignado por Cybersource para cada tienda.

Para VTEX.

Si usas VTEX, añade el siguiente script en el código checkout6-custom.js de tu configuración:

{

	},
	CYBERSOURCE: {
      "cs_orgId": "1snn5n9w",
      "cs_merchantId": "deuna_dm" 
	},

	STRIPE: {
      "API_KEY": "pk_test_TYooMQauvdEDq54NiTphI7jx" //if applies
	},

  MERCADOPAGO: {
      // if applies
  },

  }  
}

Para Direct API

Si tu integración con DEUNA es Direct API, integra el script de Cybersource en tu aplicación:

Script de implementación

<script type="text/javascript" src="https://h.online-metrix.net/fp/ tags.js?org_id=<org ID>&session_id=<merchant ID><session ID>"></ script>

<noscript>
    <iframe style="width: 100px; height: 100px; border: 0; position: absolute; top: -5000px;" src="https://h.online-metrix.net/fp/tags?org_ id=<org ID>&session_id=<merchant ID><session ID>"></iframe>
</noscript>

Ejemplo de output

bfd62cb3-108b-552f-920a-15da86adb622

1. Corre el script.
2. Usa el output y mandalo a DEUNA.
   • Para V1, en el token de Crear Pago como el devce_id.
   • Para V2, en el header de Crear Pago V2 como el x-device-id.
3. Añade tus credenciales en en script.
   • <org ID> debe ser igual a : Must be 1snn5n9w para ambiente sandbox o prueba.
   • <org ID> debe ser igual a k8vif92e para ambiente productivo.
   • <merchant ID>: Tu id de Cybersource.
   • <session ID>: Un UUID de valor único por orden. Se envía dentro del device_id para V1 y dentro del x-device-id para V2.

8. Prueba la integración

Realiza transacciones de prueba con la siguientes credenciales:

Comienza las pruebas en el ADMIN:

1. Guarda una estrategia de pago
   • Procesa pruebas con Riesgo Medio para revisión manual.
2. Ingresa al Panel de Control de Cybersource.
3. Ve a Administrador de Decisiones de Revisión Manual
4. Ve a Gestión de Casos
5. Haz clic en Casos.
6. Selecciona las fechas o el ID del pedido de prueba en el buscador.
7. Haz clic en Buscar.
8. Selecciona el último intento realizado con el número del pedido. de interés.
   • Cada intento genera un ID de solicitud nuevo asociado al mismo ID de pedido.
9. Acepta o aprueba la transacción.
10. Reevisa las transacciones en el ADMIN DEUNA.
11. En la sección Fraude, deben aparecer los siguientes valores:
    • Riesgo bajo
    • Riesgo medio (si la revisión manual no está activada)
    • Riesgo alto
    • Revisión manual: Aprobado por la pasarela de pago, pero pendiente de aprobación o rechazo manual en el panel de control de Cybersource.
    • Aprobado: Aprobado el panel de control de Cybersource
    • Rechazado: Rechazado en el panel de control de Cybersource

📘

Recuerda usar los valores correctos para estados y provincias en la etapa de billing.

9. Configura el ambiente productivo

Repite el proceso en tu ambiente productivo, con los siguientes valores:

1. Panel de control de producción: https://businesscenter.cybersource.com/ebc2/

2. URL del webhook: https://apigw.getduna.com/post-transactions/cybersource

3. Crea un nuevo perfil

4. Establece reglas para aprobar, denegar, o revisar manualmente.

5. Añade de nuevo los MDD.

6. El org_id del Device Fingerprint debe ser igual a k8vif92e.

7. Desactiva el Modo prueba en el ADMIN DEUNA.

8. Añade Cybersource como proveedor de motor anti-fraude en Conexiones.

9. Activa las funciones de revisión manual.

10. En Configuración general de fraude:

    • Habilite la revisión manual.
    • Habilita la ejecución automática de operaciones.

11. Configura las pasarelas de pago y establece una estrategia de pago.

12. Procesa el riesgo medio para habilitar la revisión manual.

Una vez activado, podemos continuar con el proceso.

👍

Cybersource está activado como motor anti-fraude.