--- title: "Crear Charge" method: POST path: "/{country_code}/charge" tags: ["Transactions"] --- # Crear Charge `POST /{country_code}/charge` ## Request - Base URL: `https://api.trytoku.com` - URL: `https://api.trytoku.com/{country_code}/charge` - Auth: API key in header `x-api-key` Cobra a una Account los Invoices o el monto indicados, con los medios de pago que se envíen. Se usa para ejecutar un cobro a demanda desde una integración: el cuerpo indica la Account, el medio de pago (`id_payment_instrument` o `id_payment_methods`) y qué cobrar (`id_invoices`, un `amount`, o ambos). Las rutas `/cl`, `/mx` y `/br` son equivalentes: el país con que se procesa el cobro lo determina la Organization dueña de la Account, no el prefijo de la ruta. El cobro se ejecuta durante la llamada, así que la respuesta trae las Transactions resultantes con el estado que alcanzaron. Cuando el cuerpo pide esperar el resultado de la inscripción del medio de pago, la respuesta agrega el medio de pago inscrito y un `actions_status` que resume cómo terminaron el cobro y la inscripción. Los reintentos se deduplican por `idempotency_key`: una segunda llamada con la misma llave no vuelve a cobrar y responde con las Transactions del cobro original, con el estado que tienen al momento del reintento. La deduplicación dura 12 horas; pasado ese plazo la misma llave inicia un cobro nuevo. Responde `401` cuando la Account, los Invoices, los medios de pago o el instrumento de pago no pertenecen a la Organization autenticada, y `400` cuando los medios de pago enviados mezclan Transbank OneClick con medios que se cobran por orquestación, cuando traen más de un medio Transbank OneClick, o cuando ninguno de los medios enviados existe. **Límite de tasa:** 20 solicitudes por segundo. Al superarlo, la API responde `429`. Ver [Límites de tasa](/reference/limites-de-tasa). ## Path parameters - `country_code` 'cl' | 'mx' | 'br', required ## Headers - `x-api-version` string, date: Versión del API para esta petición, como cualquier fecha `YYYY-MM-DD`. Fija el contrato de la respuesta; si se omite, se deriva de la fecha de creación de la organización. - `x-account-key` string ## Request body - ChargeRequest: Cobro a demanda sobre los Invoices o el monto indicados. - `actions` ActionData[]: Acciones que compone el cobro: el producto de pago de cada una y si es un pago o una inscripción. Obligatorio salvo cuando se cobra a un medio de pago Transbank OneClick, que no lo usa. - `action_type` 'INSCRIPTION' | 'PAYMENT', required: Qué acción ejecuta un elemento del árbol de orquestación. `PAYMENT` intenta el cobro con el medio de pago del elemento. `INSCRIPTION` inscribe ese medio de pago para cobros futuros, sin cobrar en ese paso. Un mismo árbol puede llevar las dos, y en ese caso el resultado combinado del cobro y de la inscripción queda en `ChargeActionsStatus`. - `toku_product` 'pac_management' | 'pac_inscription' | 'direct_debit_cl' | 'direct_debit_mx' | 'transfer_cl' | 'transbank_oneclick' | 'transbank_webpay_plus' | 'klap_oneclick' | 'patpass' | 'cash' | 'cash_mx_one_time_psp' | 'cash_mx_one_time_pst' | 'cash_mx_psp' | 'cash_mx_pst' | 'toku_gateways' | 'payment_orchestration' | 'payment_orchestration_onetime' | 'multigateway_onetime' | 'toku_card_on_file' | 'toku_onetime' | 'domiciliation' | 'high_value_transfer' | 'codi' | 'wallet_mx' | 'cards_batch_mx_recurring_pst' | 'atoa_batch_mx_recurring_pst' | 'pix_onetime_pst_br' | 'boleto_br_onetime_pst' | 'boleto_br_recurring_pst' | 'pix_br_onetime_pst' | 'pix_br_onetime_psp' | 'pix_br_recurring_psp' | 'pix_bank_br_automatic_pst' | 'pix_bank_br_automatic_psp' | 'pix_bank_br_onetime_psp' | 'pix_openfinance_br_automatic_psp' | 'boleto_bank_br_onetime_psp' | 'cash_pst_cl' | 'transfer_mx_pst' | 'transfer_mx_psp' | 'transfer_cl_pst' | 'transfer_cl_psp' | 'direct_debit_onetime_cl_pst' | 'direct_debit_onetime_cl_psp' | 'bank_button_cl_pst' | 'bank_button_multiple_cl_pst' | 'bank_button_cl_psp' | 'bank_button_multiple_cl_psp' | 'digital_mandate_cl' | 'transfer_mx' | 'cards_br_recurring_pst' | 'cards_br_onetime_pst' | 'cards_br_recurring_psp' | 'cards_br_onetime_psp' | 'atoa_br_recurring_pst' | 'internal_balance' | 'cards_cl_onetime_pst' | 'cards_cl_recurring_pst' | 'cards_cl_pos_pst' | 'br_automatic_debit_pst' | 'external_collector_cl_pst' | 'referenced_payment_mx_psp' | 'in_app_payment_mx_psp' | 'external_payment' | 'collections_ai_agent' | 'bolepix_br_onetime_pst' | 'bolepix_bank_br_onetime_psp' | 'contacted_end_customers' | 'vcc' | 'atoa_batch_mx_recurring_psp' | 'international_transfer_mx_pst' | 'rat' | 'batch_reconciliations' | 'account_payouts' | 'account_payables' | 'transfer_cl_psp_wallet' | 'wallet_mx_psp', required: Producto de cobro de Toku: la combinación de método de pago, país y modalidad con que se ejecuta un cobro. El nombre codifica esas tres cosas — por ejemplo `pix_br_recurring_psp` es Pix recurrente en Brasil bajo el modelo PSP, y `cards_cl_onetime_pst` es tarjetas de un solo pago en Chile bajo el modelo PST. Es el valor que decide con qué integración se ejecuta el cobro, así que buena parte de la lógica que depende del país se resuelve a partir de él. Qué productos tiene habilitados una organización es parte de su configuración: este listado es el universo posible, no lo que una organización determinada puede cobrar hoy. `cash`, `cash_mx_one_time_psp`, `cash_mx_one_time_pst` y `transfer_mx` están deprecados y solo sobreviven por compatibilidad con registros históricos. - `amount` number: Monto a cobrar. Debe enviarse este campo o `id_invoices`. - `capture_method` 'AUTOMATIC' | 'DEFERRED': Cuándo se captura el monto autorizado de un cobro. Con `AUTOMATIC`, el valor por defecto, la autorización y la captura ocurren en el mismo intento. Con `DEFERRED` el cobro queda autorizado en `CAPTURE_PENDING` y el monto se captura en una operación posterior, que puede capturar hasta el total autorizado. - `external_id` string: Referencia externa que la Organization asigna a la Transaction del cobro. - `id_account` string, required: Identificador público de la Account a la que se le cobra. - `id_invoices` string[]: Identificadores públicos de los Invoices que se quieren saldar. Debe enviarse este campo o `amount`. - `id_orchestration_tree` string: Identificador del árbol de orquestación base con que se cobra. Si se omite o no existe, el árbol se arma a partir de `actions`. - `id_payment_instrument` string: Identificador público del instrumento de pago con que se cobra. Debe enviarse este campo o `id_payment_methods`. - `id_payment_methods` string[]: Identificadores públicos de los medios de pago con que se cobra. Debe enviarse este campo o `id_payment_instrument`, y todos deben pertenecer a la Account indicada. - `idempotency_key` string: Llave con que se deduplican los reintentos del cobro; si se omite, se genera una. - `metadata` object: Datos libres que la Organization adjunta al cobro. - `should_await_inscription_result` boolean: Cuando es `true`, la respuesta espera el resultado de la inscripción del medio de pago y agrega `actions_status`. - `unique_external_id` string: Referencia externa única del cobro; si se omite, se genera una. ## Response `201` Transactions que dejó el cobro y, si se pidió, el medio de pago inscrito. - ChargeResponse: Resultado de un cobro a demanda. - `actions_status` 'PAYMENT_FAILED_INSCRIPTION_SKIPPED' | 'PAYMENT_FAILED_INSCRIPTION_FAILED' | 'PAYMENT_FAILED_INSCRIPTION_SUCCESS' | 'PAYMENT_SUCCESS_INSCRIPTION_PENDING' | 'PAYMENT_SUCCESS_INSCRIPTION_FAILED' | 'PAYMENT_SUCCESS_INSCRIPTION_SUCCESS': Estado combinado de las acciones de pago e inscripción. - `payment_method` ApiPaymentTransactionDTOAggregatedPaymentMethodV2: Misma forma que :class:`DTOAggregatedPaymentMethodV1` más un campo ``updated_fields`` que lleva solo lo que cambió en la llamada a ``update_payment_method`` en curso. ``updated_fields`` es un modelo tipado :class:`DTOUpdatedFields`, así el contrato queda explícito: cualquier comercio que se integre con el webhook conoce el conjunto exacto de claves que puede recibir, y pydantic valida la forma al momento de construir el objeto. Diseñado para que el mismo DTO pueda servir a varios tipos de evento de webhook (attached, updated, etc.). - `customer` DTOCustomerV2 - `email` string - `external_id` string - `government_id` string - `id` string, required - `metadata` object - `name` string - `phone_number` string - `gateway` 'transbank_oneclick' | 'klap_oneclick' | 'patpass' | 'toku_pac' | 'fintoc_pac' | 'universo_pac' | 'external_pac' | 'ecert_pac' | 'manual_pac' | 'internal_psp' | 'domiciliation' | 'mx_banco_bbva' | 'mx_banco_bancomer' | 'mx_banco_banbajio' | 'mx_banco_banorte' | 'mx_banco_banorte_h2h' | 'mx_banco_banregio' | 'mx_banco_bbva_bancomer' | 'mx_banco_citibanamex' | 'mx_banco_santander' | 'mx_banco_scotiabank' | 'mx_banco_scotiabank_h2h_external' | 'evo_payments' | 'conekta' | 'stripe' | 'kushki' | 'openpay' | 'paypal' | 'getnet' | 'fiserv' | 'transbank' | 'toku_gateways' | 'payment_orchestration' | 'cards_batch_mx' | 'cards_batch_mx_recurring_pst' | 'amex_batch_mx_recurring_pst' | 'atoa_batch_mx_recurring_pst' | 'braintree' | 'cielo' | 'pagarme' | 'belvo' | 'iniciador' | 'qi_tech' | 'mit' | 'mit_amex' | 'rede' | 'br_banco_do_brasil' | 'br_banco_itau' | 'br_banco_santander' | 'br_banco_citibank' | 'br_banco_de_brasilia_via_accesstage' | 'br_santander_via_accesstage' | 'br_bradesco_via_accesstage' | 'br_banco_do_brasil_via_accesstage' | 'br_c6_via_accesstage' | 'br_sicoob_via_accesstage' | 'br_caixa_via_accesstage' | 'br_itau_via_accesstage' | 'br_sicoob' | 'worldpay' | 'br_caixa' | 'br_btg' | 'br_banco_itau_boleto' | 'br_banco_bradesco_boleto' | 'br_sicredi_boleto' | 'br_banco_de_brasilia': Integración a través de la cual se inscribió un medio de pago y por la que se cobrará después. Combina el adquirente o banco con la modalidad de inscripción — por ejemplo `transbank_oneclick` es una tarjeta inscrita en Oneclick de Transbank, y `fintoc_pac` un mandato de descuento automático inscrito vía Fintoc. Es un conjunto distinto de `PaymentIntentGateway`, que identifica por dónde sale un cobro puntual: no todo gateway capaz de cobrar sirve para inscribir un medio de pago. - `id_account` string - `id_checkout_session` string - `payment_method` ApiPaymentTransactionDTOPaymentMethodV7, required: Un Payment Method es la forma de pago que un Customer deja inscrita para que Toku le cobre después: una tarjeta guardada, una cuenta bancaria para PAC o domiciliación, un Pix o un boleto recurrente. Guarda en qué estado quedó la inscripción —de eso depende que se le pueda cobrar—, con qué procesador se cursa el cobro y el detalle del medio inscrito, que viaja en `card`, `bank_account` o `pix` según su `type`; un `boleto` no trae detalle. Los datos sensibles nunca viajan aquí: la tarjeta se identifica por su token y sus últimos dígitos. - `bank_account` ApiPaymentTransactionDTOBankAccountPaymentMethodV1: Datos de la cuenta bancaria con la que se cobra un Payment Method de tipo `bank_account`. Es la cuenta que el Customer deja registrada para que se le cargue por PAC o domiciliación bancaria. - `account_number` string: Número de la cuenta bancaria. - `account_type` union: Tipo de cuenta bancaria, por ejemplo corriente, vista o de ahorro. - '03' | '40': Tipo de cuenta de destino en México, en la codificación que usa el sistema de pagos mexicano: `03` para una tarjeta de débito y `40` para una CLABE interbancaria. El tipo determina cómo se interpreta el número de cuenta que lo acompaña. - string - `additional_data` object: Datos complementarios de la cuenta que registró la institución financiera. - `bank_id` string: Código de la institución financiera de la cuenta. - `bank_name` string: Nombre de la institución financiera de la cuenta. - `institution_country` 'CL' | 'MX' | 'BR': País, en código [ISO 3166-1 alfa-2](https://es.wikipedia.org/wiki/ISO_3166-1_alfa-2). Se limita a los países donde Toku opera: `CL` (Chile), `MX` (México) y `BR` (Brasil). El país determina qué medios de pago y qué productos de cobro están disponibles. - `name` string: Nombre del titular de la cuenta bancaria. - `card` CardPaymentMethod: Datos de la tarjeta con la que se cobra un Payment Method de tipo `card`. Nunca lleva el número completo ni el CVV: la tarjeta viaja identificada por su BIN, sus últimos dígitos y el token con el que el procesador la reconoce. - `additional_data` object: Datos complementarios de la tarjeta que registró el procesador. - `bank_id` string: Código del banco emisor de la tarjeta. - `bank_name` string: Nombre del banco emisor de la tarjeta. - `bin` string: Primeros dígitos de la tarjeta, que identifican al emisor y al tipo de producto. - `card_brand` string: Marca de la tarjeta, por ejemplo `visa` o `mastercard`. - `card_holder` string: Nombre del titular registrado en la tarjeta. - `card_type` union: Tipo de tarjeta: `credit`, `debit` o `prepaid`. - 'credit' | 'debit' | 'prepaid': Clase de tarjeta según quién financia el pago: `credit` crédito, `debit` débito y `prepaid` prepago. - string - `expiration_month` string: Mes de vencimiento de la tarjeta, de `01` a `12`. - `expiration_year` string: Año de vencimiento de la tarjeta. - `institution_country` 'CL' | 'MX' | 'BR': País, en código [ISO 3166-1 alfa-2](https://es.wikipedia.org/wiki/ISO_3166-1_alfa-2). Se limita a los países donde Toku opera: `CL` (Chile), `MX` (México) y `BR` (Brasil). El país determina qué medios de pago y qué productos de cobro están disponibles. - `last_digits` string: Últimos dígitos de la tarjeta, para que el cliente final la reconozca. - `three_d_secure` boolean: Indica si la tarjeta se inscribió con autenticación 3-D Secure del emisor. - `token` string: Token con el que el procesador identifica la tarjeta guardada. Reemplaza al número de tarjeta al momento de cobrar. - `card_brand` string: Marca de la tarjeta, por ejemplo `visa` o `mastercard`. Es nulo cuando el medio de pago no es una tarjeta. - `created_at` string, date-time: Fecha y hora en que se inscribió el medio de pago. - `external_id` string: Identificador que entrega la organización para reconocer el medio de pago en sus propios sistemas. - `gateway` 'transbank_oneclick' | 'klap_oneclick' | 'patpass' | 'toku_pac' | 'fintoc_pac' | 'universo_pac' | 'external_pac' | 'ecert_pac' | 'manual_pac' | 'internal_psp' | 'domiciliation' | 'mx_banco_bbva' | 'mx_banco_bancomer' | 'mx_banco_banbajio' | 'mx_banco_banorte' | 'mx_banco_banorte_h2h' | 'mx_banco_banregio' | 'mx_banco_bbva_bancomer' | 'mx_banco_citibanamex' | 'mx_banco_santander' | 'mx_banco_scotiabank' | 'mx_banco_scotiabank_h2h_external' | 'evo_payments' | 'conekta' | 'stripe' | 'kushki' | 'openpay' | 'paypal' | 'getnet' | 'fiserv' | 'transbank' | 'toku_gateways' | 'payment_orchestration' | 'cards_batch_mx' | 'cards_batch_mx_recurring_pst' | 'amex_batch_mx_recurring_pst' | 'atoa_batch_mx_recurring_pst' | 'braintree' | 'cielo' | 'pagarme' | 'belvo' | 'iniciador' | 'qi_tech' | 'mit' | 'mit_amex' | 'rede' | 'br_banco_do_brasil' | 'br_banco_itau' | 'br_banco_santander' | 'br_banco_citibank' | 'br_banco_de_brasilia_via_accesstage' | 'br_santander_via_accesstage' | 'br_bradesco_via_accesstage' | 'br_banco_do_brasil_via_accesstage' | 'br_c6_via_accesstage' | 'br_sicoob_via_accesstage' | 'br_caixa_via_accesstage' | 'br_itau_via_accesstage' | 'br_sicoob' | 'worldpay' | 'br_caixa' | 'br_btg' | 'br_banco_itau_boleto' | 'br_banco_bradesco_boleto' | 'br_sicredi_boleto' | 'br_banco_de_brasilia': Integración a través de la cual se inscribió un medio de pago y por la que se cobrará después. Combina el adquirente o banco con la modalidad de inscripción — por ejemplo `transbank_oneclick` es una tarjeta inscrita en Oneclick de Transbank, y `fintoc_pac` un mandato de descuento automático inscrito vía Fintoc. Es un conjunto distinto de `PaymentIntentGateway`, que identifica por dónde sale un cobro puntual: no todo gateway capaz de cobrar sirve para inscribir un medio de pago. - `id` string, required: Identificador único del Payment Method. - `id_payment_instrument` string: Payment Instrument al que apunta el medio de pago: la tarjeta o cuenta concreta que Toku tiene guardada y que puede compartirse entre varios medios de pago. - `payment_method_metadata` object: Datos propios de la organización que se guardaron junto al medio de pago. - `pix` PixPaymentMethod: Dados do Pix com o qual se cobra um Payment Method do tipo `pix`, disponível apenas no Brasil. Reúne tanto o que identifica a conta do pagador quanto os artefatos com os quais o cliente final conclui o pagamento: o código QR, o código *copia e cola*, e o link para o qual ele é redirecionado. - `account_type` string: Tipo de conta bancária do pagador. - `additional_data` object: Dados complementares do Pix registrados pelo provedor. - `bank_id` string: Código da instituição financeira do pagador. - `bank_name` string: Nome da instituição financeira do pagador. - `copy_paste_code` string: Código *copia e cola* com o qual o cliente final paga pelo seu banco. - `end_to_end_id` string: Identificador com o qual o Banco Central do Brasil acompanha a transferência de ponta a ponta. - `error_code` string: Código com o qual o provedor respondeu à recusa. É nulo quando não houve recusa. - `error_message` string: Mensagem com a qual o provedor explicou a recusa. É nulo quando não houve recusa. - `expiration_date` string, date-time: Data e hora até a qual o código de pagamento permanece válido. - `institution_country` 'CL' | 'MX' | 'BR': País, en código [ISO 3166-1 alfa-2](https://es.wikipedia.org/wiki/ISO_3166-1_alfa-2). Se limita a los países donde Toku opera: `CL` (Chile), `MX` (México) y `BR` (Brasil). El país determina qué medios de pago y qué productos de cobro están disponibles. - `internal_bank_id` string: Identificador da instituição financeira nos sistemas da Toku. - `issuer` string: Instituição que emite o Pix. - `number` string: Número da conta do pagador. - `pix_automatic` object: Dados da autorização do Pix Automático, quando o meio de pagamento ficou habilitado para cobranças recorrentes sem intervenção do cliente final. - `provider_request_id` string: Identificador com o qual o provedor reconhece a solicitação. - `qr_code` string: Código QR que o cliente final escaneia para pagar. - `redirect_url` string: Link para o qual o cliente final é redirecionado para autorizar o Pix no seu banco. - `tax_id` string: CPF ou CNPJ do titular da conta. - `total_installments` string: Quantidade de parcelas acordadas para a cobrança. - `provider_external_id` string: Identificador con el que el procesador reconoce el medio de pago. - `status` 'deleted' | 'initialized' | 'chargeable' | 'temporary_failed' | 'permanent_failed' | 'three_ds_required' | 'inscription_failed' | 'pending_activation' | 'manually_chargeable' | 'permanent_deletion_in_progress' | 'permanently_deleted' | 'finished' | 'cancelled' | 'pending_deletion', required: Estado de un medio de pago dentro de su ciclo de vida, desde que se inscribe hasta que se da de baja. Es lo que decide si se le puede cobrar. Se cobra con `chargeable` y también con `temporary_failed`: este último es un cobro que falló por una causa reintentable, así que el motor de cobranza lo sigue tomando. `permanent_failed` queda fuera, aunque la Organization puede configurar que un porcentaje de ellos se reintente igual. `manually_chargeable` solo entra cuando el cobro se dispara a mano; las corridas automáticas lo saltan. La inscripción pasa por `initialized` mientras Toku la procesa, y queda en `pending_activation` cuando terminó de su lado pero falta la confirmación del banco o del proveedor. Si la inscripción misma falla queda en `inscription_failed`, que ya no vuelve a ser cobrable. La baja tiene dos caminos. El lógico conserva el historial del medio de pago: `pending_deletion` es una eliminación diferida, en espera de que terminen los cobros en curso, y `deleted` es la eliminación ya aplicada. El otro camino borra los datos de la tarjeta en el proveedor al cumplirse el plazo de retención, y avanza de `permanent_deletion_in_progress` a `permanently_deleted` cuando el borrado queda confirmado. `finished` y `cancelled` cierran los cobros recurrentes de Pix en Brasil: el primero es que la serie de cobros se completó y el segundo que se canceló antes de completarse. `three_ds_required` es un estado heredado que ya no se usa. - `status_history` StatusHistory[]: Cambios de estado por los que pasó el medio de pago, en el orden en que ocurrieron. - `new_status` string, required: Estado al que pasó el objeto. - `old_status` string: Estado en el que estaba el objeto antes del cambio. Es nulo en el primer registro. - `timestamp` string, date-time, required: Fecha y hora en que ocurrió el cambio de estado. - `toku_response_code` string: Código con el que Toku resume cómo terminó la última inscripción del medio de pago. Es nulo cuando la inscripción no dejó un código, por ejemplo en medios cargados masivamente o migrados. - `type` 'card' | 'bank_account' | 'pix' | 'boleto', required: Clase de medio de pago inscrito, que determina qué datos trae el PaymentMethod: `card` una tarjeta, `bank_account` una cuenta bancaria, `pix` una clave Pix y `boleto` un boleto recurrente de Brasil. Cada valor corresponde a una forma distinta del objeto, así que conviene leer el tipo antes que sus campos. - `product_ids` string[], required - `subscription_ids` string[], required - `updated_fields` UpdatedFields: Payload tipado del diff del webhook [``payment_method.updated``](/reference/payment-method-updated). Todos los campos son opcionales — un campo solo está presente cuando efectivamente cambió en la llamada a ``update_payment_method`` que originó el evento. ``DTOUpdatedFieldsV1()`` con todo en ``None`` se serializa como ``{"dto_version": "v1"}`` (con ``exclude_none=True``), por lo que un diff vacío igual produce una forma determinista. - `additional` object - `appended_subscriptions` SubscriptionRef[] - `product_id` string, required - `subscription_id` string, required - `removed_subscriptions` SubscriptionRef[] - `product_id` string, required - `subscription_id` string, required - `status` 'deleted' | 'initialized' | 'chargeable' | 'temporary_failed' | 'permanent_failed' | 'three_ds_required' | 'inscription_failed' | 'pending_activation' | 'manually_chargeable' | 'permanent_deletion_in_progress' | 'permanently_deleted' | 'finished' | 'cancelled' | 'pending_deletion': Estado de un medio de pago dentro de su ciclo de vida, desde que se inscribe hasta que se da de baja. Es lo que decide si se le puede cobrar. Se cobra con `chargeable` y también con `temporary_failed`: este último es un cobro que falló por una causa reintentable, así que el motor de cobranza lo sigue tomando. `permanent_failed` queda fuera, aunque la Organization puede configurar que un porcentaje de ellos se reintente igual. `manually_chargeable` solo entra cuando el cobro se dispara a mano; las corridas automáticas lo saltan. La inscripción pasa por `initialized` mientras Toku la procesa, y queda en `pending_activation` cuando terminó de su lado pero falta la confirmación del banco o del proveedor. Si la inscripción misma falla queda en `inscription_failed`, que ya no vuelve a ser cobrable. La baja tiene dos caminos. El lógico conserva el historial del medio de pago: `pending_deletion` es una eliminación diferida, en espera de que terminen los cobros en curso, y `deleted` es la eliminación ya aplicada. El otro camino borra los datos de la tarjeta en el proveedor al cumplirse el plazo de retención, y avanza de `permanent_deletion_in_progress` a `permanently_deleted` cuando el borrado queda confirmado. `finished` y `cancelled` cierran los cobros recurrentes de Pix en Brasil: el primero es que la serie de cobros se completó y el segundo que se canceló antes de completarse. `three_ds_required` es un estado heredado que ya no se usa. - `transactions` AggregatedTransaction[], required: Transactions que dejó el cobro, con su Customer, sus Payment Intents y el medio de pago usado. - `applied_adjustment_documents` AppliedAdjustmentDocument[], required - `amount` number, required - `external_id` string, required - `id` string, required - `type` union, required - 'credit_note' | 'supplier_invoice': Categoría de un documento de ajuste: `credit_note` es una nota de crédito emitida al Customer, que rebaja lo que debe, y `supplier_invoice` una factura de proveedor que se descuenta al momento del cobro. - string - `customer` DTOCustomerV2 - `email` string - `external_id` string - `government_id` string - `id` string, required - `metadata` object - `name` string - `phone_number` string - `payment_instrument` union - ClPaymentInstrument: Instrumento de pago de Chile - compuesto a partir de DTOs individuales - `card` CardPaymentInstrument - `bin` string - `card_brand` string - `card_holder` string - `card_type` string - `country` string - `exp_month` string - `exp_year` string - `external_id` string - `installments_number` integer - `issuer` string - `last_digits` string - `status` string - `three_d_secure` boolean - `token` string - `cash` CashClPaymentInstrument - `accounting_date` string - `country` string - `due_date` string - `external_id` string - `payment_date` string - `source` string - `country` 'CL' - `id` string - `id_checkout_session` string - `pac_management` PacManagementPaymentInstrument - `country` string - `institution_id` string - `mandate_id` string - `payer_government_id` string - `payer_name` string - `sbif` string - `patpass` PatpassPaymentInstrument - `country` string - `service_id` string - `status` string - `transfer` TransferClPaymentInstrument - `account_number` string - `account_type` string - `country` string - `government_id_match` boolean - `institution_id` string - `payer_government_id` string - `type` 'card' | 'transfer' | 'cash' | 'wallet' | 'pix' | 'pac_management' | 'patpass' | 'account' | 'boleto' | 'referenced_payment' | 'external' | 'in_app_payment', required: Tipo del instrumento con el que se movió el dinero, y por lo tanto qué detalle trae el instrumento. `card` es una tarjeta y `account` la cuenta bancaria del pagador o del receptor: es el valor con el que hoy se registran las transferencias y los débitos automáticos. `transfer`, `pac_management` y `patpass` no se almacenan, se derivan del producto de la transacción, y se mantienen porque las integraciones antiguas esperan verlos. Entre esos dos últimos, `pac_management` es el PAC chileno, que debita una cuenta bancaria con un mandato, y `patpass` el PatPass de Transbank, que debita una tarjeta. Los demás son de un país o un canal: `pix` y `boleto` en Brasil; `cash` es pago en efectivo en un punto de pago; y `wallet`, `referenced_payment` e `in_app_payment` son de México, para billetera digital, pago referenciado en el banco y pago hecho dentro de la aplicación de un tercero. `external` es dinero que se movió fuera de los medios de pago de Toku y se registró para conciliarlo, así que no trae ningún detalle asociado. - MxPaymentInstrument: Instrumento de pago de México - compuesto a partir de DTOs individuales - `account` AccountPaymentInstrument - `account` string - `bank_account_type` string - `bank_id` string - `bin` string - `card_brand` string - `card_type` string - `last_digits` string - `status` string - `token` string - `card` CardPaymentInstrument - `bin` string - `card_brand` string - `card_holder` string - `card_type` string - `country` string - `exp_month` string - `exp_year` string - `external_id` string - `installments_number` integer - `issuer` string - `last_digits` string - `status` string - `three_d_secure` boolean - `token` string - `cash` CashMxPaymentInstrument - `auth_code` string - `barcode_url` string - `expiration_date` string, date-time - `is_recurrent` boolean - `reference` string - `store_name` string - `country` 'MX' - `id` string - `id_checkout_session` string - `referenced_payment` ReferencedPaymentMXInstrument - `agreement_identifier` string - `bank_account_identifier` string - `expiration_date` string, date-time - `fixed_amount` number - `provider` string - `reference` string - `transfer` TransferMxPaymentInstrument - `beneficiary_clabe` string - `codi_folio` string - `payer_clabe` string - `payer_name` string - `tracking_id` string - `transaction_date` string, date-time - `type` 'card' | 'transfer' | 'cash' | 'wallet' | 'pix' | 'pac_management' | 'patpass' | 'account' | 'boleto' | 'referenced_payment' | 'external' | 'in_app_payment', required: Tipo del instrumento con el que se movió el dinero, y por lo tanto qué detalle trae el instrumento. `card` es una tarjeta y `account` la cuenta bancaria del pagador o del receptor: es el valor con el que hoy se registran las transferencias y los débitos automáticos. `transfer`, `pac_management` y `patpass` no se almacenan, se derivan del producto de la transacción, y se mantienen porque las integraciones antiguas esperan verlos. Entre esos dos últimos, `pac_management` es el PAC chileno, que debita una cuenta bancaria con un mandato, y `patpass` el PatPass de Transbank, que debita una tarjeta. Los demás son de un país o un canal: `pix` y `boleto` en Brasil; `cash` es pago en efectivo en un punto de pago; y `wallet`, `referenced_payment` e `in_app_payment` son de México, para billetera digital, pago referenciado en el banco y pago hecho dentro de la aplicación de un tercero. `external` es dinero que se movió fuera de los medios de pago de Toku y se registró para conciliarlo, así que no trae ningún detalle asociado. - `wallet` WalletPaymentInstrument - `company` string, required - `installments_number` integer - BrPaymentInstrument: Instrumento de pago de Brasil - compuesto a partir de DTOs individuales - `boleto` BoletoPaymentInstrument - `address` object - `barcode` string - `barcode_url` string - `customer` object - `expiration_date` string - `fine_amount` string - `interest_amount` string - `pdf_url` string - `typeable_line_number` string - `validity_date` string - `card` CardPaymentInstrument - `bin` string - `card_brand` string - `card_holder` string - `card_type` string - `country` string - `exp_month` string - `exp_year` string - `external_id` string - `installments_number` integer - `issuer` string - `last_digits` string - `status` string - `three_d_secure` boolean - `token` string - `country` 'BR' - `id` string - `id_checkout_session` string - `pix` PixPaymentInstrument - `account_type` string - `bank_ispb` string - `bank_name` string - `copy_paste_code` string - `end_to_end_id` string - `error_code` string - `error_message` string - `expiration_date` string, date-time - `internal_bank_id` string - `issuer` string - `number` string - `pix_automatic` object - `provider_request_id` string - `qr_code` string - `redirect_url` string - `tax_id` string - `total_installments` string - `type` 'card' | 'transfer' | 'cash' | 'wallet' | 'pix' | 'pac_management' | 'patpass' | 'account' | 'boleto' | 'referenced_payment' | 'external' | 'in_app_payment', required: Tipo del instrumento con el que se movió el dinero, y por lo tanto qué detalle trae el instrumento. `card` es una tarjeta y `account` la cuenta bancaria del pagador o del receptor: es el valor con el que hoy se registran las transferencias y los débitos automáticos. `transfer`, `pac_management` y `patpass` no se almacenan, se derivan del producto de la transacción, y se mantienen porque las integraciones antiguas esperan verlos. Entre esos dos últimos, `pac_management` es el PAC chileno, que debita una cuenta bancaria con un mandato, y `patpass` el PatPass de Transbank, que debita una tarjeta. Los demás son de un país o un canal: `pix` y `boleto` en Brasil; `cash` es pago en efectivo en un punto de pago; y `wallet`, `referenced_payment` e `in_app_payment` son de México, para billetera digital, pago referenciado en el banco y pago hecho dentro de la aplicación de un tercero. `external` es dinero que se movió fuera de los medios de pago de Toku y se registró para conciliarlo, así que no trae ningún detalle asociado. - `payment_intents` PaymentIntent[], required - `amount` number, required - `billable_exchange_rate` number - `currency` 'CLP' | 'CLF' | 'MXN' | 'BRL' | 'USD', required: Moneda, en código [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). Cubre las monedas de los países donde Toku opera —`CLP` (peso chileno), `MXN` (peso mexicano) y `BRL` (real)— más `USD` y `CLF`, la Unidad de Fomento chilena. La moneda determina cuántos decimales admiten los montos: `CLP` no admite decimales, `MXN`, `BRL` y `USD` admiten dos, y `CLF` cuatro. - `gateway` 'transbank_oneclick' | 'klap_oneclick' | 'patpass' | 'toku_onetime' | 'toku_pac' | 'fintoc_pac' | 'universo_pac' | 'ecert_pac' | 'external_pac' | 'manual_pac' | 'internal_psp' | 'domiciliation' | 'mx_banco_bbva' | 'mx_banco_bancomer' | 'payment_orchestration' | 'getnet' | 'getnet_pos' | 'transbank' | 'transbank_webpay_plus' | 'khipu_transfer' | 'fintoc_transfer' | 'floid_transfer' | 'toku_transfer' | 'conciliation' | 'pb_transfer_cl_banco_de_chile' | 'pb_transfer_cl_banco_de_chile-evertec' | 'pb_transfer_cl_banco_santander' | 'pb_transfer_cl_banco_santander-evertec' | 'pb_transfer_cl_banco_santander_direct' | 'pb_transfer_cl_banco_santander-native' | 'pb_transfer_cl_banco_scotiabank' | 'pb_transfer_cl_banco_scotiabank_direct' | 'pb_transfer_cl_banco_scotiabank-native' | 'pb_transfer_cl_banco_bci' | 'pb_transfer_cl_banco_bci-native' | 'pb_transfer_cl_banco_bci_direct' | 'pb_transfer_cl_banco_bci-serviex' | 'pb_transfer_cl_banco_itau' | 'pb_transfer_cl_banco_itau-evertec' | 'pb_transfer_cl_banco_estado' | 'pb_transfer_cl_banco_bice' | 'pb_transfer_cl_banco_falabella' | 'arcus_transfer' | 'stp_transfer' | 'cobre_transfer' | 'monex_transfer' | 'oxxo' | 'paycash' | 'dapp' | 'tapi' | 'puntored' | 'cash_pickup' | 'multigateway_onetime' | 'toku_gateways_conekta' | 'toku_gateways_stripe' | 'toku_gateways_mercado_pago' | 'toku_gateways_open_pay' | 'toku_gateways_pay_u' | 'toku_gateways_paypal' | 'toku_gateways_net_pay' | 'po_open_pay' | 'po_rapyd' | 'po_conekta' | 'po_stripe' | 'po_kushki' | 'po_fiserv' | 'po_evo_payments' | 'po_paypal' | 'po_mit' | 'openpay' | 'rapyd' | 'conekta' | 'stripe' | 'kushki' | 'mit' | 'codi_qr' | 'codi' | 'paypal' | 'br_banco_itau' | 'br_banco_itau_boleto' | 'br_banco_bradesco_boleto' | 'br_banco_bradesco_pix' | 'br_sicredi_boleto' | 'servipag' | 'servipag_portal' | 'servipag_caja_presencial' | 'servipag_caja_express' | 'cards_batch_mx_recurring_pst' | 'amex_batch_mx_recurring_pst' | 'braintree' | 'pagarme' | 'br_paulista_servicios_automatic_debit' | 'mx_banco_santander' | 'mx_banco_bbva_bancomer' | 'mx_banco_banorte' | 'mx_banco_banorte_h2h' | 'mx_banco_scotiabank' | 'mx_banco_hsbc' | 'mx_banco_citibanamex' | 'mx_banco_multiva' | 'mx_amex' | 'mx_banco_banbajio' | 'mx_banco_banregio' | 'mx_banco_sabadell' | 'mx_belvo' | 'mx_bbva_cie' | 'internal_balance' | 'fiserv' | 'cielo' | 'belvo' | 'mx_banco_scotiabank_h2h_external' | 'iniciador' | 'qi_tech' | 'evo_payments' | 'cl_banco_de_chile' | 'cl_banco_bci' | 'cl_banco_santander' | 'cl_banco_scotiabank' | 'cl_banco_security' | 'cl_banco_consorcio_fidi' | 'transdata' | 'br_banco_do_brasil' | 'br_banco_santander' | 'br_banco_citibank' | 'rede' | 'mercadopago' | 'br_caixa_via_accesstage' | 'br_banco_de_brasilia' | 'worldpay' | 'br_banco_de_brasilia_via_accesstage' | 'br_santander_via_accesstage' | 'br_bradesco_via_accesstage' | 'br_banco_do_brasil_via_accesstage' | 'br_c6_via_accesstage' | 'br_sicoob_via_accesstage' | 'br_itau_via_accesstage' | 'external_payment' | 'br_sicoob' | 'br_caixa' | 'br_btg' | 'toku_mx_belvo' | 'toku_mx_banco_bbva_bancomer' | 'servipag_button' | 'servipag_cashier' | 'servipag_web' | 'servipag_express' | 'sencillito_cashier' | 'sencillito_web' | 'scotiabank_cashier' | 'unired': Integración por la que se cursa un intento de cobro: el adquirente, banco o recaudador concreto que lo ejecuta. La mayoría de los valores corresponde a una institución de un solo país; el resto son mecanismos propios de Toku, como `internal_psp`, `manual_pac` o `external_payment`. Es el conjunto más amplio de gateways de Toku y crece cada vez que se habilita una institución nueva, así que conviene leerlo como una lista abierta y no agotar sus valores en el código. Para el gateway con que se inscribió un medio de pago, ver `PaymentMethodGateway`. - `id` string, required - `id_account` string, required - `id_invoice` string, required - `id_subscription` string, required - `invoice_external_id` string - `invoice_metadata` object - `is_last_payment` boolean - `is_partial` boolean - `price_change_amount` number, required - `product_id` string, required - `rendition_file` string - `status` 'FAILED' | 'EXPIRED' | 'DELETED' | 'AUTHORIZED' | 'CHARGEBACK' | 'INITIALIZED' | 'PAC_PENDING' | 'PAC_CREATED' | 'CONSTRAINTS_VIOLATED' | 'REFUNDED' | 'ABORTED' | 'INITIALIZED_NON_BLOCKING' | 'REFUND_INITIALIZED' | 'REFUND_FAILED', required: En qué quedó un intento de cobro. Un Payment Intent es el intento de pagar una deuda con un medio de pago, y este campo es su desenlace. Nace `INITIALIZED`. `AUTHORIZED` es el éxito, y significa dinero efectivamente cobrado: es el único estado que suma al monto pagado de la deuda. Un cobro con captura diferida no llega ahí mientras el dinero está solo retenido; el intento sigue `INITIALIZED` hasta que la captura se confirma. Entre las fallas, `FAILED` es que se intentó el cobro y fue rechazado, y `ABORTED` que no hubo resultado porque el intento se canceló o se dio por perdido. Ahí cae un caso que no es evidente: cuando vence el plazo de una sesión de pago o de un enlace, el intento queda `ABORTED`, no `EXPIRED`. `INITIALIZED_NON_BLOCKING` es un intento abierto que no reserva la deuda: la deja cobrable y disponible para otros intentos. Lo usan los cobros contra un comprobante o una referencia, como boleto, Pix, CoDi o Servipag, donde el cliente puede pagar días después y no corresponde bloquear la deuda mientras tanto. `PAC_CREATED` y `PAC_PENDING` son las dos etapas del débito automático chileno: el intento entró en un archivo de cobro ya generado, y después ese archivo se entregó al banco y espera su respuesta, que lo deja en `AUTHORIZED` o `FAILED`. Las reversas no modifican el intento original, se registran como intentos nuevos sobre la misma deuda. `REFUND_INITIALIZED` es una devolución en curso, que termina en `REFUNDED` o en `REFUND_FAILED`; `CHARGEBACK` es un contracargo, que a diferencia de la devolución lo inicia el tarjetahabiente o su banco. `REFUNDED` y `CHARGEBACK` restan del monto pagado de la deuda. `DELETED` marca un intento eliminado, que no cuenta para nada. `EXPIRED` y `CONSTRAINTS_VIOLATED` son estados heredados: ningún proceso los escribe hoy y solo aparecen en datos antiguos. - `type` 'recurring' | 'one_time': Si el intento de cobro nace de un cobro recurrente sobre un medio de pago ya inscrito (`recurring`) o de un pago puntual que el pagador inicia en el momento (`one_time`). - `transaction` Transaction, required: Intento de cobro sobre un medio de pago, con su resultado. Queda una Transaction cada vez que Toku mueve dinero o intenta moverlo: un cobro pedido por API, un pago hecho en el portal de Toku, un pago que el deudor hizo por fuera y que se registra, o la reversa de cualquiera de ellos. Los intentos fallidos también quedan registrados. Se crea al iniciar el cobro, cuando todavía no se conoce el resultado; es la finalización la que lo define. Recién ahí se saldan las Invoices que la Transaction cubre y se avisa el desenlace por webhook. - `additional_data` object: Información complementaria del movimiento, como el detalle de la devolución cuando la Transaction fue devuelta. - `amount` number, required: Monto del movimiento, expresado en la moneda de `currency`. - `currency` 'CLP' | 'CLF' | 'MXN' | 'BRL' | 'USD', required: Moneda, en código [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). Cubre las monedas de los países donde Toku opera —`CLP` (peso chileno), `MXN` (peso mexicano) y `BRL` (real)— más `USD` y `CLF`, la Unidad de Fomento chilena. La moneda determina cuántos decimales admiten los montos: `CLP` no admite decimales, `MXN`, `BRL` y `USD` admiten dos, y `CLF` cuatro. - `expiration_date` string: Fecha y hora, en formato [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) y en UTC, hasta la que la Transaction puede resolverse. Si vence sin resolverse queda `ABORTED`; en una autorización diferida es el plazo hasta el que se puede capturar. Es nulo cuando la Transaction no tiene vencimiento. - `external_id` string: Identificador que entrega la organización para reconocer la Transaction en sus propios sistemas. - `gateway` string: Procesador con el que se cursó el movimiento. - `id` string, required: Identificador único de la Transaction. - `id_account` string: Cuenta de cobro de la organización a la que se imputa el movimiento. - `id_charge_scheduled_date` string: Identificador de la fecha de cobro programada (charge scheduled date) que originó la Transaction, es decir, la que la mandó a cobro. Es nulo cuando la Transaction no nació de una fecha de cobro programada. - `id_checkout_session` string: Checkout Session desde la que se originó el cobro. Es nulo cuando el cobro no partió de un checkout. - `id_organization` string: Organización dueña de la Transaction. - `id_payout` string: Payout con el que se le liquidó a la organización el dinero de esta Transaction. Es nulo mientras no se haya liquidado. - `initialization_date` string: Fecha y hora, en formato [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) y en UTC, en que se creó la Transaction. Se distingue de `transaction_date`, que es la fecha del movimiento de dinero. - `installment_amount` number: Monto de cada mensualidad, en la moneda de la Transaction. - `number_of_installments` integer: Cantidad de mensualidades en que se pactó el cobro. En México corresponde a los meses sin intereses acordados con el tarjetahabiente. Un cobro en un solo pago reporta `1`. - `original_response_message` string: Mensaje con el que el procesador respondió al cobro, tal cual lo entregó. Es nulo cuando no alcanzó a haber respuesta del procesador. - `provider_external_id` string: Identificador con el que el procesador reconoce el cobro. En los productos que se pagan con una referencia, como Pago Directo BBVA, es la referencia con que pagó el cliente final. Es nulo cuando el procesador no entrega un identificador propio. - `remediation_detail` string: Motivo con el que se remedió la Transaction, cuando un cobro que había fallado se rehízo y terminó bien. Es nulo cuando no hubo remediación. - `response_code` string: Código de resultado del cobro, normalizado por Toku a partir de la respuesta del procesador. Se compone de la gravedad (`SU` éxito, `TE` temporal, `PE` permanente, `UE` desconocido), tres letras que identifican la fuente y cuatro dígitos de detalle: `0000` cuando el cobro resultó exitoso y `9999` cuando la respuesta no se pudo clasificar. El listado completo está en [Códigos de pago rechazado](/reference/codigos-de-pago-rechazado). Es nulo mientras el cobro no se resuelve y en los movimientos que no pasan por un procesador, como los pagos registrados por fuera y los contracargos. - `status` 'INITIALIZED' | 'SUCCESS' | 'FAILED' | 'FAILED_INIT' | 'ABORTED' | 'CAPTURE_PENDING', required: Estado de una Transaction. `INITIALIZED` es el intento ya creado y todavía sin resolver; `SUCCESS` y `FAILED` son sus dos desenlaces, y `ABORTED` es el intento cancelado antes de resolverse, ya sea por una cancelación explícita o porque venció su plazo de expiración. `CAPTURE_PENDING` solo aparece en los cobros con captura diferida: el monto quedó autorizado y espera la captura, que lo lleva a `SUCCESS`. `FAILED_INIT` está deprecado: ninguna Transaction nueva lo alcanza y solo sobrevive en registros históricos. - `status_history` StatusHistory[]: Cambios de estado por los que pasó la Transaction, en el orden en que ocurrieron. - `new_status` string, required: Estado al que pasó el objeto. - `old_status` string: Estado en el que estaba el objeto antes del cambio. Es nulo en el primer registro. - `timestamp` string, date-time, required: Fecha y hora en que ocurrió el cambio de estado. - `toku_product` string: Producto de Toku con el que se cobró, que determina el medio de pago usado, por ejemplo `toku_card_on_file` o `transfer_cl`. - `transaction_date` string, required: Fecha y hora, en formato [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) y en UTC, en que se realizó el movimiento de dinero. - `transaction_metadata` object, required: Datos con los que Toku caracteriza el cobro, como el tipo de tarjeta con la que se pagó. Las claves dependen del medio de pago usado. - `type` 'ONETIME' | 'INSCRIPTION' | 'INSCRIPTION_REVERSED' | 'CARD_ON_FILE_PAYMENT' | 'CARDLESS_PAYMENT' | 'PATPASS_PAYMENT' | 'REVERSED' | 'VOID' | 'PAYMENT' | 'CHARGEBACK' | 'EXTERNAL_PAYMENT' | 'CHARGEBACK_REVERSAL', required: Naturaleza de la operación que representa una Transaction. Distingue los cobros (`PAYMENT`, `ONETIME`, `CARD_ON_FILE_PAYMENT`, `CARDLESS_PAYMENT`, `PATPASS_PAYMENT`) de las operaciones que no mueven dinero del pagador, como `INSCRIPTION`, que solo inscribe un medio de pago, y de las que revierten una operación previa (`REVERSED`, `VOID`, `INSCRIPTION_REVERSED`, `CHARGEBACK`, `CHARGEBACK_REVERSAL`). `EXTERNAL_PAYMENT` corresponde a un pago que no procesó Toku y que se registra para dejar saldadas sus Invoices: nace directamente en estado `SUCCESS`. - `voucher` string: Comprobante del cobro que entrega el procesador. Es nulo cuando el procesador no entrega uno. - `wallet_movements` WalletMovement[], required - `amount` number, required - `id` string, required - `type` string, required ## Other responses - `400`: Los medios de pago enviados mezclan Transbank OneClick con medios que se cobran por orquestación, traen más de un medio Transbank OneClick, o ninguno de ellos existe. `actions-or-orchestration-tree-required`: un cobro que no es Transbank OneClick llegó sin `actions`. En un lote, basta un cobro así para rechazar el lote completo antes de cobrar ninguno. - `401`: La Account, alguno de los Invoices, alguno de los medios de pago o el instrumento de pago no pertenece a la Organization autenticada. - `403`: No tienes acceso a este recurso. - `404`: El recurso solicitado no existe. - `422`: El cuerpo de la petición no pasó la validación. - `429`: Se superó el límite de peticiones permitidas. --- [API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)