Toku Refunds API

openapi: 3.2.0
info:
  title: Recursos secundarios Refunds API
  version: 1.0.0
  description: Devoluciones de dinero sobre un pago ya realizado. Toku registra cada devolución como una Transaction propia de tipo `REVERSED`, ligada al pago original, y la aplica sobre las Invoices que ese pago había saldado.
servers:
- description: Production
  url: https://api.trytoku.com
security:
- ApiKeyAuth: []
tags:
- description: Devoluciones de dinero sobre un pago ya realizado. Toku registra cada devolución como una Transaction propia de tipo `REVERSED`, ligada al pago original, y la aplica sobre las Invoices que ese pago había saldado.
  name: Refunds
paths:
  /refund/invoice:
    post:
      description: 'Devuelve el dinero con que se pagó una deuda, total o parcialmente.


        Se usa cuando el punto de partida es la Invoice y no el pago: Toku busca el pago que la saldó y crea la devolución sobre esa Transaction.


        Solo aplica a Invoices saldadas en un único pago. Si la Invoice fue pagada en más de una Transaction, la petición es rechazada y la devolución debe pedirse sobre la Transaction.


        Si el pago que saldó la Invoice es con tarjeta de un solo cobro (`payment_orchestration_onetime`) o con wallet (`wallet_mx`) y es más antiguo que su plazo de devolución, la petición es rechazada con estado 400 antes de contactar al gateway.


        Si se omite `refund_amount`, se devuelve el monto total del pago que saldó la Invoice.


        Sin `idempotency_key`, cada llamada crea una devolución nueva y las parciales se acumulan sobre el mismo pago, así que reenviar la misma petición vuelve a devolver el monto mientras quede saldo; cuando ya no queda, la petición es rechazada con estado 400. Reenviar la petición con la misma `idempotency_key` devuelve la respuesta original, con el header `Idempotent-Replayed`, sin crear otra devolución.'
      operationId: refund_invoice_public
      parameters:
      - description: Llave de API de una Account, para operar sobre esa Account en lugar de la principal.
        in: header
        name: x-account-key
        required: false
        schema:
          default: ''
          title: X-Account-Key
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RefundInvoicePublicInterface'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicRefundResponse'
          description: Successful Response
          headers:
            Idempotent-Replayed:
              description: Llega en `true` cuando la respuesta es la guardada para la `idempotency_key` y no se creó otra devolución.
              schema:
                type: string
        '400':
          description: 'La Invoice fue pagada en más de una Transaction: en ese caso la devolución se pide sobre la Transaction, no sobre la Invoice. La petición también es rechazada cuando el pago que la saldó, con tarjeta de un solo cobro o con wallet, es más antiguo que su plazo de devolución o, si es por transferencia o PAC en Chile, cuando no tenemos los datos de la cuenta de origen del pagador.'
        '403':
          description: La Invoice pertenece a otra organización, o el gateway del pago no tiene habilitadas las devoluciones para tu organización.
        '404':
          description: La Invoice indicada no existe, o no tiene ningún pago que devolver.
        '409':
          description: El pago tiene otra devolución en curso y no se pudo procesar esta; se puede reintentar en unos segundos.
        '422':
          description: El cuerpo de la petición no pasó la validación.
      summary: Crear Refund de Invoice
      tags:
      - Refunds
  /refund/transaction:
    get:
      description: '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.'
      operationId: get_transaction_data_for_refund
      parameters:
      - description: Identificador de la Transaction a consultar.
        in: query
        name: id_transaction
        required: true
        schema:
          description: Identificador de la Transaction a consultar.
          example: trs_pBf2NL0d0gvBM7Ei_1E3HIWnTN4W93_O
          title: Id Transaction
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDataForRefundResponse'
          description: Successful Response
        '404':
          description: La Transaction indicada no existe.
        '422':
          description: Los parámetros de la consulta no pasaron la validación.
      summary: Obtener datos de devolución de Transaction
      tags:
      - Refunds
    post:
      description: 'Devuelve el dinero de un pago, total o parcialmente.


        Se usa para reversar un pago ya cobrado. Toku registra la devolución como una Transaction propia de tipo `REVERSED`, ligada al pago original, y la aplica sobre las Invoices que ese pago había saldado.


        Si se omite `refund_amount`, se devuelve el monto total del pago. Para devolver solo una parte, indica el monto; y si el pago saldó varias Invoices, usa `invoice_refund_details` para precisar cuánto corresponde a cada una.


        Sin `idempotency_key`, cada llamada crea una devolución nueva y las parciales se acumulan sobre el mismo pago, así que reenviar la misma petición vuelve a devolver el monto mientras quede saldo; cuando ya no queda, la petición es rechazada con estado 400. Reenviar la petición con la misma `idempotency_key` devuelve la respuesta original, con el header `Idempotent-Replayed`, sin crear otra devolución.


        Cuando la devolución se envía al gateway en línea, la respuesta ya trae el desenlace y el comprobante. En los productos que se devuelven por lote o de forma asíncrona, `success` llega en `false` con `error` en `null`: la devolución quedó iniciada y el gateway la confirma después.


        Un pago con tarjeta de un solo cobro (`payment_orchestration_onetime`) o con wallet (`wallet_mx`) más antiguo que su plazo de devolución es rechazado con estado 400 antes de contactar al gateway.'
      operationId: refund_transaction_public
      parameters:
      - description: Llave de API de una Account, para operar sobre esa Account en lugar de la principal.
        in: header
        name: x-account-key
        required: false
        schema:
          default: ''
          title: X-Account-Key
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RefundTransactionPublicInterface'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicRefundResponse'
          description: Successful Response
          headers:
            Idempotent-Replayed:
              description: Llega en `true` cuando la respuesta es la guardada para la `idempotency_key` y no se creó otra devolución.
              schema:
                type: string
        '400':
          description: 'La Transaction no admite la devolución: su gateway no admite devoluciones, no es reembolsable, el monto no es válido —por ejemplo, excede lo que queda por devolver—, la devolución parcial requiere anular las deudas asociadas o, en pagos por transferencia o PAC en Chile, no tenemos los datos de la cuenta de origen del pagador. La petición también es rechazada cuando un pago con tarjeta de un solo cobro o con wallet es más antiguo que su plazo de devolución.'
        '403':
          description: La Transaction pertenece a otra organización, o su gateway no tiene habilitadas las devoluciones para tu organización.
        '404':
          description: La Transaction indicada no existe.
        '409':
          description: El pago tiene otra devolución en curso y no se pudo procesar esta; se puede reintentar en unos segundos.
        '422':
          description: El cuerpo de la petición no pasó la validación.
      summary: Crear Refund de Transaction
      tags:
      - Refunds
