Ebanx Local | DEUNA Docs

Nesta página

Integre o Ebanx
Considerações e limitações especiais

Esta página fornece um guia para integrar o Ebanx Local com DEUNA.

Operações Suportadas

A integração do Ebanx na sua estratégia de pagamentos com DEUNA permite realizar as seguintes operações:

Autorização
Captura completa
Vazio
Compra (capturada automaticamente)
Reembolso parcial (até um por pedido)
Reembolso total
Parcela

Países e moedas ativos

Brasil, Chile, Colômbia e México.

Requisitos

Entre em contato com seu representante Ebanx e solicite as seguintes credenciais:

Suas credenciais Ebanx

Certifique-se de que sua conta esteja configurada corretamente no lado Ebanx.

Integre o Ebanx#

Integrar o Ebanx na DEUNA.

1. Procure Ebanx Local na DEUNA

Procure Ebanx no seu DEUNA Admin.

Exemplo interativoUsa dados de exemplo e não faz solicitações à API.

Pagamentos

Conexões

Descubra e gerencie integrações de pagamento, carteiras e antifraude.

Acme LATAM · Produção

Pesquisar conexões

Conexões	Tipo	Status
Adyen	Gateway de pagamento	Conectada
Worldpay	Gateway de pagamento	Conectada
PayPal	Forma de pagamento	Conectada
Mercado Pago	Forma de pagamento	Não conectada
Riskified	Mecanismo antifraude	Não conectada

2. Configure o Ebanx na sua loja

Após pesquisar por Ebanx no Connections, você deve configurar o Ebanx em sua loja.

No Connections, uma janela como a seguinte será aberta:

Insira as seguintes credenciais:
- Em Nome insira um nome para fazer referência à credencial.
- Em Moeda selecione a moeda do processador do comerciante disponível.
- Em Chave privada insira a chave privada do Ebanx.
- Em Chave Pública insira a chave pública do Ebanx.
Clique Conectar.

Depois de concluir as etapas, você verá uma mensagem de sucesso.

3. Processar pagamentos com Ebanx

Você verá a conexão Ebanx na guia Conexões ativas .

A partir deste momento, você já pode processar transações com o Ebanx através da DEUNA.

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

Solicitação com opções de parcelamento

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

Considerações e limitações especiais#

Endereço de cobrança

As transações domésticas adquiridas pelo Ebanx devem incluir as seguintes informações do comprador na solicitação de autorização:

billing_address.zipcode
billing_address.state_name
billing_address.country_code

Isto segue a regulamentação local para retenção de impostos na província do comprador. Quando esses dados não são fornecidos, o Ebanx retém impostos com base na localização do estabelecimento comercial.

Código da moeda: especifica o código da moeda (ISO 4217) do país relevante.
Código do país: especifica o Códigos de país ISO
O número de parcelas é validado em relação ao número máximo de parcelas acordado com o adquirente.
O EBANX não apoia a captura do pata.
Um reembolso só pode ser solicitado após o pagamento chegar ao CAPTURED status.
Os reembolsos não podem exceder o valor original capturado, mas podem ser realizados um ou mais reembolsos parciais do valor capturado.
Apenas um reembolso parcial pode ser enviado por pedido.
Um pagamento só pode ser cancelado (Anulado) depois de atingir o AUTHORIZED status.
O cancelamento não é mais possível quando o pagamento chega ao CAPTURED status.
O cancelamento total (anulado) pode ser enviado por pedido.
As parcelas podem ser customizadas para oferecer um número específico de pagamentos e podem incluir opções sem juros ou cobranças definidas pelo lojista. Como funciona:
1. O cliente escolhe o parcelamento - Através da API Get Parcelamento o cliente poderá obter as opções de parcelamento disponíveis. A resposta incluirá informações como taxas, valor total com juros caso aplicável, além do valor da parcela.
2. Processamento de pagamentos através da DEUNA - Processamos o pagamento com as respetivas prestações diretamente com a PSP.