Ebanx Local | DEUNA Docs

Sur cette page

Intégrer Ebanx
Considérations particulières et limites

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

Opérations prises en charge

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

Autorisation
Capture complète
Vide
Achat (capturé automatiquement)
Remboursement partiel (jusqu'à un par commande)
Remboursement intégral
Acompte

Pays et devises actifs

Brésil, Chili, Colombie et Mexique.

Exigences

Contactez votre représentant Ebanx et demandez les informations d'identification suivantes :

Vos identifiants Ebanx

Assurez-vous que votre compte est correctement configuré côté Ebanx.

Intégrer Ebanx#

Intégrez Ebanx dans DEUNA.

1. Recherchez Ebanx Local dans DEUNA

Recherchez Ebanx dans votre administration DEUNA.

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 Ebanx dans votre boutique

Après avoir recherché Ebanx dans Connections, vous devez configurer Ebanx dans votre boutique.

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 Clé privée entrez la clé privée d’Ebanx.
- Dans Clé publique entrez la clé publique d’Ebanx.
Cliquez Se connecter.

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

3. Traitez les paiements avec Ebanx

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

À partir de ce moment, vous pouvez désormais traiter les transactions avec Ebanx via DEUNA.

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": "4111115666052208",
            "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": "12c4f9bb-3128-4fb5-b99a-4e38569c69b5",
        "currency": "CRC",
        "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": "CRC",
                    "currency_symbol": "₡"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "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": "CRC",
                    "currency_symbol": "₡"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            }
        ],
        "sub_total": 200000,
        "tax_amount": 30000,
        "total_tax_amount": 30000,
        "total_amount": 230000,
        "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": "CDMX",
            "state_name": "CIUDAD DE MÉXICO",
            "country_code": "CR",
            "identity_document": "120597333",
            "identity_document_type": "",
            "phone": "+5930962917328",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

Demande avec options de plan de versement

JSON

{
    "transaction_id": "b54e3150-5fad-475d-892b-b13dbdbb99d4",
    "amount": 230009,
    "device_id": "f98c0141-dd96-4724-9e9a-c2c637307845",
    "order_token": "c000fbf0-2e86-4f4b-a1bb-223f80bbe477",
    "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": "4111115666052208",
            "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": "6d8d4c4a-26c7-49a1-b92c-9fd89ea39323"
            }
            
        }
    }
}

Considérations particulières et limites#

Adresse de facturation

Les transactions nationales acquises par Ebanx doivent inclure les informations suivantes sur l'acheteur dans la demande d'autorisation :

billing_address.zipcode
billing_address.state_name
billing_address.country_code

Cela fait suite à la réglementation locale visant à retenir la taxe dans la province de l'acheteur. Lorsque ces données ne sont pas fournies, Ebanx retient les taxes en fonction de la localisation du commerçant.

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.
EBANX ne supporte pas la capture patiale.
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.
Un seul remboursement partiel peut être effectué par commande.
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 des informations telles que les frais, le montant total avec intérêts le cas échéant, ainsi que la valeur du versement.
2. Traitement des paiements via DEUNA - Nous traitons le paiement avec les versements respectifs directement avec le PSP.