Skip to Content

Chile Transbank Webpay

93.45 93.45

Instant digital delivery after payment confirmation.
License: OPL-1, every download is watermarked.
Terms and Conditions

Chile Transbank Webpay Plus

Online card acquiring for Chile with full refund support - using your own Transbank commerce code (BYOK)

Charge Chilean credit and debit cards directly from Odoo through the official Transbank Webpay Plus REST API. Create a hosted-form payment, commit the authorization, query its status and issue full or partial refunds - all from a single, auditable transaction record. This connector uses your own Transbank commerce code and API key; no third-party accreditation is required and no data leaves your Odoo except the calls to Transbank you configure.

Key Features

Full acquiring lifecycle

Create → commit → status, mapped to a clear Odoo state machine (Draft, Pending, Authorized, Failed). Every step records the authorization code, response code, VCI 3-D Secure indicator, masked card number, payment type and installments returned by Webpay.

Full & partial refunds

Refund any authorized transaction fully or partially. The connector tracks the refundable balance, prevents over-refunding, and recognises Transbank's same-day reversal (REVERSED) versus post-settlement nullification (NULLIFIED) outcomes automatically.

BYOK - your credentials

Store your own commerce code (Tbk-Api-Key-Id) and API key (Tbk-Api-Key-Secret). Switch between the Transbank integration sandbox and production with one field; the correct base URL is selected for you.

Invoice reconciliation

Link a transaction to a customer invoice, register the authorized payment in your bank journal, and generate a draft customer credit note automatically when you refund a posted invoice.

What is included

CapabilityDetail
Create transactionPOST to the Webpay Plus v1.2 endpoint; returns the hosted-form token and redirect URL.
Commit transactionConfirms the authorization once the shopper returns from Transbank.
Status queryIdempotent re-query of any transaction by token for reconciliation.
Refund / reversalFull or partial; REVERSED (same-day) and NULLIFIED outcomes handled.
Amount handlingWhole-peso (CLP) rounding, the format Webpay Plus requires.
Connection testOne-click validation of the commerce code and API key.
API call logEvery request is logged with method, URL, status, duration and error excerpt.
Response code mappingWebpay response codes translated to readable messages.

How it works

  1. Create a Webpay acquirer with your commerce code and API key, choose the environment, and test the connection.
  2. Start a charge (optionally from an invoice). The connector creates the transaction and gives you the Transbank redirect URL.
  3. The shopper authenticates on Transbank's hosted form and returns; you commit the transaction to capture the authorization.
  4. Refund fully or partially at any time; the refundable balance and credit notes are kept in sync.

Requirements

  • Odoo 18.0 or 19.0, Community or Enterprise.
  • An active Transbank Webpay Plus contract with your own commerce code and API key.
  • Python requests library (bundled with Odoo).

This module generates the Webpay Plus REST payloads and transmits them using your Transbank credentials. It is not a payment institution and does not provide Transbank accreditation.

Screenshots

Acquirers

Acquirers

Api Log

Api Log

New Charge

New Charge

Refunds

Refunds

Update date: 2026-07-02