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
| Capability | Detail |
|---|---|
| Create transaction | POST to the Webpay Plus v1.2 endpoint; returns the hosted-form token and redirect URL. |
| Commit transaction | Confirms the authorization once the shopper returns from Transbank. |
| Status query | Idempotent re-query of any transaction by token for reconciliation. |
| Refund / reversal | Full or partial; REVERSED (same-day) and NULLIFIED outcomes handled. |
| Amount handling | Whole-peso (CLP) rounding, the format Webpay Plus requires. |
| Connection test | One-click validation of the commerce code and API key. |
| API call log | Every request is logged with method, URL, status, duration and error excerpt. |
| Response code mapping | Webpay response codes translated to readable messages. |
How it works
- Create a Webpay acquirer with your commerce code and API key, choose the environment, and test the connection.
- Start a charge (optionally from an invoice). The connector creates the transaction and gives you the Transbank redirect URL.
- The shopper authenticates on Transbank's hosted form and returns; you commit the transaction to capture the authorization.
- 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
requestslibrary (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
Api Log
New Charge
Refunds
Update date: 2026-07-02