Niubiz | DEUNA Docs

En esta página

Integrar Niubiz
Consideraciones y limitaciones especiales
Recursos de prueba

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

Operaciones soportadas

La integración de Niubiz 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
Tokenización con PSP

Métodos de pago admitidos

Tarjetas

visa
Mastercard
Comensales
Amex

Países y monedas activos

Perú (PEN, USD)

Requisitos

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

código de comerciante niubiz
Nombre de usuario
Contraseña
RUC

Puede utilizar las siguientes credenciales para realizar pruebas:

Código de comerciante: 456879852
Nombre de usuario: integraciones@niubiz.com.pe
Contraseña: _7z3@8fF
RUC: 10119228282

Integrar Niubiz#

Integrar Niubiz en DEUNA.

1. Busque Niubiz en Conexiones

Busque Niubiz en el administrador de DEUNA.

Inicie sesión en su sesión de administrador de DEUNA.
Clic Conexiones.
En el resultado de Nibuiz, haga clic Conectar.

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 Niubiz 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 Código de comerciante ingrese el código de comerciante de Niubiz.
- En Nombre de usuario ingrese el nombre de usuario de Niubiz.
- En Contraseña ingrese la contraseña de Niubiz.
- En RUC ingresar al RUC de Niubiz.
Elija el tipo de operación que desea realizar:
- Compra
- Autorización
Elige si quieres activar la Tokenización con PSP.
Elige si quieres activar 3DS.
Clic Conectar.

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

3. Procesar pagos con Niubiz

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

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

Ejemplo de 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": "4551708161768059",
            "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": "4d7b64fe-8f2f-4f85-b982-29ba54305a73",
        "currency": "PEN",
        "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": "PEN",
                    "currency_symbol": "s/."
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "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": "PEN",
                    "currency_symbol": "s/."
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            }
        ],
        "sub_total": 200000,
        "tax_amount": 30009,
        "total_tax_amount": 30009,
        "total_amount": 230009,
        "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": "{{state_code}}",
            "state_name": "CIUDAD DE MÉXICO",
            "country_code": "MX",
            "identity_document": "1205973330",
            "identity_document_type": "",
            "phone": "+5930962917328",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

Solicitud con ID de tarjeta (tokenización de PSP)

JSON

{
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "order_type": "DEUNA_CHECKOUT",
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "card_id": "55545067-6a87-416c-f44a-4782-aa7c",
            "card_cvv": "123"
        }
    },
    "order": {
        "order_id": "52385067-6a87-416c-80fa-6394d03b0945",
        "currency": "PEN",
        "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": "PEN",
                    "currency_symbol": "s/."
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "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": "PEN",
                    "currency_symbol": "s/."
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            }
        ],
        "sub_total": 200000,
        "tax_amount": 30009,
        "total_tax_amount": 30009,
        "total_amount": 230009,
        "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": "{{state_code}}",
            "state_name": "CIUDAD DE MÉXICO",
            "country_code": "MX",
            "identity_document": "1205973330",
            "identity_document_type": "",
            "phone": "+5930962917328",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        },
        "shipping_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": "{{state_code}}",
            "state_name": "{{state_code}}",
            "country_code": "MX",
            "identity_document": "1205973330",
            "identity_document_type": "",
            "phone": "+5930962917328",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

Ejemplo de solicitud con opciones de plan de pago a plazos

JSON

{
    "transaction_id": "32e61625-6586-4392-8d03-1745901bd9e6",
    "amount": 230009,
    "device_id": "2128b31d-c7c1-46d1-83fa-3fc545dbbeb4",
    "order_token": "4a64f32b-5086-4199-9e0e-c9ec1f54e93a",
    "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": "4772133007520635",
            "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": "ff1c4600-f3ef-4a9e-918a-95468ac1216a"
            }
            
        }
    }
}

Consideraciones y limitaciones especiales#

dirección de facturación

Las transacciones nacionales adquiridas por Niubiz 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, Niubiz 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.
Se pueden enviar múltiples reembolsos parciales por pedido.
Los reembolsos parciales, es decir, una cantidad inferior al valor total de la transacción, se pueden aplicar después de la liquidación (medianoche), a partir de un período T+1.
No se permiten reembolsos a partir de un periodo T+1 para tarjetas American Express, Diners y Discover. Sin embargo, se permitirán reembolsos el mismo día.
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á el número de la cuota junto con el monto de la cuota sin incluir los intereses. Este servicio no devolverá tasas de interés, ya que es un acuerdo directo con el adquirente o emisor.
2. Procesamiento de pagos a través de DEUNA - Procesamos el pago con las respectivas cuotas directamente con el PSP.
Transacciones utilizando un card_id se procesará sin necesidad de proporcionar el Valor de Verificación de Tarjeta (CVV), gracias a la tokenización con la 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 de Niubiz

ABAP

RUC *
10119228282

Username *
integraciones@niubiz.com.pe

Password *
_7z3@8fF

MerchantCode *
456879852

Colección de Postman

Solicite la colección actual de Niubiz Postman a su equipo de integración de DEUNA antes de probar las API.

Tarjetas de prueba

Marca	Tipo	Número de tarjeta	Mes de vencimiento	Año de caducidad	CVV
visa	Aprobado	4551708161768059	12	2030	123
visa	Rechazado	4024007126919058	12	2030	111
maestro	Aprobado	5160030000000317	03	2028	111
Comensales	Aprobado	36006616055724	04	2026	111
Amex	Aprobado	371064649323968	03	2028	111
visa	Aprobado (para tokenización)	4005520000000129	01	2029	123