Niúbiz | DEUNA Docs

Nesta página

Integrar Niubiz
Considerações e limitações especiais
Recursos de teste

Esta página fornece um guia para integrar Niubiz com DEUNA.

Operações Suportadas

A integração do Niubiz na sua estratégia de pagamento com DEUNA permite realizar as seguintes operações:

Autorização
Captura completa
Capturas parciais
Compra (capturada automaticamente)
Reembolso parcial (até um por pedido)
Reembolso total
Vazio
Parcela
3DS DEUNA
Tokenização com PSP

Métodos de pagamento suportados

Cartões

Visto
Mastercard
Jantares
Amex

Países e moedas ativos

Peru (PEN, USD)

Requisitos

Entre em contato com seu representante Niubiz e solicite as seguintes credenciais Niubiz:

Código de comerciante Niubiz
Nome de usuário
Senha
RUC

Você pode usar as seguintes credenciais para teste:

Código do comerciante: 456879852
Nome de usuário: integraciones@niubiz.com.pe
Senha: _7z3@8fF
RUC: 10119228282

Integrar Niubiz#

Integrar Niubiz em DEUNA.

1. Procure Niubiz em Conexões

Pesquise Niubiz no DEUNA Admin.

Faça login na sua sessão de administração DEUNA.
Clique Conexões.
No resultado do Nibuiz, clique em Conectar.

Exemplo interativoUsa dados de exemplo e não faz solicitações à API.

Pagamentos

Conexões

Descubra e gerencie integrações de pagamento, carteiras e antifraude.

Acme LATAM · Produção

Pesquisar conexões

Conexões	Tipo	Status
Adyen	Gateway de pagamento	Conectada
Worldpay	Gateway de pagamento	Conectada
PayPal	Forma de pagamento	Conectada
Mercado Pago	Forma de pagamento	Não conectada
Riskified	Mecanismo antifraude	Não conectada

2. Configure o Niubiz na sua loja

No Connections, uma janela como a seguinte será aberta:

Insira as seguintes credenciais:
- Em Nome insira um nome para fazer referência à credencial.
- Em Moeda selecione a moeda do processador do comerciante disponível.
- Em Código do comerciante insira o código de comerciante do Niubiz.
- Em Nome de usuário digite o nome de usuário do Niubiz.
- Em Senha digite a senha do Niubiz.
- Em RUC entre no Niubiz RUC.
Escolha o tipo de operação que deseja realizar:
- Comprar
- Autorização
Escolha se deseja ativar a tokenização com PSP.
Escolha se deseja ativar o 3DS.
Clique Conectar.

Depois de concluir as etapas, você verá uma mensagem de sucesso.

3. Processe pagamentos com Niubiz

Você verá a conexão Niubiz na guia Conexões ativas.

A partir deste ponto, agora você pode processar transações com Niubiz através da DEUNA.

Exemplo 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"
        }
    }
}

Solicitação com identificação do cartão (tokenização 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"
        }
    }
}

Exemplo de solicitação com opções de parcelamento

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"
            }
            
        }
    }
}

Considerações e limitações especiais#

Endereço de cobrança

As transações nacionais adquiridas pela Niubiz devem incluir as seguintes informações do comprador na solicitação de autorização:

billing_address.zipcode
billing_address.state_name
billing_address.country_code

Isto segue a regulamentação local para retenção de impostos na província do comprador. Quando esses dados não são fornecidos, a Niubiz retém o imposto com base na localização do comerciante.

Envie um dos códigos:

ISO
Códigos de província locais (COMARB)

Código da província COMARB	Código da província ISO	Nome da província
901	AR-C	CABA
909	AR-P	Formosa
919	AR-D	São Luís
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	Córdoba
912	AR-F	La Rioja
922	AR-G	Santiago del Estero
918	AR-J	São João
913	AR-M	Mendoza
914	AR-N	Missões
915	AR-Q	Neuquén
916	AR-R	Rio Negro
923	AR-V	Terra do Fogo
902	AR-B	Buenos Aires
921	AR-S	Santa Fé
924	AR-T	Tucumán
905	AR-W	Corrientes

Código da moeda: especifica o código da moeda (ISO 4217) do país relevante.
Código do país: especifica o Códigos de país ISO
O número de parcelas é validado em relação ao número máximo de parcelas acordado com o adquirente.
Um pagamento que é AUTHORIZED pode ser capturado.
Uma captura parcial pode ser realizada, se necessário.
Cada pagamento autorizado permite uma captura parcial ou total.
Recomenda-se capturar um pedido no prazo de 5 dias após a autorização para evitar a expiração.
Um reembolso só pode ser solicitado após o pagamento chegar ao CAPTURED status.
Os reembolsos não podem exceder o valor original capturado, mas podem ser realizados um ou mais reembolsos parciais do valor capturado.
Vários reembolsos parciais podem ser enviados por pedido.
As restituições parciais, ou seja, um valor inferior ao valor total da transação, poderão ser aplicadas após a liquidação (meia-noite), a partir de um período D+1.
Não são permitidos reembolsos a partir de um período T+1 para cartões American Express, Diners e Discover. No entanto, serão permitidos reembolsos no mesmo dia.
Um pagamento só pode ser cancelado (Anulado) depois de atingir o AUTHORIZED status.
O cancelamento não é mais possível quando o pagamento chega ao CAPTURED status.
O cancelamento total (anulado) pode ser enviado por pedido.
As parcelas podem ser customizadas para oferecer um número específico de pagamentos e podem incluir opções sem juros ou cobranças definidas pelo lojista. Como funciona:
1. O cliente escolhe o parcelamento - Através da API Get Parcelamento o cliente poderá obter as opções de parcelamento disponíveis. A resposta incluirá o número da parcela junto com o valor da parcela, excluindo juros. Este serviço não retornará taxas de juros, pois é um acordo direto com o adquirente ou emissor.
2. Processamento de pagamentos através da DEUNA - Processamos o pagamento com as respetivas prestações diretamente com a PSP.
Transações utilizando um card_id serão processados sem a necessidade de fornecer o Valor de Verificação do Cartão (CVV), graças à tokenização com o PSP.
Antes de aceitar pagamentos na América Latina, é necessária uma entidade legal e um adquirente no país de operação

Recursos de teste#

Credenciais Niubiz

ABAP

RUC *
10119228282

Username *
integraciones@niubiz.com.pe

Password *
_7z3@8fF

MerchantCode *
456879852

Coleção do Postman

Solicite a coleção atual do Niubiz Postman à sua equipe de integração DEUNA antes de testar as APIs.

Cartões de teste

Marca	Tipo	Número do cartão	Mês de vencimento	Ano de validade	CVV
Visto	Aprovado	4551708161768059	12	2030	123
Visto	Rejeitado	4024007126919058	12	2030	111
Mestre	Aprovado	5160030000000317	03	2028	111
Jantares	Aprovado	36006616055724	04	2026	111
Amex	Aprovado	371064649323968	03	2028	111
Visto	Aprovado (para tokenização)	4005520000000129	01	2029	123