components:
  schemas:
    RefundTransactionPublicInterface:
      description: Solicitud de devolución sobre una Transaction.
      properties:
        disable_automatic_payments:
          default: false
          description: Indica si se deshabilita el cobro automático de las Invoices asociadas a la Transaction.
          title: Disable Automatic Payments
          type: boolean
        id_transaction:
          description: Identificador de la Transaction a devolver.
          example: trs_pBf2NL0d0gvBM7Ei_1E3HIWnTN4W93_O
          title: Id Transaction
          type: string
        idempotency_key:
          description: Llave para reintentar la devolución sin duplicarla; usa una distinta por cada devolución. Si se repite, se devuelve la respuesta original sin crear otra devolución, aunque cambie el cuerpo; si la petición original falló, el reintento responde con error sin volver a procesarla. La respuesta se conserva 24 horas.
          example: 5f1c2e0a-8d3b-4c1e-9a7f-2b6d4e8c1a90
          title: Idempotency Key
          type: string
        invoice_refund_details:
          description: Detalle de cuánto devolver por cada Invoice. Si se omite, la devolución se aplica sobre las Invoices que la Transaction había saldado.
          items:
            $ref: '#/components/schemas/InvoiceRefundDetails'
          title: Invoice Refund Details
          type: array
        mark_invoices_as_unpaid:
          default: true
          description: Indica si las Invoices quedan marcadas como no pagadas tras la devolución. Se envía en `false` al devolver un pago duplicado, para que la deuda no vuelva a quedar pendiente.
          title: Mark Invoices As Unpaid
          type: boolean
        reason:
          description: Motivo de la devolución.
          title: Reason
          type: string
        refund_amount:
          description: Monto a devolver. Si se omite, se devuelve el monto total de la Transaction; cuando viene `invoice_refund_details`, se devuelve la suma de los montos indicados ahí.
          title: Refund Amount
          type: number
        void_invoices:
          default: false
          description: Indica si las Invoices asociadas a la Transaction quedan anuladas tras la devolución.
          title: Void Invoices
          type: boolean
      required:
      - id_transaction
      - reason
      title: RefundTransactionPublicInterface
      type: object
    PublicRefundResponse:
      description: Resultado de una devolución solicitada a través del API pública.
      properties:
        additional_data:
          description: Datos que devolvió el gateway. En las devoluciones que se envían al gateway en línea trae el detalle de su respuesta; en los flujos por lote y asíncronos llega vacío.
          title: Additional Data
          type: object
        error:
          description: Motivo por el que la devolución no pudo cerrarse. Llega en `null` cuando no hubo error.
          title: Error
          type: string
        id:
          description: Identificador de la Transaction `REVERSED` creada para esta devolución.
          example: trs_pBf2NL0d0gvBM7Ei_1E3HIWnTN4W93_O
          title: Id
          type: string
        receipt_url:
          description: URL del comprobante de la devolución. Se emite en las devoluciones que se envían al gateway en línea y quedaron exitosas; en los flujos por lote y asíncronos llega en `null`.
          title: Receipt Url
          type: string
        success:
          description: Indica si la devolución quedó cerrada correctamente. En los productos de devolución asíncrona llega en `false` con `error` en `null`, porque la confirmación del gateway se recibe más tarde.
          title: Success
          type: boolean
      required:
      - id
      - success
      title: PublicRefundResponse
      type: object
    RefundInvoicePublicInterface:
      description: Solicitud de devolución sobre una Invoice.
      properties:
        disable_automatic_payments:
          default: false
          description: Indica si se deshabilita el cobro automático de la Invoice tras la devolución.
          title: Disable Automatic Payments
          type: boolean
        id_invoice:
          description: Identificador de la Invoice a devolver.
          example: in_pBf2NL0d0gvBM7Ei_1E3HIWnTN4W93_O
          title: Id Invoice
          type: string
        idempotency_key:
          description: Llave para reintentar la devolución sin duplicarla; usa una distinta por cada devolución. Si se repite, se devuelve la respuesta original sin crear otra devolución, aunque cambie el cuerpo; si la petición original falló, el reintento responde con error sin volver a procesarla. La respuesta se conserva 24 horas.
          example: 5f1c2e0a-8d3b-4c1e-9a7f-2b6d4e8c1a90
          title: Idempotency Key
          type: string
        reason:
          description: Motivo de la devolución.
          title: Reason
          type: string
        refund_amount:
          description: Monto a devolver. Si se omite, se devuelve el monto total de la Transaction que pagó la Invoice.
          title: Refund Amount
          type: number
        void_invoice:
          default: false
          description: Indica si la Invoice queda anulada tras la devolución.
          title: Void Invoice
          type: boolean
      required:
      - id_invoice
      - reason
      title: RefundInvoicePublicInterface
      type: object
    InvoiceRefundDetails:
      description: Monto a devolver sobre una Invoice puntual saldada por la Transaction.
      properties:
        id_invoice:
          description: Identificador de la Invoice a devolver.
          example: in_pBf2NL0d0gvBM7Ei_1E3HIWnTN4W93_O
          title: Id Invoice
          type: string
        refund_amount:
          description: Monto a devolver sobre esta Invoice. Si se omite, Toku toma el monto total de la devolución para esta Invoice.
          title: Refund Amount
          type: number
      required:
      - id_invoice
      title: InvoiceRefundDetails
      type: object
    TransactionDataForRefundResponse:
      description: Antecedentes que Toku necesita para decidir si una Transaction admite devolución.
      properties:
        allows_multiple_partial_refunds:
          description: Indica si la organización y el producto del pago admiten varias devoluciones parciales sobre la misma Invoice.
          title: Allows Multiple Partial Refunds
          type: boolean
        gateway_refund_config:
          allOf:
          - $ref: '#/components/schemas/GatewayRefundConfigResponse'
          description: Configuración de devoluciones del gateway con que se pagó la Transaction. Llega en `null` cuando el gateway no admite devoluciones para el producto de la Transaction o cuando no hay configuración registrada.
          title: Gateway Refund Config
        id_transaction:
          description: Identificador de la Transaction consultada.
          example: trs_pBf2NL0d0gvBM7Ei_1E3HIWnTN4W93_O
          title: Id Transaction
          type: string
        payer_data_available:
          description: 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`.
          title: Payer Data Available
          type: boolean
        refund_in_progress_amount:
          description: Monto de las devoluciones iniciadas que todavía no se cierran. Ya consume saldo del pago aunque aún no figure como devuelto.
          title: Refund In Progress Amount
          type: number
        refund_payment_intents:
          description: Devoluciones ya registradas sobre esta Transaction. Permite calcular cuánto del pago sigue disponible para devolver.
          items:
            $ref: '#/components/schemas/RefundPaymentIntentResponse'
          title: Refund Payment Intents
          type: array
        refundable_amount:
          description: Saldo del pago que todavía se puede devolver, descontando lo devuelto y lo que está en curso.
          title: Refundable Amount
          type: number
        refunded_amount:
          description: 'Monto del pago que ya fue devuelto: suma de las devoluciones cerradas con éxito.'
          title: Refunded Amount
          type: number
      required:
      - id_transaction
      - refunded_amount
      - refund_in_progress_amount
      - refundable_amount
      - allows_multiple_partial_refunds
      - payer_data_available
      title: TransactionDataForRefundResponse
      type: object
    GatewayRefundConfigResponse:
      description: 'Configuración de devoluciones de un gateway de pago.


        Define si Toku admite devoluciones por ese gateway y hasta cuándo.'
      properties:
        enabled:
          description: Indica si las devoluciones por este gateway están habilitadas.
          title: Enabled
          type: boolean
        gateway:
          allOf:
          - $ref: '#/components/schemas/ApiRefund_PaymentIntentGateway'
          description: Gateway de pago al que aplica la configuración.
        refund_expiration_days:
          description: Plazo, en días, configurado para devolver un pago hecho con este gateway.
          title: Refund Expiration Days
          type: integer
      required:
      - gateway
      - refund_expiration_days
      - enabled
      title: GatewayRefundConfigResponse
      type: object
    ApiRefund_PaymentIntentGateway:
      description: '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`.'
      enum:
      - 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
      title: ApiRefund_PaymentIntentGateway
      type: string
    RefundPaymentIntentResponse:
      description: Payment Intent generado por una devolución ya registrada sobre el pago consultado.
      properties:
        amount:
          description: Monto devuelto en este Payment Intent.
          title: Amount
          type: number
        id_invoice:
          description: Identificador de la Invoice sobre la que se aplicó la devolución.
          example: in_pBf2NL0d0gvBM7Ei_1E3HIWnTN4W93_O
          title: Id Invoice
          type: string
        id_payment_intent:
          description: Identificador del Payment Intent de la devolución.
          example: pi_pBf2NL0d0gvBM7Ei_1E3HIWnTN4W93_O
          title: Id Payment Intent
          type: string
        id_transaction:
          description: Identificador de la Transaction asociada al Payment Intent.
          example: trs_pBf2NL0d0gvBM7Ei_1E3HIWnTN4W93_O
          title: Id Transaction
          type: string
        status:
          description: Estado del Payment Intent de la devolución.
          title: Status
          type: string
      required:
      - id_payment_intent
      - id_invoice
      - id_transaction
      - amount
      - status
      title: RefundPaymentIntentResponse
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: Toku public API key. Send it in the x-api-key header on every request.
      in: header
      name: x-api-key
      type: apiKey
