Niubiz | DEUNA Docs

Sur cette page

Intégrer Niubiz
Considérations particulières et limites
Ressources de test

Cette page fournit un guide pour intégrer Niubiz à DEUNA.

Opérations prises en charge

L'intégration de Niubiz dans votre stratégie de paiement avec DEUNA vous permet d'effectuer les opérations suivantes :

Autorisation
Capture complète
Captures partielles
Achat (capturé automatiquement)
Remboursement partiel (jusqu'à un par commande)
Remboursement intégral
Vide
Acompte
3DS DEUNA
Tokenisation avec PSP

Méthodes de paiement prises en charge

Cartes

Visa
Carte Master
Dîners
Amex

Pays et devises actifs

Perú (PEN, USD)

Exigences

Contactez votre représentant Niubiz et demandez les justificatifs d'identité suivants :

Code marchand Niubiz
Nom d'utilisateur
Mot de passe
RUC

Vous pouvez utiliser les références suivantes pour les tests :

Code de la marchandise: 456879852
Nom d'utilisateur : integraciones@niubiz.com.pe
Mot de passe : 7z3@8fF
Royaume-Uni: 1019228282

Intégrer Niubiz#

Intégrer Niubiz dans DEUNA.

1. Recherchez Niubiz dans les connexions

Rechercher Niubiz dans l'administration DEUNA.

Connectez-vous à votre session d'administration DEUNA.
Cliquez Connexions.
Sur le résultat Nibuiz, cliquez Se connecter.

Exemple interactifUtilise des données fictives et n’effectue aucune requête API.

Paiements

Connexions

Découvrez et gérez les intégrations de paiement, de portefeuille et antifraude.

Acme LATAM · Production

Rechercher des connexions

Connexions	Type	Statut
Adyen	Passerelle de paiement	Connectée
Worldpay	Passerelle de paiement	Connectée
PayPal	Moyen de paiement	Connectée
Mercado Pago	Moyen de paiement	Non connectée
Riskified	Moteur antifraude	Non connectée

2. Configurez Niubiz dans votre magasin

Dans Connexions, une fenêtre comme celle-ci s'ouvrira :

Saisissez les informations d'identification suivantes :
- Dans Nom entrez un nom pour référencer les informations d'identification.
- Dans Devise sélectionnez la devise du processeur marchand disponible.
- Dans Code du commerce Entrez le code marchand Niubiz.
- Dans Nom d'utilisateur Entrez le nom d'utilisateur de Niubiz.
- Dans Mot de passe Entrez le mot de passe Niubiz.
- Dans RUC Entrez dans la zone de Niubiz RUC.
Choisissez le type d'opération que vous souhaitez effectuer :
- Achat
- Autorisation
Choisissez si vous voulez activer Tokenization avec PSP.
Choisissez si vous souhaitez activer la 3DS.
Cliquez Se connecter.

Une fois les étapes terminées, vous verrez un message de réussite.

3. Traiter les paiements avec Niubiz

Vous verrez la connexion Niubiz dans l'onglet Connexions actives.

À partir de ce moment, vous pouvez maintenant traiter les transactions avec Niubiz via DEUNA.

Exemple d'achat 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"
        }
    }
}

Demande avec carte id (tokenisation 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"
        }
    }
}

Exemple de demande avec options de plan de versement

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

Considérations particulières et limites#

Adresse de facturation

Les transactions intérieures acquises par Niubiz doivent inclure les renseignements suivants sur les acheteurs dans la demande d'autorisation :

billing_address.zipcode
billing_address.state_name
billing_address.country_code

Cette mesure fait suite à la réglementation locale de retenir la taxe dans la province du client. Lorsque ces données ne sont pas fournies, Niubiz retient la taxe en fonction de l'emplacement du commerçant.

Soumettre l'un ou l'autre des codes:

ISO
Codes provinciaux locaux (COMARB)

Code de la province COMARB	Code de la province ISO	Nom de la province
901	AR-C	CABA
909	AR-P	Formose
919	AR-D	San Luis
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	Sainte-Cruz
903	AR-K	Catamarca
904	AR-X	Cordoue
912	AR-F	La Rioja
922	AR-G	Santiago de l'Estero
918	AR-J	Saint-Jean
913	AR-M	Mendoza
914	AR-N	Missions
915	AR-Q	Neuquén
916	AR-R	Río Negro
923	AR-V	Terre de Feu
902	AR-B	Buenos Aires
921	AR-S	Santa Fé
924	AR-T	Tucumán
905	AR-W	Corrientes

Code de devise : Spécifie le code de devise (ISO 4217) du pays concerné.
Code pays : spécifie le Codes pays ISO
Le nombre de versements est validé par rapport au nombre maximum de versements convenu avec l'acquéreur.
Un paiement qui est AUTHORIZED peut être capturé.
Une capture partielle peut être effectuée si nécessaire.
Chaque paiement autorisé permet une capture partielle ou totale.
Il est recommandé de capturer une commande dans les 5 jours suivant l'autorisation pour éviter son expiration.
Un remboursement ne peut être demandé qu'après qu'un paiement ait atteint le CAPTURED status.
Les remboursements ne peuvent pas dépasser le montant initial capturé, mais un ou plusieurs remboursements partiels du montant capturé peuvent être effectués.
Plusieurs remboursements partiels peuvent être envoyés par commande.
Les remboursements partiels, c'est-à-dire un montant inférieur à la valeur transactionnelle totale, peuvent être appliqués après règlement (mi-nuit), à partir d'une période T+1.
Les remboursements à partir d'une période T+1 pour les cartes American Express, Diners et Discover ne sont pas autorisés. Toutefois, les remboursements du même jour seront autorisés.
Un paiement ne peut être annulé (annulé) qu'après avoir atteint le AUTHORIZED status.
L'annulation n'est plus possible une fois le paiement atteint le CAPTURED status.
Une annulation complète (annulée) peut être envoyée par commande.
Les versements peuvent être personnalisés pour offrir un nombre spécifique de paiements et peuvent inclure des options sans intérêt ou des frais définis par le commerçant. Comment ça marche :
1. Le client choisit les versements - Grâce à l'API Get Installment, le client pourra obtenir les options de paiement échelonnées disponibles. La réponse comprendra le numéro du versement ainsi que le montant du versement hors intérêts. Ce service ne renverra pas de taux d'intérêt, car il s'agit d'un accord direct avec l'acquéreur ou l'émetteur.
2. Traitement des paiements via DEUNA - Nous traitons le paiement avec les versements respectifs directement avec le PSP.
Opérations utilisant une card_id sera traité sans avoir besoin de fournir la valeur de vérification de carte (CVV), grâce à la tokenisation avec le PSP.
Avant de procéder à des paiements en Amérique latine, une personne morale et un acquéreur dans le pays d'opération sont requis.

Ressources de test#

Titres de créance Niubiz

ABAP

RUC *
10119228282

Username *
integraciones@niubiz.com.pe

Password *
_7z3@8fF

MerchantCode *
456879852

Collection Postman

Demandez la collection actuelle de Niubiz Postman à votre équipe d'intégration DEUNA avant de tester les API.

Cartes de test

Marque	Tapez	Numéro de carte	Mois d'expiration	Année d'expiration	CVV
Visa	Approuvé	4551708161768059	12	2030	123
Visa	Rejeté	4024007126919058	12	2030	111
Maître	Approuvé	5160030000000317	03	2028	111
Dîners	Approuvé	36006616055724	04	2026	111
Amex	Approuvé	371064649323968	03	2028	111
Visa	Approuvé (pour la tokenisation)	4005520000000129	01	2029	123