Ebanx locale | DEUNA Docs

In questa pagina

Integrare Ebanx
Considerazioni e limitazioni speciali

Questa pagina fornisce una guida per integrare Ebanx Local con DEUNA.

Operazioni supportate

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

Autorizzazione
Capture complete
Void
Acquisto (auto-captured)
Rimborso parziale (fino a uno per ordine)
rimborso completo
Installazione

Paesi attivi e valute

Brasile, Cile, Colombia e Messico.

Requisiti

Contatta il tuo rappresentante Ebanx e richiedi le seguenti credenziali:

Le credenziali Ebanx

Assicurarsi che il tuo account sia configurato correttamente sul lato Ebanx.

Integrare Ebanx#

Integrare Ebanx in DEUNA.

1. Cercare Ebanx locale in DEUNA

Cerca Ebanx nel tuo amministratore DEUNA.

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 Ebanx nel tuo negozio

Dopo aver cercato Ebanx in Connections, è necessario configurare Ebanx 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 Chiave privata entrare nella chiave privata di Ebanx.
- In Chiave pubblica entrare nella chiave pubblica di Ebanx.
Cliccare su Collegamento.

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

3. Elaborare pagamenti con Ebanx

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

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

V2 acquisto

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

Richiesta con opzioni di piano di installazione

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

Considerazioni e limitazioni speciali#

Indirizzo di fatturazione

Le operazioni interne acquistate da Ebanx 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, Ebanx tiene le imposte in base alla posizione del commerciante.

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.
EBANX non supporta la cattura patial.
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.
Solo un rimborso parziale può essere inviato per ordine.
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à informazioni come le tasse, l'importo totale con interesse nel caso in cui si applichi, insieme al valore di ratement.
2. Elaborazione dei pagamenti tramite DEUNA - Elaboriamo il pagamento con le rispettive rate direttamente con il PSP.