x-toku-api-version: '2026-10-08'
x-toku-dto-versions:
  DTOAccountPaymentInstrument: DTOAccountPaymentInstrumentV1
  DTOAggregatedPaymentMethod: DTOAggregatedPaymentMethodV2
  DTOAggregatedTransaction: DTOAggregatedTransactionV2
  DTOBankAccountPaymentMethod: DTOBankAccountPaymentMethodV1
  DTOBoletoPaymentInstrument: DTOBoletoPaymentInstrumentV2
  DTOBrPaymentInstrument: DTOBrPaymentInstrumentV2
  DTOCardPaymentInstrument: DTOCardPaymentInstrumentV1
  DTOCardPaymentMethod: DTOCardPaymentMethodV1
  DTOCashClPaymentInstrument: DTOCashClPaymentInstrumentV1
  DTOCashMxPaymentInstrument: DTOCashMxPaymentInstrumentV1
  DTOClPaymentInstrument: DTOClPaymentInstrumentV2
  DTOCustomer: DTOCustomerV2
  DTOInvoice: DTOInvoiceV4
  DTOMxPaymentInstrument: DTOMxPaymentInstrumentV3
  DTOPacManagementPaymentInstrument: DTOPacManagementPaymentInstrumentV1
  DTOPatpassPaymentInstrument: DTOPatpassPaymentInstrumentV1
  DTOPaymentIntent: DTOPaymentIntentV5
  DTOPaymentMethod: DTOPaymentMethodV7
  DTOPixPaymentInstrument: DTOPixPaymentInstrumentV1
  DTOPixPaymentMethod: DTOPixPaymentMethodV1
  DTOReferencedPaymentMXInstrument: DTOReferencedPaymentMXInstrumentV1
  DTOTransaction: DTOTransactionV10
  DTOTransferClPaymentInstrument: DTOTransferClPaymentInstrumentV2
  DTOTransferMxPaymentInstrument: DTOTransferMxPaymentInstrumentV1
  DTOUpdatedFields: DTOUpdatedFieldsV1
  DTOWalletMovement: DTOWalletMovementV1
  DTOWalletPaymentInstrument: DTOWalletPaymentInstrumentV2
