Niubiz

This page provides a guide to integrate Niubiz with DEUNA.

Supported Operations

Niubiz integration in your payment strategy with DEUNA allows you to perform the following operations:

Authorization
Full capture
Partial captures
Purchase (auto-captured)
Partial refund (up to one per order)
Full refund
Void
Installment
3DS DEUNA
Tokenization with PSP

📘
Online multiple partial captures and refunds can be enabled through configuration. Contact DEUNA to activate these features if required

Supported Payment Methods

Cards

Visa
Mastercard
Diners
Amex

Active countries and currencies

Perú (PEN, USD)

Requirements

Contact your Niubiz representative and request the following credentials:

Your Niubiz credentials

📘
Make sure your account is properly configured on the Niubiz side.

Integrate Niubiz

Integrate Niubiz in DEUNA.

1. Look for Niubiz in Connections

Search for Niubiz in your DEUNA profile.

2. Configure Niubiz in your store

In Connections, a window like the following will open:

Enter the following credentials:
- In Name enter a name to reference the credential.
- In Currency select the Currency of Merchant Processor available.
- In RUC enter the Niubiz’s ruc.
- In Username enter the Niubiz’s username.
- In Password enter the Niubiz’s password.
- In Merchant Code enter the Niubiz’s merchant code.
Choose the type of operation you want to perform:
- Purchase
- Authorization
Choose if you want to activate Tokenization with PSP.
Choose if you want to activate 3DS.
Click Connect.

Once you complete the steps, you will see a success message.

3. Process payments with Niubiz

You will see the Niubiz connection within the Active Connections tab.

From this point on, you can now process transactions with Niubiz through DEUNA.

Purchase v2 example

{
    "payer_info": {
        "email": "[email protected]"
    },
    "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": "[email protected]",
            "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"
        }
    }
}

Request with card id (PSP tokenization)

{
    "payer_info": {
        "email": "[email protected]"
    },
    "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": "[email protected]",
            "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": "[email protected]",
            "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"
        }
    }
}

Request with Installment Plan Options Example

{
    "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": "[email protected]"
    },
    "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"
            }
            
        }
    }
}

Special considerations and limitations

Billing adress

Domestic transactions acquired by Niubiz must include the following shopper information in the authorization request:

billing_address.zipcode
billing_address.state-name
billing_address.country_code

This follows the local regulation to withhold tax in the shopper's province. When this data is not supplied, Niubiz withhold tax based on the merchant location.

Submit either one of the codes:

ISO
Local province codes (COMARB)

Province code COMARB	Province code ISO	Province Name
901	AR-C	CABA
909	AR-P	Formosa
919	AR-D	San Luis
908	AR-E	Entre Rios
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	Cordoba
912	AR-F	La 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	Rio Negro
923	AR-V	Tierra del Fuego
902	AR-B	Buenos Aires
921	AR-S	Santa Fe
924	AR-T	Tucumán
905	AR-W	Corrientes

Currency Code: Specifies the currency (ISO 4217) code for the relevant country.
Country Code: Specifies the ISO Country Codes
The number of installments is validated against the maximum number of installments agreed with the acquirer.
A payment that is AUTHORIZED can be captured.
A partial capture can be performed if necessary.
Each authorized payment allows for either a partial or full capture.
It is recommended to capture an order within 5 days of the authorization to prevent expiration.
A refund can be requested only after a payment reaches the CAPTURED status.
Refunds cannot exceed the original captured amount, but one or more partial refunds of the captured amount can be performed.
Multiple partial refund can be sent per order.
Partial refunds, meaning an amount less than the total transaction value, can be applied after settlement (midnight), starting from a T+2 period.
A payment can be canceled (Void) only after it reaches the AUTHORIZED status.
Cancellation is no longer possible once the payment reaches the CAPTURED status.
Full cancel (void) can be sent per order.
The installments can be customized to offer a specific number of payments and can include interest-free options or charges defined by the merchant. How it Works:
1. The customer chooses the installments - Through the Get Installment API the customer will be able to obtain the available installment payment options. The response will include the installment number along with the installment amount excluding interest. This service will not return interest rates, as it is a direct agreement with the acquirer or issuer.
2. Payment processing through DEUNA - We process the payment with the respective installments directly with the PSP.
Transactions utilizing a card_id will be processed without the need to provide the Card Verification Value (CVV), thanks to tokenization with the PSP.
Before taking payments in Latin America a legal entity and an acquirer in the country of operation are required

Testing Resources

Niubiz credentials

RUC *
10119228282

Username *
[email protected]

Password *
_7z3@8fF

MerchantCode *
456879852

Postman collection

NIUBIZ Collection.json

Testing cards

Brand	Type	Card number	Expiry month	Expiry year	CVV
Visa	Approved	4551708161768059	12	2030	123
Visa	Rejected	4024007126919058	12	2030	111
Master	Approved	5160030000000317	03	2028	111
Diners	Approved	36006616055724	04	2026	111
Amex	Approved	371064649323968	03	2028	111