---
title: "Create Inbound Transaction (Chile)"
method: POST
path: "/cl/transactions/inbound"
tags: ["Chile"]
---

# Create Inbound Transaction (Chile)

`POST /cl/transactions/inbound`

Create an inbound transaction and receive a hosted checkout URL.
Account must be Chile CLP. Starts in `pending` until payment completes.

## Request body

- ClInboundTransactionRequest — Create inbound transaction (hosted checkout) for Chile CLP accounts
  - `accountId` string, uuid, required
  - `paymentMethodId` string, uuid, required — ID from GET /cl/payment-methods
  - `amount` union, required — Amount in CLP (e.g. 100.50)
    - number
    - string
  - `description` string
  - `webhookUrl` string, uri
  - `returnUrl` string, uri
  - `language` 'EN' | 'ES' | 'PT'
  - `customer` ClInboundCustomer, required
    - `firstName` string, required
    - `lastName` string, required
    - `email` string, email, required
    - `personalId` string, required — Chile national ID (cédula)
    - `ip` string, required
    - `city` string
    - `address` string
    - `zip` string
    - `phone` string

## Response `201`

Transaction created

- ClInboundTransactionResponse
  - `id` string, uuid, required
  - `checkoutUrl` string, uri, required — Redirect payer to this hosted checkout URL
  - `status` 'pending', required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden — account is not operative (`Bloqueada` or `Cerrada`) or caller lacks access
- `404` — Account or payment method not found
- `502` — Unable to complete the payment operation

---

[API](https://skmtc.net/hg/apis/hg-cash-api.md) · [All operations](https://skmtc.net/hg/apis/hg-cash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hg/hg-cash-api/revisions/0d337f48a0b9/schema)