Ebanx Local | DEUNA Docs

En esta página

Integrar Ebanx
Consideraciones y limitaciones especiales

Esta página proporciona una guía para integrar Ebanx Local con DEUNA.

Operaciones soportadas

La integración de Ebanx en tu estrategia de pagos con DEUNA te permite realizar las siguientes operaciones:

Autorización
Captura completa
Anulación
Compra (captura automática)
Reembolso parcial (hasta uno por pedido)
Reembolso completo
Cuota

Países y monedas activos

Brasil, Chile, Colombia y México.

Requisitos

Contacta a tu representante de Ebanx y solicita las siguientes credenciales:

Tus credenciales de Ebanx

Asegúrese de que su cuenta esté configurada correctamente en el lado de Ebanx.

Integrar Ebanx#

Integrar Ebanx en DEUNA.

1. Busque Ebanx Local en DEUNA

Busque Ebanx en su administrador de DEUNA.

Ejemplo interactivoUsa datos de ejemplo y no realiza solicitudes de API.

Pagos

Conexiones

Descubre y administra integraciones de pago, billeteras y antifraude.

Acme LATAM · Producción

Buscar conexiones

Conexiones	Tipo	Estado
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

2. Configura Ebanx en tu tienda

Después de buscar Ebanx en Connections, debes configurar Ebanx en tu tienda.

En Conexiones se abrirá una ventana como la siguiente:

Ingrese las siguientes credenciales:
- En Nombre introduzca un nombre para hacer referencia a la credencial.
- En Moneda seleccione la moneda del procesador comercial disponible.
- En Clave Privada ingrese la clave privada de Ebanx.
- En Clave Pública ingrese la clave pública de Ebanx.
Clic Conectar.

Una vez que complete los pasos, verá un mensaje de éxito.

3. Procesar pagos con Ebanx

Verá la conexión de Ebanx dentro de la pestaña Conexiones activas.

A partir de este momento ya podrás procesar transacciones con Ebanx a través de DEUNA.

Compra V2

JSON

{
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "order_type": "DEUNA_NOW",
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "expiry_month": "01",
            "expiry_year": "2029",
            "card_holder_dni": "",
            "card_holder": "Omar Guzhnay",
            "card_number": "4111115666052208",
            "card_cvv": "123",
            "address1": "Jose Luis Lagrange 123, Piso 12",
            "address2": "Polanco I Sección",
            "zip": "11510",
            "city": "MIGUEL HIDALGO",
            "state": "CIUDAD DE MÉXICO",
            "country": "MX",
            "phone": "+5930962917328",
            "installments": 1
        }
    },
    "order": {
        "order_id": "12c4f9bb-3128-4fb5-b99a-4e38569c69b5",
        "currency": "CRC",
        "statement_descriptor":"test",
        "market_type": "ecommerce",
        "items": [
            {
                "id": "00ab2d23-f44a-4782-aa7c-bb4fadeddfe3",
                "name": "Item #1",
                "description": "Description Item #1",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            },
            {
                "id": "3cb41aec-1be8-4255-a386-94bb316a8157",
                "name": "Item #2",
                "description": "Description Item #2",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            }
        ],
        "sub_total": 200000,
        "tax_amount": 30000,
        "total_tax_amount": 30000,
        "total_amount": 230000,
        "store_code": "all",
        "billing_address": {
            "id": "4255",
            "first_name": "Omar",
            "last_name": "Guzhnay",
            "email": "omar_guzhnay@gmail.com",
            "address1": "Jose Luis Lagrange 123, Piso 12",
            "address2": "Polanco I Sección",
            "zipcode": "11510",
            "city": "MIGUEL HIDALGO",
            "state_code": "CDMX",
            "state_name": "CIUDAD DE MÉXICO",
            "country_code": "CR",
            "identity_document": "120597333",
            "identity_document_type": "",
            "phone": "+5930962917328",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

Solicitar con opciones de plan de cuotas

JSON

{
    "transaction_id": "b54e3150-5fad-475d-892b-b13dbdbb99d4",
    "amount": 230009,
    "device_id": "f98c0141-dd96-4724-9e9a-c2c637307845",
    "order_token": "c000fbf0-2e86-4f4b-a1bb-223f80bbe477",
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "expiry_month": "01",
            "expiry_year": "2029",
            "card_holder_dni": "",
            "card_holder": "Omar Guzhnay",
            "card_number": "4111115666052208",
            "card_cvv": "123",
            "address1": "Jose Luis Lagrange 123, Piso 12",
            "address2": "Polanco I Sección",
            "zip": "11510",
            "city": "MIGUEL HIDALGO",
            "state": "CIUDAD DE MÉXICO",
            "country": "MX",
            "phone": "+5930962917328",
            "installment": {
                "plan_option_id": "6d8d4c4a-26c7-49a1-b92c-9fd89ea39323"
            }
            
        }
    }
}

Consideraciones y limitaciones especiales#

dirección de facturación

Las transacciones nacionales adquiridas por Ebanx deben incluir la siguiente información del comprador en la solicitud de autorización:

billing_address.zipcode
billing_address.state_name
billing_address.country_code

Esto sigue la regulación local para retener impuestos en la provincia del comprador. Cuando no se proporcionan estos datos, Ebanx retiene impuestos según la ubicación del comerciante.

Código de moneda: especifica el código de moneda (ISO 4217) para el país correspondiente.
Código de país: especifica el Códigos ISO de países
El número de cuotas se valida contra el número máximo de cuotas acordado con el adquirente.
EBANX no soporta captura pacial.
Se puede solicitar un reembolso sólo después de que el pago llegue al CAPTURED status.
Los reembolsos no pueden exceder el monto capturado original, pero se pueden realizar uno o más reembolsos parciales del monto capturado.
Solo se puede enviar un reembolso parcial por pedido.
Un pago puede cancelarse (anularse) sólo después de que alcance el AUTHORIZED status.
La cancelación ya no es posible una vez que el pago llega al CAPTURED status.
Se puede enviar una cancelación completa (anulación) por pedido.
Las cuotas se pueden personalizar para ofrecer una cantidad específica de pagos y pueden incluir opciones sin intereses o cargos definidos por el comerciante. Cómo funciona:
1. El cliente elige las cuotas: a través de la API Get Installment, el cliente podrá obtener las opciones de pago a plazos disponibles. La respuesta incluirá información como las tarifas, el monto total con intereses en caso de que aplique, junto con el valor de la cuota.
2. Procesamiento de pagos a través de DEUNA - Procesamos el pago con las respectivas cuotas directamente con el PSP.