Niubiz | DEUNA Docs

In questa pagina

Integrare Niubiz
Considerazioni e limitazioni speciali
Testare le risorse

Questa pagina fornisce una guida per integrare Niubiz con DEUNA.

Operazioni supportate

L'integrazione di Niubiz nella vostra strategia di pagamento con DEUNA consente di eseguire le seguenti operazioni:

Autorizzazione
Cattura completa
Acquisizioni parziali
Acquisto (auto-captured)
Rimborso parziale (fino a uno per ordine)
rimborso completo
Void
Installazione
3DS DEUNA
Tokenizzazione con PSP

Metodi di pagamento supportati

Carte

Visto
Mastercard
Diners
Amex

Paesi attivi e valute

Perú (PEN, USD)

Requisiti

Contatta il rappresentante Niubiz e richiedi le seguenti credenziali Niubiz:

Codice di commerciante di Niubiz
Nome utente
Password
RUC

È possibile utilizzare le seguenti credenziali per il test:

MerchantCode: 456879852
Nome utente: integraciones@niubiz.com.pe
Password: 7z3@8fF
RUC: 10119228282

Integrare Niubiz#

Integra Niubiz in DEUNA.

1. Cercare Niubiz in connessioni

Cerca Niubiz nell'Admin DEUNA.

Accedi alla tua sessione di amministrazione DEUNA.
Cliccare su Collegamenti.
Sul risultato di Nibuiz, cliccare Collegamento.

Esempio interattivoUsa dati di esempio e non effettua richieste API.

Pagamenti

Connessioni

Scopri e gestisci le integrazioni di pagamento, wallet e antifrode.

Acme LATAM · Produzione

Cerca connessioni

Connessioni	Tipo	Stato
Adyen	Gateway di pagamento	Connessa
Worldpay	Gateway di pagamento	Connessa
PayPal	Metodo di pagamento	Connessa
Mercado Pago	Metodo di pagamento	Non connessa
Riskified	Motore antifrode	Non connessa

2. Configurare Niubiz nel tuo negozio

In Connessioni, una finestra come la seguente si aprirà:

Inserisci le seguenti credenziali:
- In Nome inserire un nome per fare riferimento alle credenziali.
- In Valuta selezionare la valuta del processore di Merchant disponibile.
- In Codice Merchant inserire il codice mercantile di Niubiz.
- In Nome utente inserire il nome utente del Niubiz.
- In Password inserire la password di Niubiz.
- In RUC entrare nel Niubiz RUC.
Scegli il tipo di operazione che vuoi eseguire:
- Acquisto
- Autorizzazione
Scegliere se si desidera attivare Tokenization con PSP.
Scegliere se si desidera attivare 3DS.
Cliccare su Collegamento.

Una volta completate i passaggi, vedrete un messaggio di successo.

3. Elaborare pagamenti con Niubiz

Vedrete la connessione Niubiz all'interno della scheda Connessioni attive.

Da questo punto in poi, è ora possibile elaborare le transazioni con Niubiz attraverso DEUNA.

Acquisto v2 esempio

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

Richiesta con carta id (consegna 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"
        }
    }
}

Richiesta con Opzioni Piano di Installazione Esempio

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

Considerazioni e limitazioni speciali#

Indirizzo di fatturazione

Le operazioni interne acquistate da Niubiz devono includere le seguenti informazioni sull'acquirente nella richiesta di autorizzazione:

billing_address.zipcode
billing_address.state_name
billing_address.country_code

Ciò segue la normativa locale per trattenere l'imposta nella provincia del commerciante. Quando questi dati non vengono forniti, Niubiz nega l'imposta sulla base della posizione del commerciante.

Inserisci uno dei codici:

ISO
Codici provinciali locali (COMARB)

Codice provinciale COMARB	Codice provinciale ISO	Nome della Provincia
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	Cordova
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	No.
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

Codice valuta: Specifica il codice valuta (ISO 4217) per il paese in questione.
Codice paese: Specifica il Codici di Paese ISO
Il numero di rate viene convalidato rispetto al numero massimo di rate concordate con l'acquirente.
Un pagamento che è AUTHORIZED può essere catturato.
Una cattura parziale può essere eseguita se necessario.
Ogni pagamento autorizzato consente una cattura parziale o completa.
Si raccomanda di catturare un ordine entro 5 giorni dall'autorizzazione per evitare la scadenza.
Un rimborso può essere richiesto solo dopo un pagamento raggiunge il CAPTURED status.
I rimborsi non possono superare l'importo acquisito originale, ma si possono effettuare uno o più rimborsi parziali dell'importo catturato.
Il rimborso parziale può essere inviato per ordine.
I rimborsi parziali, che significa un importo inferiore al valore totale delle transazioni, possono essere applicati dopo l'insediamento (mezzonotte), a partire da un periodo T+1.
I rimborsi a partire da un periodo T+1 per American Express, Diners e Discover non sono consentiti. Tuttavia, i rimborsi dello stesso giorno saranno consentiti.
Un pagamento può essere annullato (Void) solo dopo che raggiunge il AUTHORIZED status.
La cancellazione non è più possibile una volta che il pagamento raggiunge il CAPTURED status.
Cancellazione completa (void) può essere inviata per ordine.
Le rate possono essere personalizzate per offrire un numero specifico di pagamenti e possono includere opzioni senza interessi o oneri definiti dal commerciante. Come funziona:
1. Il cliente sceglie le rate - Attraverso l'API di installazione di Get il cliente sarà in grado di ottenere le opzioni di pagamento di installazione disponibili. La risposta includerà il numero di installazione insieme all'importo di installazione, escluso l'interesse. Questo servizio non restituirà i tassi di interesse, in quanto è un accordo diretto con l'acquirente o l'emittente.
2. Elaborazione dei pagamenti tramite DEUNA - Elaboriamo il pagamento con le rispettive rate direttamente con il PSP.
Transazioni che utilizzano un card_id sarà elaborato senza la necessità di fornire il valore di verifica della carta (CVV), grazie alla tokenizzazione con il PSP.
Prima di prendere i pagamenti in America Latina è necessaria una entità giuridica e un acquirente nel paese di funzionamento

Testare le risorse#

credenziali Niubiz

ABAP

RUC *
10119228282

Username *
integraciones@niubiz.com.pe

Password *
_7z3@8fF

MerchantCode *
456879852

Raccolta Postman

Richiedi l'attuale collezione di messaggi Niubiz dal tuo team di integrazione DEUNA prima di testare le API.

Testare le carte

Marca	Tipo	Numero di carta	Mese di scadenza	Anno di scadenza	CVV
Visto	Approvazione	4551708161768059	12	2030	123
Visto	Rifiutata	4024007126919058	12	2030	111
Maestro	Approvazione	5160030000000317	03	2028	111
Diners	Approvazione	36006616055724	04	2026	111
Amex	Approvazione	371064649323968	03	2028	111
Visto	Approvata (per tokenizzazione)	4005520000000129	01	2029	123