x-toku-schema-names:
  ApiPaymentMethod_AssociatePaymentMethodResponse: AssociatePaymentMethodResponse
  ApiPaymentMethod_DTOPaymentMethodV7: PaymentMethod
  ApiPaymentTransaction_DTOTransactionV10: Transaction
  ApiPaymentTransaction_TransactionStatus: TransactionStatus
  ApiRenditionFile_BusinessDaysBeforeFilter: BusinessDaysBeforeFilter
  ApiRenditionFile_DaysBeforeFilter: DaysBeforeFilter
  ApiRenditionFile_DueDatesDaysFutureFilter: DueDatesDaysFutureFilter
  ApiRenditionFile_EntityRestrictions: EntityRestrictions
  ApiRenditionFile_NewestNInvoicesFilter: NewestNInvoicesFilter
  ApiRenditionFile_OldestNInvoicesFilter: OldestNInvoicesFilter
  CheckoutApi_AccountDetailsResponse: AccountDetailsResponse
  CheckoutApi_CheckoutSessionResponse: CheckoutSession
  ClientPaymentPortalBackend_CheckoutSessionResponse: CheckoutSessionResponse
  CollectionStrategist_InstitutionId: InstitutionId
  CollectionStrategist_SubTreeConfiguration: SubTreeConfiguration
  DTOAccountPaymentInstrumentV1: AccountPaymentInstrument
  DTOAggregatedTransactionV2: AggregatedTransaction
  DTOAppliedAdjustmentDocumentV1: AppliedAdjustmentDocument
  DTOBoletoPaymentInstrumentV2: BoletoPaymentInstrument
  DTOBrPaymentInstrumentV2: BrPaymentInstrument
  DTOCardPaymentInstrumentV1: CardPaymentInstrument
  DTOCardPaymentMethodV1: CardPaymentMethod
  DTOCashClPaymentInstrumentV1: CashClPaymentInstrument
  DTOCashMxPaymentInstrumentV1: CashMxPaymentInstrument
  DTOClPaymentInstrumentV2: ClPaymentInstrument
  DTOInvoiceV4: Invoice
  DTOMxPaymentInstrumentV3: MxPaymentInstrument
  DTOPacManagementPaymentInstrumentV1: PacManagementPaymentInstrument
  DTOPatpassPaymentInstrumentV1: PatpassPaymentInstrument
  DTOPaymentIntentV5: PaymentIntent
  DTOPixPaymentInstrumentV1: PixPaymentInstrument
  DTOPixPaymentMethodV1: PixPaymentMethod
  DTOReferencedPaymentMXInstrumentV1: ReferencedPaymentMXInstrument
  DTOTransferClPaymentInstrumentV2: TransferClPaymentInstrument
  DTOTransferMxPaymentInstrumentV1: TransferMxPaymentInstrument
  DTOUpdatedFieldsV1: UpdatedFields
  DTOWalletMovementV1: WalletMovement
  DTOWalletPaymentInstrumentV2: WalletPaymentInstrument
  GetCustomerResponse: Customer
  GetSubscriptionResponse: Subscription
  PayoutsBeneficiaryService_ApprovalFlowsStatus: ApprovalFlowsStatus
  PayoutsBeneficiaryService_Beneficiary: Beneficiary
  PayoutsBeneficiaryService_BeneficiaryAccount: BeneficiaryAccount
  PayoutsBeneficiaryService_BeneficiaryAccountVerification: BeneficiaryAccountVerification
  PayoutsBeneficiaryService_IdentityDocument: IdentityDocument
  PayoutsBeneficiaryService_VerificationStatus: VerificationStatus
  PayoutsDataIngestionService_DisbursementType: DisbursementType
  WebhookEndpointResponse: WebhookEndpoint
