Ebanx | DEUNA Docs

En esta página

Integrar Ebanx
Consideraciones y limitaciones especiales
Recursos de prueba

Esta página proporciona una guía para integrar Ebanx 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
Capturas parciales
Compra (captura automática)
Reembolso parcial (hasta uno por pedido)
Reembolso completo
Anulación
Cuota
3DS DEUNA

Métodos de pago admitidos

Tarjetas

visa
Mastercard

Países y monedas activos

Costa Rica (CRC, USD)
Argentina (ARS)
Brasil (BRL, USD)
Chile (CLP)
Colombia (COP)
Ecuador (USD)
México (MXN)
Perú (PEN, USD)
Paraguay (PYG)
Uruguay (UYI, USD)
Sudáfrica (ZAR)

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. Busca Ebanx 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.
Elija el tipo de operación que desea realizar:
- Compra
- Autorización
Elige si quieres activar 3DS.
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.

Envíe cualquiera de los códigos:

ISO
Códigos de provincia locales (COMARB)

Código de provincia COMARB	Código de provincia ISO	Nombre de la provincia
901	AR-C	CABA
909	AR-P	Formosa
919	AR-D	sanluis
908	AR-E	Entre Ríos
911	AR-L	La Pampa
917	AR-A	Salta
906	AR-H	Chaco
907	AR-U	Chubut
910	AR-Y	Jujuy
920	AR-Z	santa cruz
903	AR-K	Catamarca
904	AR-X	Córdoba
912	AR-F	Rioja
922	AR-G	santiago del estero
918	AR-J	san juan
913	AR-M	Mendoza
914	AR-N	Misiones
915	AR-Q	Neuquén
916	AR-R	Río Negro
923	AR-V	Tierra del Fuego
902	AR-B	buenos aires
921	AR-S	Santa Fé
924	AR-T	Tucumán
905	AR-W	Corrientes

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.
Un pago que es AUTHORIZED puede ser capturado.
Se puede realizar una captura parcial si es necesario.
Cada pago autorizado permite una captura parcial o total.
Se recomienda capturar un pedido dentro de los 5 días posteriores a la autorización para evitar su vencimiento.
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.
Antes de realizar pagos en América Latina se requiere una entidad legal y un adquirente en el país de operación.

Recursos de prueba#

Credenciales Ebanx

ABAP

Private Key
test_ik_L9l0hOg-Qg7xScUGw-QLAA

Public Key
test_pk_AAK0Nzo8Vcp6yuRwYuDu7A

Colección de Postman

Solicita el entorno y cobro actual de EBANX Postman a tu equipo de integración de DEUNA.

Tarjetas de prueba

Marca	Tipo	Número de tarjeta	Mes de vencimiento	Año de vencimiento	CVV
visa	Aprobado	4111115666052208	12	2026	123
maestro	Aprobado	5555556355564617	12	2026	123
visa	Rechazado	4918019199883839	12	2026	123