Ebanx | DEUNA Docs

In questa pagina

Integrare Ebanx
Considerazioni e limitazioni speciali
Testare le risorse

Questa pagina fornisce una guida per integrare Ebanx con DEUNA.

Operazioni supportate

L'integrazione Ebanx nella 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

Metodi di pagamento supportati

Carte

Visto
Mastercard

Paesi attivi e valute

Costa Rica (CRC, USD)
Argentina (ARS)
Brasil (BRL, USD)
Cile (CLP)
Colombia (COP)
Ecuador (USD)
(MXN)
Perú (PEN, USD)
Paraguay (PYG)
Uruguay (UYI, USD)
Sudáfrica (ZAR)

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 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.
Scegli il tipo di operazione che vuoi eseguire:
- Acquisto
- Autorizzazione
Scegliere se si desidera attivare 3DS.
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.

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.
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.
Prima di prendere i pagamenti in America Latina è necessaria una entità giuridica e un acquirente nel paese di funzionamento

Testare le risorse#

credenziali Ebanx

ABAP

Private Key
test_ik_L9l0hOg-Qg7xScUGw-QLAA

Public Key
test_pk_AAK0Nzo8Vcp6yuRwYuDu7A

Raccolta Postman

Richiedi l'attuale ambiente e la raccolta EBANX Postman dal tuo team di integrazione DEUNA.

Testare le carte

Marca	Tipo	Numero della carta	Mese di scadenza	Anno di scadenza	CVV
Visto	Approvazione	4111115666052208	12	2026	123
Maestro	Approvazione	5555556355564617	12	2026	123
Visto	Rifiutata	4918019199883839	12	2026	123