x-provenance:
  method: searched
  source: https://docs.trytoku.com/reference
  harvested: '2026-10-29'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.trytoku.com/reference/associate_subscription.md
  - https://docs.trytoku.com/reference/associate_subscription_bulk.md
  - https://docs.trytoku.com/reference/bulk_inscriptions_public.md
  - https://docs.trytoku.com/reference/cancel_billing_document.md
  - https://docs.trytoku.com/reference/cancel_preauth_endpoint.md
  - https://docs.trytoku.com/reference/capture_preauth_endpoint.md
  - https://docs.trytoku.com/reference/change_subscription_status.md
  - https://docs.trytoku.com/reference/create_adjustment_document.md
  - https://docs.trytoku.com/reference/create_beneficiaries.md
  - https://docs.trytoku.com/reference/create_bulk_automatic_debit_payment_methods.md
  - https://docs.trytoku.com/reference/create_credit_note.md
  - https://docs.trytoku.com/reference/create_customer.md
  - https://docs.trytoku.com/reference/create_customer_billing_data.md
  - https://docs.trytoku.com/reference/create_customer_billing_data_bulk.md
  - https://docs.trytoku.com/reference/create_document.md
  - https://docs.trytoku.com/reference/create_external_transaction.md
  - https://docs.trytoku.com/reference/create_external_transactions.md
  - https://docs.trytoku.com/reference/create_handler.md
  - https://docs.trytoku.com/reference/create_intent.md
  - https://docs.trytoku.com/reference/create_invoice_billing_data.md
  - https://docs.trytoku.com/reference/create_m2m_access_token.md
  - https://docs.trytoku.com/reference/create_or_update_invoice.md
  - https://docs.trytoku.com/reference/create_or_update_subscription.md
  - https://docs.trytoku.com/reference/create_pacs.md
  - https://docs.trytoku.com/reference/create_pix_automatic_configuration.md
  - https://docs.trytoku.com/reference/create_ppd_billing_document.md
  - https://docs.trytoku.com/reference/create_ppd_complement_billing_document.md
  - https://docs.trytoku.com/reference/create_ppd_complement_from_wallet_movement_billing_document.md
  - https://docs.trytoku.com/reference/create_public_validator_execution.md
  - https://docs.trytoku.com/reference/create_pue_billing_document.md
  - https://docs.trytoku.com/reference/create_receipt.md
  - https://docs.trytoku.com/reference/create_referenced_payment_mx_reference_endpoint.md
  - https://docs.trytoku.com/reference/create_terminal.md
  - https://docs.trytoku.com/reference/create_transfer_clabe_account.md
  - https://docs.trytoku.com/reference/create_webhook_endpoint.md
  - https://docs.trytoku.com/reference/delete_customer.md
  - https://docs.trytoku.com/reference/delete_customer_collection_account_endpoint.md
  - https://docs.trytoku.com/reference/delete_external_transaction.md
  - https://docs.trytoku.com/reference/delete_external_transactions.md
  - https://docs.trytoku.com/reference/delete_invoice.md
  - https://docs.trytoku.com/reference/delete_pacs.md
  - https://docs.trytoku.com/reference/delete_payment_method.md
  - https://docs.trytoku.com/reference/delete_subscription.md
  - https://docs.trytoku.com/reference/delete_terminal.md
  - https://docs.trytoku.com/reference/download_pdf_for_transaction.md


# --- truncated at 32 KB (37 KB total) ---
# Full source: https://artifacts.apis.io/toku/openapi/toku-refunds-api-openapi.yml