Transbanca | DEUNA Docs

In questa pagina

Integrare Transbank
Considerazioni e limitazioni speciali

Operazioni supportate

L'integrazione Transbank nella vostra strategia di pagamento con DEUNA consente di eseguire le seguenti operazioni:

Acquisto
Autorizzazione^*
Cattura completa^*
Acquisizioni parziali^*
rimborso parziale
rimborso completo
Void^*
Installazione

Metodi di pagamento supportati

Carte

Visto
Mastercard
Amex

Paesi attivi e valute

Cile (CLP)

Requisiti

Contatta il tuo rappresentante Transbank e richiedi le seguenti credenziali:

API Key Secret (Segreto di chiave)Tbk-Api-Key-Secret)
ID di Merchant (Mercante)Tbk-Api-Key-Id)

Integrare Transbank#

Dopo aver cercato Transbank in Connections, è necessario configurare la connessione nel tuo negozio.

1. Configura Transbank nel tuo negozio

In Connessioni, una finestra come la seguente si aprirà:

Inserisci le seguenti credenziali:
- In Nome inserire un nome per fare riferimento alle credenziali.
- In Valuta selezionare la valuta del processore di Merchant disponibile.
- In Commerce ID inserire il Transbank's Merchant ID (Tbk-Api-Key-Id).
- In Chiave privata inserire il segreto chiave API di Transbank (Tbk-Api-Key-Secret).
- In Store inserire il codice di negozio Transbank (tienda) se si sta elaborando Mall completo di Transacción. Altrimenti, lasciare vuoto questo parametro.
Scegli il tipo di operazione che vuoi eseguire:
- Acquisto
- Autorizzazione
Informazioni
Le credenziali devono essere configurate in precedenza con il gateway per supportare questa operazione.
Cliccare su Collegamento.

Una volta completate i passaggi, vedrete un messaggio di successo.

3. Elaborare pagamenti con Transbank

Successivamente, sarà possibile vedere la connessione Transbank all'interno della scheda Connessioni attive.

Da questo punto in poi, è ora possibile elaborare le transazioni con Transbank attraverso DEUNA.

Acquisto v2 esempio

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

Considerazioni e limitazioni speciali#

Poiché Transbank supporta solo 26 caratteri per l'identificazione dell'ordine, trasformeremo il order_id parametro per soddisfare i requisiti. Pertanto, si può vedere un id diverso di quello inviato dal DEUNA.
Il numero di rate viene convalidato rispetto al numero massimo di rate concordate con l'acquirente.
Per utilizzare l'autorizzazione, la cattura (pieno e parziale) e il vuoto, il commerciante deve essere configurato in Transbank per operare con Captura diferida.
Un pagamento che è AUTHORIZED può essere catturato.
Una cattura parziale può essere eseguita se necessario.
Ogni pagamento autorizzato consente una cattura parziale o completa.
Si raccomanda di catturare un ordine entro 5 giorni dall'autorizzazione per evitare la scadenza.
Un rimborso può essere richiesto solo dopo un pagamento raggiunge il CAPTURED o PROCESSED status.
I rimborsi non possono superare l'importo acquisito originale, ma si possono effettuare uno o più rimborsi parziali dell'importo catturato.
Il rimborso parziale può essere inviato per ordine.
Un pagamento può essere annullato (Void) solo dopo che raggiunge il AUTHORIZED status.
La cancellazione non è più possibile una volta che il pagamento raggiunge il CAPTURED status.
Cancellazione completa (void) può essere inviata per ordine.