--- title: "Obtener datos de devolución de Transaction" method: GET path: "/refund/transaction" tags: ["Refunds"] --- # Obtener datos de devolución de Transaction `GET /refund/transaction` ## Request - Base URL: `https://api.trytoku.com` - URL: `https://api.trytoku.com/refund/transaction` - Auth: API key in header `x-api-key` Devuelve los antecedentes que determinan si una Transaction admite devolución. Se usa antes de pedir una devolución, para saber si el gateway del pago las acepta, hasta cuándo, y cuánto del pago ya fue devuelto. Cuando el gateway del pago no admite devoluciones para ese producto, la respuesta llega con `gateway_refund_config` en `null` y `refund_payment_intents` vacío. La configuración también llega deshabilitada cuando el pago se devuelve por lote y la Account no tiene ese flujo activo, o cuando es un pago por transferencia o PAC en Chile y la organización no tiene habilitadas esas devoluciones. El plazo (`refund_expiration_days`) sale de la política de devoluciones (`REFUND_POLICY_CONFIG`): la de la organización para pagos con tarjeta de un solo cobro y con wallet, y la por defecto para el resto. Es el del producto del pago cuando su gateway tiene uno propio para él, si no el del gateway. Un gateway sin plazo en la política llega con `gateway_refund_config` en `null`. En los pagos por transferencia o PAC en Chile, la devolución se deposita en la cuenta desde la que pagó el pagador: `payer_data_available` indica si Toku tiene sus datos. ## Query parameters - `id_transaction` string, required: Identificador de la Transaction a consultar. ## Response `200` Successful Response - TransactionDataForRefundResponse: Antecedentes que Toku necesita para decidir si una Transaction admite devolución. - `allows_multiple_partial_refunds` boolean, required: Indica si la organización y el producto del pago admiten varias devoluciones parciales sobre la misma Invoice. - `gateway_refund_config` GatewayRefundConfigResponse: Configuración de devoluciones de un gateway de pago. Define si Toku admite devoluciones por ese gateway y hasta cuándo. - `enabled` boolean, required: Indica si las devoluciones por este gateway están habilitadas. - `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' | 'br_santander_brasil_via_accesstage' | 'br_sudameris_via_accesstage' | 'br_abn_via_accesstage' | 'br_inter_via_accesstage' | 'br_hsbc_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', required: 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`. - `refund_expiration_days` integer, required: Plazo, en días, configurado para devolver un pago hecho con este gateway. - `id_transaction` string, required: Identificador de la Transaction consultada. - `payer_data_available` boolean, required: Indica si Toku tiene los datos de la cuenta de origen del pagador, a la que se deposita la devolución en los pagos por transferencia o PAC en Chile. Cuando llega en `false`, la devolución será rechazada. En los demás productos siempre llega en `true`. - `refund_in_progress_amount` number, required: Monto de las devoluciones iniciadas que todavía no se cierran. Ya consume saldo del pago aunque aún no figure como devuelto. - `refund_payment_intents` RefundPaymentIntentResponse[]: Devoluciones ya registradas sobre esta Transaction. Permite calcular cuánto del pago sigue disponible para devolver. - `amount` number, required: Monto devuelto en este Payment Intent. - `id_invoice` string, required: Identificador de la Invoice sobre la que se aplicó la devolución. - `id_payment_intent` string, required: Identificador del Payment Intent de la devolución. - `id_transaction` string, required: Identificador de la Transaction asociada al Payment Intent. - `status` string, required: Estado del Payment Intent de la devolución. - `refundable_amount` number, required: Saldo del pago que todavía se puede devolver, descontando lo devuelto y lo que está en curso. - `refunded_amount` number, required: Monto del pago que ya fue devuelto: suma de las devoluciones cerradas con éxito. ## Other responses - `404`: La Transaction indicada no existe. - `422`: Los parámetros de la consulta no pasaron la validación. ## Changes - **2026-11-03** `a6ef070075b1`: 1 info - endpoint added [Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/refund/transaction/get.md) --- [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)