Transbanco | DEUNA Docs

En esta página

Integrar Transbank
Consideraciones y limitaciones especiales

Operaciones soportadas

La integración de Transbank en tu estrategia de pagos con DEUNA te permite realizar las siguientes operaciones:

Compra
Autorización^*
captura completa^*
Capturas parciales^*
Reembolso parcial
Reembolso completo
Anulación^*
Cuota

Métodos de pago admitidos

Tarjetas

visa
Mastercard
Amex

Países y monedas activos

Chile (CLP)

Requisitos

Contacta a tu representante de Transbank y solicita las siguientes credenciales:

Secreto de clave API (Tbk-Api-Key-Secret)
ID de comerciante (Tbk-Api-Key-Id)

Integrar Transbank#

Luego de buscar Transbank en Conexiones, debes configurar la conexión en tu tienda.

1. Configura Transbank en tu tienda

En Conexiones se abrirá una ventana como la siguiente:

Ingrese las siguientes credenciales:
- En Nombre introduzca un nombre para hacer referencia a la credencial.
- En Moneda seleccione la moneda del procesador comercial disponible.
- En Commerce ID ingresar el ID de Comerciante de Transbank (Tbk-Api-Key-Id).
- En Clave Privada ingresar la Clave Secreta API de Transbank (Tbk-Api-Key-Secret).
- En Tienda ingresa el código de tienda de Transbank si estás procesando bajo Transacción Completa Mall. De lo contrario, deje este parámetro vacío.
Elija el tipo de operación que desea realizar:
- Compra
- Autorización
Información
Las credenciales deben configurarse previamente con la puerta de enlace para admitir esta Operación.
Clic Conectar.

Una vez que complete los pasos, verá un mensaje de éxito.

3. Procesar pagos con Transbank

A continuación, podrás ver tu conexión Transbank dentro de la pestaña Conexiones Activas.

A partir de este momento ya podrás tramitar transacciones con Transbank a través de DEUNA.

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

Consideraciones y limitaciones especiales#

Como Transbank sólo admite 26 caracteres para la identificación del pedido, transformaremos el order_id parámetro para cumplir con los requisitos. Por lo tanto, es posible que veas una identificación diferente a la enviada desde DEUNA.
El número de cuotas se valida contra el número máximo de cuotas acordado con el adquirente.
Para utilizar Autorización, Captura (total y parcial) y Anulación, su comercio debe estar configurado en Transbank para operar con captura diferida.
Un pago que es AUTHORIZED puede ser capturado.
Se puede realizar una captura parcial si es necesario.
Cada pago autorizado permite una captura parcial o total.
Se recomienda capturar un pedido dentro de los 5 días posteriores a la autorización para evitar su vencimiento.
Se puede solicitar un reembolso sólo después de que el pago llegue al CAPTURED o PROCESSED status.
Los reembolsos no pueden exceder el monto capturado original, pero se pueden realizar uno o más reembolsos parciales del monto capturado.
Se pueden enviar múltiples reembolsos parciales por pedido.
Un pago puede cancelarse (anularse) sólo después de que alcance el AUTHORIZED status.
La cancelación ya no es posible una vez que el pago llega al CAPTURED status.
Se puede enviar una cancelación completa (anulación) por pedido.