Ebanx | DEUNA Docs

Sur cette page

Intégrer Ebanx
Considérations particulières et limites
Ressources d ' essai

Cette page fournit un guide pour intégrer Ebanx à 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
Captures partielles
Achat (capturé automatiquement)
Remboursement partiel (jusqu'à un par commande)
Remboursement intégral
Vide
Acompte
3DS DEUNA

Méthodes de paiement prises en charge

Cartes

Visa
Carte Master

Pays et devises actifs

Costa Rica (CRC, USD)
Argentine (ARS)
Brésil (BRL, USD)
Chili (CLP)
Colombie (COP)
Équateur (USD)
México (MXN)
Perú (PEN, USD)
Paraguay (PYG)
Uruguay (UYI, USD)
Sudáfrica (ZAR)

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. Cherchez Ebanx 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.
Choisissez le type d'opération que vous souhaitez effectuer :
- Achat
- Autorisation
Choisissez si vous souhaitez activer la 3DS.
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.

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.
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.
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 d ' essai#

Pouvoirs Ebanx

ABAP

Private Key
test_ik_L9l0hOg-Qg7xScUGw-QLAA

Public Key
test_pk_AAK0Nzo8Vcp6yuRwYuDu7A

Collection Postman

Demandez à l'équipe d'intégration DEUNA l'environnement et la collection actuels de Postman EBANX.

Cartes de test

Marque	Tapez	Numéro de carte	Mois d'expiration	Année d'expiration	CVV
Visa	Approuvé	4111115666052208	12	2026	123
Maître	Approuvé	5555556355564617	12	2026	123
Visa	Rejeté	4918019199883839	12	2026	123