Skip to main content
All systems operationalChangelogv1
Log in

Transbank

This page provides a guide to integrate Transbank with DEUNA.

On this page

Supported Operations

Transbank integration in your payment strategy with DEUNA allows you to perform the following operations:

  • Purchase
  • Authorization*
  • Full capture*
  • Partial captures*
  • Partial refund
  • Full refund
  • Void*
  • Installment

Supported Payment Methods

Cards

  • Visa
  • Mastercard
  • Amex

Active countries and currencies

  • Chile (CLP)

Requirements

Contact your Transbank representative and request the following credentials:

  • API Key Secret (Tbk-Api-Key-Secret)
  • Merchant ID (Tbk-Api-Key-Id)

Integrate Transbank#

After searching for Transbank in Connections, you must configure the connection in your store.

1. Configure Transbank in your store

In Connections, a window like the following will open:


  1. Enter the following credentials:
    • In Name enter a name to reference the credential.
    • In Currency select the Currency of Merchant Processor available.
    • In Commerce ID enter the Transbank's Merchant ID (Tbk-Api-Key-Id).
    • In Private Key enter the Transbank's API Key Secret (Tbk-Api-Key-Secret).
    • In Store enter the Transbank's store code (tienda) if you are processing under Transacción Completa Mall. Otherwise, leave this parameter empty.
  2. Choose the type of operation you want to perform:
    • Purchase
    • Authorization
  3. Click Connect.

Once you complete the steps, you will see a success message.

3. Process payments with Transbank

Next, you will be able to see your Transbank connection within the Active Connections tab.

From this point on, you can now process transactions with Transbank through DEUNA.

Purchase v2 example

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

Special considerations and limitations#

  1. As Transbank only supports 26 characters for the order identification, we will transform the order_id parameter to meet the requirements. Therefore, you may see a different id than the one sent from DEUNA.
  2. The number of installments is validated against the maximum number of installments agreed with the acquirer.
  3. To use Authorization, Capture (full and partial) and void, you merchant must be configured in Transbank to operate with Captura diferida.
  4. A payment that is AUTHORIZED can be captured.
  5. A partial capture can be performed if necessary.
  6. Each authorized payment allows for either a partial or full capture.
  7. It is recommended to capture an order within 5 days of the authorization to prevent expiration.
  8. A refund can be requested only after a payment reaches the CAPTURED or PROCESSED status.
  9. Refunds cannot exceed the original captured amount, but one or more partial refunds of the captured amount can be performed.
  10. Multiple partial refund can be sent per order.
  11. A payment can be canceled (Void) only after it reaches the AUTHORIZED status.
  12. Cancellation is no longer possible once the payment reaches the CAPTURED status.
  13. Full cancel (void) can be sent per order.