Transbank

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

📘

Transbank connection supports version 1.2 using Transacción Completa and Transacción Completa Mall.

Online multiple partial captures^* and refunds can be enabled through configuration. Contact DEUNA to activate these features if required

(^*) To use Authorization, Capture (full and partial) and void, you merchant must be configured in Transbank to operate with Captura diferida.

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)

📘
Make sure your merchant is properly configured on the Transbank side.

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:

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.
Choose the type of operation you want to perform:
- Purchase
- Authorization
📘
Credentials must be previously configured with the gateway to support this Operation.
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

❗️
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.

{
  "payer_info": {
    "email": "[email protected]",
    "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": "[email protected]",
      "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": "[email protected]",
      "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

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.
The number of installments is validated against the maximum number of installments agreed with the acquirer.
To use Authorization, Capture (full and partial) and void, you merchant must be configured in Transbank to operate with Captura diferida.
A payment that is AUTHORIZED can be captured.
A partial capture can be performed if necessary.
Each authorized payment allows for either a partial or full capture.
It is recommended to capture an order within 5 days of the authorization to prevent expiration.
A refund can be requested only after a payment reaches the CAPTURED or PROCESSED status.
Refunds cannot exceed the original captured amount, but one or more partial refunds of the captured amount can be performed.
Multiple partial refund can be sent per order.
A payment can be canceled (Void) only after it reaches the AUTHORIZED status.
Cancellation is no longer possible once the payment reaches the CAPTURED status.
Full cancel (void) can be sent per order.