Transbanco | DEUNA Docs

Nesta página

Integrar o Transbank
Considerações e limitações especiais

Operações Suportadas

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

Comprar
Autorização^*
Captura completa^*
Capturas parciais^*
Reembolso parcial
Reembolso total
Vazio^*
Parcela

Métodos de pagamento suportados

Cartões

Visto
Mastercard
Amex

Países e moedas ativos

Chile (CLP)

Requisitos

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

Segredo da chave de API (Tbk-Api-Key-Secret)
ID do comerciante (Tbk-Api-Key-Id)

Integrar o Transbank#

Após pesquisar por Transbank no Conexões, você deverá configurar a conexão em sua loja.

1. Configure o Transbank 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 Commerce ID insira o ID do comerciante do Transbank (Tbk-Api-Key-Id).
- Em Chave privada insira o segredo da chave API do Transbank (Tbk-Api-Key-Secret).
- Em Loja insira o código da loja do Transbank (tienda) se estiver processando sob Transação Completa Mall. Caso contrário, deixe este parâmetro vazio.
Escolha o tipo de operação que deseja realizar:
- Comprar
- Autorização
Informação
As credenciais devem ser previamente configuradas com o gateway para suportar esta Operação.
Clique Conectar.

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

3. Processar pagamentos com Transbank

A seguir, você poderá ver sua conexão Transbank na guia Conexões ativas.

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

Exemplo de compra v2

JSON

{
  "payer_info": {
    "email": "test_chile@testuser.com",
    "date_of_birth": "1990-08-30T16:00:00.000Z"
  },
  "payment_source": {
    "method_type": "credit_card",
    "card_info": {
      "card_number": "4051885600446623",
      "card_holder": "JUAN PÉREZ",
      "expiry_month": "08",
      "expiry_year": "30",
      "card_cvv": "123",
      "card_holder_dni": "12.345.678-5",
      "zip": "8320000",
      "city": "Santiago",
      "address1": "Av. Apoquindo 3000",
      "state": "Región Metropolitana",
      "phone": "+56228901234",
      "country": "CL"
    }
  },
  "order": {
    "order_id": "fee5036f-8251-4101-8ecc-74259e6e040b",
    
    "currency": "CLP",
    "items": [
      {
        "id": "TK001",
        "name": "Tiquete Aéreo Santiago - Antofagasta",
        "description": "Vuelo LATAM LA128 • Clase Economy",
        "options": "Equipaje de mano incluido",
        "total_amount": {
          "original_amount": 459900,
          "amount": 459900,
          "currency": "CLP",
          "currency_symbol": "$"
        },
        "unit_price": {
          "amount": 459900,
          "currency": "CLP",
          "currency_symbol": "$"
        },
        "tax_amount": {
          "amount": 0,
          "currency": "CLP",
          "currency_symbol": "$"
        },
        "quantity": 1,
        "uom": "ticket",
        "upc": "",
        "sku": "TKT-SCL-ANF-ECON",
        "isbn": "",
        "brand": "LATAM",
        "manufacturer": "",
        "category": "Aereo",
        "color": "",
        "size": "",
        "weight": {
          "amount": 0,
          "unit": "kg"
        },
        "image_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/8/8a/LATAM_Airlines_logo.svg/512px-LATAM_Airlines_logo.svg.png",
        "details_url": "",
        "type": "service",
        "taxable": true
      }
    ],
    "sub_total": 45990000,
    "total_amount": 45990000,
    "store_code": "all",
    "billing_address": {
      "address1": "Av. Apoquindo 3000",
      "address2": "Oficina 1205",
      "address_type": "office",
      "city": "Santiago",
      "country_code": "CL",
      "email": "test_chile@testuser.com",
      "first_name": "Juan",
      "last_name": "Pérez",
      "identity_document": "12.345.678-5",
      "identity_document_type": "RUT",
      "is_default": true,
      "phone": "+56228901234",
      "state_code": "RM",
      "state_name": "Región Metropolitana",
      "zipcode": "8320000"
    },
    "shipping_address": {
      "address1": "Av. Apoquindo 3000",
      "address2": "Oficina 1205",
      "address_type": "office",
      "city": "Santiago",
      "country_code": "CL",
      "email": "test_chile@testuser.com",
      "first_name": "Juan",
      "last_name": "Pérez",
      "identity_document": "12.345.678-5",
      "identity_document_type": "RUT",
      "is_default": true,
      "phone": "+56228901234",
      "state_code": "RM",
      "state_name": "Región Metropolitana",
      "zipcode": "8320000"
    }
  }
}

Considerações e limitações especiais#

Como o Transbank suporta apenas 26 caracteres para identificação do pedido, transformaremos o order_id parâmetro para atender aos requisitos. Portanto, você poderá ver um ID diferente daquele enviado pela DEUNA.
O número de parcelas é validado em relação ao número máximo de parcelas acordado com o adquirente.
Para utilizar Autorização, Captura (total e parcial) e Anulação, seu estabelecimento comercial deve estar configurado no Transbank para operar com Captura de lesão.
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 ou PROCESSED status.
Os reembolsos não podem exceder o valor original capturado, mas podem ser realizados um ou mais reembolsos parciais do valor capturado.
Vários reembolsos parciais podem ser enviados 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.