Ebanx | DEUNA Docs

Nesta página

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

Esta página fornece um guia para integrar o Ebanx 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
Capturas parciais
Compra (capturada automaticamente)
Reembolso parcial (até um por pedido)
Reembolso total
Vazio
Parcela
3DS DEUNA

Métodos de pagamento suportados

Cartões

Visto
Mastercard

Países e moedas ativos

Costa Rica (CRC, USD)
Argentina (ARS)
Brasil (BRL, USD)
Chile (CLP)
Colômbia (COP)
Equador (USD)
México (MXN)
Peru (PEN, USD)
Paraguai (PYG)
Uruguai (UYI, USD)
África do Sul (ZAR)

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 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.
Escolha o tipo de operação que deseja realizar:
- Comprar
- Autorização
Escolha se deseja ativar o 3DS.
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.

Envie um dos códigos:

ISO
Códigos de província locais (COMARB)

Código da província COMARB	Código da província ISO	Nome da província
901	AR-C	CABA
909	AR-P	Formosa
919	AR-D	São Luís
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	Córdoba
912	AR-F	La Rioja
922	AR-G	Santiago del Estero
918	AR-J	São João
913	AR-M	Mendoza
914	AR-N	Missões
915	AR-Q	Neuquén
916	AR-R	Rio Negro
923	AR-V	Terra do Fogo
902	AR-B	Buenos Aires
921	AR-S	Santa Fé
924	AR-T	Tucumán
905	AR-W	Corrientes

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.
Um pagamento que é AUTHORIZED pode ser capturado.
Uma captura parcial pode ser realizada, se necessário.
Cada pagamento autorizado permite uma captura parcial ou total.
Recomenda-se capturar um pedido no prazo de 5 dias após a autorização para evitar a expiração.
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.
Antes de aceitar pagamentos na América Latina, é necessária uma entidade legal e um adquirente no país de operação

Testando recursos#

Credenciais Ebanx

ABAP

Private Key
test_ik_L9l0hOg-Qg7xScUGw-QLAA

Public Key
test_pk_AAK0Nzo8Vcp6yuRwYuDu7A

Coleção do Postman

Solicite o ambiente e coleção atual do EBANX Postman à sua equipe de integração DEUNA.

Cartões de teste

Marca	Tipo	Número do cartão	Mês de vencimento	Ano de expiração	CVV
Visto	Aprovado	4111115666052208	12	2026	123
Mestre	Aprovado	5555556355564617	12	2026	123
Visto	Rejeitado	4918019199883839	12	2026	123