--- title: "Crear una asignación con estrategia personalizada" method: POST path: "/{country_code}/public/charge-schedules/custom-assignment" tags: ["Sin catalogar"] --- # Crear una asignación con estrategia personalizada `POST /{country_code}/public/charge-schedules/custom-assignment` ## Request - Base URL: `https://api.trytoku.com` - URL: `https://api.trytoku.com/{country_code}/public/charge-schedules/custom-assignment` - Auth: API key in header `x-api-key` Crea una estrategia + asignación para la Organization autenticada. La estrategia es una nueva estrategia personalizada (``custom_strategy_payload``, propiedad de la Organization) o una estrategia TOKU compartida ya existente (``id_toku_strategy``) — se debe entregar exactamente una de las dos. ## Path parameters - `country_code` 'cl' | 'mx' | 'br', required: Códigos de país admitidos en el prefijo de ruta `/{country_code}`. ## Headers - `x-account-key` string ## Request body - CustomStrategyAssignmentPayload: Crea una estrategia + asignación en una sola llamada. La estrategia es una nueva estrategia personalizada (``custom_strategy_payload``) propiedad de la Organization autenticada, o una estrategia TOKU compartida ya existente referenciada por ``id_toku_strategy``. Se debe entregar exactamente una de las dos. - `custom_strategy_payload` CustomStrategyPayload: Estrategia personalizada a crear junto con una asignación. - `charge_schedules` ChargeSchedule[], required - `charge_max_start_time` string - `charge_start_time` string - `date` string, date-time - `day_offset` integer - `id_charge_schedule` string - `independent_attempt` boolean - `retry_schedules_configuration` RetrySchedulesConfiguration - `recurring_retry_configuration` RecurringRetryConfiguration - `max_retries` integer, required - `retry_calendar_type` 'BUSINESS' | 'CALENDAR', required: Unidad en que se interpreta un conteo de días: `CALENDAR` cuenta todos los días y `BUSINESS` cuenta solo días hábiles, salteando fines de semana y los feriados del país. Aparece por separado en cada configuración que cuenta días, así que una misma estrategia puede usar días hábiles para calcular la fecha de cobro y días corridos para espaciar los reintentos. - `retry_interval_days` integer, required - `retry_times` string[] - `schedule_date_type` 'CHARGE_DATE' | 'SUBMIT_DATE', required: Qué representa la fecha configurada: `CHARGE_DATE` es el día en que se cobra al pagador, y `SUBMIT_DATE` el día en que Toku envía la instrucción al banco. En los productos que cobran por archivo o mandato bancario ambas fechas difieren en los días hábiles de anticipación que exige la institución, así que con `CHARGE_DATE` el envío se adelanta para llegar a cobrar el día pedido. En los productos que cobran en línea, sin anticipación, las dos opciones son equivalentes. - `schedule_type` 'DATE' | 'OFFSET', required: Si una entrada del calendario de cobro es una fecha fija o una regla recurrente. Con `DATE` la entrada cobra una sola vez, en la fecha indicada. Con `OFFSET` la entrada define un desplazamiento que la periodicidad expande en varias fechas, y es la única forma que expande además los reintentos. - `default_charge_behaviour` 'FILL_UP_TO_BUSINESS_DAY' | 'FILL_UP_TO_CALENDAR_DAY' | 'SKIP_UNSCHEDULED_DAY', required: Si además de las fechas que la estrategia calendariza se cobra también en los días que no calendarizó. `SKIP_UNSCHEDULED_DAY` no agrega ninguno: se cobra solo en las fechas calendarizadas. `FILL_UP_TO_BUSINESS_DAY` completa todos los días hábiles del horizonte y `FILL_UP_TO_CALENDAR_DAY` todos los días corridos, descontando en este último caso los que el comportamiento de día no hábil descarte. - `default_charge_time` string, required - `default_invoice_due_date_window` InvoiceDueDateWindow: Modelo que representa la ventana de fechas de vencimiento del Invoice. - `calendar_type` 'BUSINESS' | 'CALENDAR', required: Unidad en que se interpreta un conteo de días: `CALENDAR` cuenta todos los días y `BUSINESS` cuenta solo días hábiles, salteando fines de semana y los feriados del país. Aparece por separado en cada configuración que cuenta días, así que una misma estrategia puede usar días hábiles para calcular la fecha de cobro y días corridos para espaciar los reintentos. - `max_offset_days` integer - `min_offset_days` integer - `default_toku_products_configuration` DefaultTokuProductsConfiguration[] - `rendition_day_offset` integer - `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. - `name` string, required - `recurrence_rules` RecurrenceRules, required - `calendar_type` 'BUSINESS' | 'CALENDAR', required: Unidad en que se interpreta un conteo de días: `CALENDAR` cuenta todos los días y `BUSINESS` cuenta solo días hábiles, salteando fines de semana y los feriados del país. Aparece por separado en cada configuración que cuenta días, así que una misma estrategia puede usar días hábiles para calcular la fecha de cobro y días corridos para espaciar los reintentos. - `non_business_day_behaviour` 'CONTINUE' | 'NEXT_BUSINESS_DAY' | 'PREVIOUS_BUSINESS_DAY' | 'SKIP', required: Qué hacer cuando una fecha de cobro calculada cae en fin de semana o feriado. `NEXT_BUSINESS_DAY` la mueve al siguiente día hábil, `SKIP` descarta el cobro de ese período y `CONTINUE` deja la fecha tal cual, cobrando en día no hábil. - `periodicity` 'MONTH' | 'SEMI_MONTH' | 'WEEK' | 'EVENT_TRIGGERED', required: Patrón con que se repite un cobro y con el que se expande el offset configurado en fechas concretas. `MONTH` genera una fecha por mes, `WEEK` una por semana —donde el offset es el día de la semana, de `1` (lunes) a `7` (domingo)— y `SEMI_MONTH` dos por mes, una contada desde el inicio del mes y otra desde su mitad. `EVENT_TRIGGERED` no se calendariza: sus fechas de cobro no se generan por adelantado sino cuando ocurre el evento que las dispara, y por eso exige definir la ventana horaria en que el cobro puede ejecutarse y no admite configuración de reintentos. - `status` 'DRAFT' | 'ACTIVE' | 'INACTIVE' | 'DEPRECATED' | 'DELETED': Estado de una estrategia de calendario de cobro, la definición reutilizable de cuándo cobrar (periodicidad, calendario, offsets, reintentos). Solo una estrategia `ACTIVE` genera fechas de cobro y solo una `ACTIVE` puede activarse en una cuenta. `DRAFT` es el estado con que nace una estrategia creada por API: se puede editar, pero ninguna asignación suya se puede activar mientras siga ahí. Pasar una estrategia a `INACTIVE` cancela las fechas de cobro que tenía pendientes y deja de generar nuevas. `DELETED` es terminal y solo lo aplica Toku cuando se borra la última asignación que apuntaba a una estrategia propia de la organización. `DEPRECATED` se acepta y se persiste, pero hoy no tiene comportamiento propio: se comporta como cualquier estado distinto de `ACTIVE`. - `id_toku_strategy` string - `strategy_assignment_payload` StrategyAssignmentPayload, required: Asignación a crear. Se envía un único ``charge_schedule_configurations`` primario, que aplica a toda la asignación. Opcionalmente se pueden enviar ``charge_schedule_configurations_overrides`` para definir configuraciones distintas por salida (por ejemplo, GAD/CAT multibanco); cuando vienen, se usan tal cual. - `charge_schedule_configurations` ChargeScheduleConfigurations, required - `payment_process_configuration` PaymentProcessConfiguration - `invoice_grouping` 'GROUPED' | 'UNGROUPED' | 'PARTIAL' | 'SEQUENTIAL': Cómo se agrupan las Invoices por cobrar de una cuenta en cobros concretos. `UNGROUPED` genera un cobro por Invoice y `GROUPED` junta en un mismo cobro las Invoices de una misma Subscription. `PARTIAL` es el modo de los cobros que admiten pago parcial, donde el monto de una Invoice puede repartirse en más de un cobro. `SEQUENTIAL` genera un cobro por Invoice como `UNGROUPED`, pero las Invoices de una misma Subscription se cobran de a una, ordenadas por fecha de vencimiento: cada cobro se dispara sólo si el anterior fue exitoso, y la cadena se detiene ante el primer fallo. - `partial_payments_configuration` PartialPaymentsConfiguration - `division_strategy` DivisionStrategy - `criteria` string, required - `partitions` DivisionStrategyPartition[] - … - `maximum_amount` number - `minimum_amount` number - `partition_override` DivisionStrategyPartition - `rates` number[] - `threshold` integer, required - `payment_configuration_key` string - `priority` integer - `sub_tree_configuration` SubTreeConfiguration: The sub-tree of the orchestration tree this charge may walk. - `specific_gateways` CollectionStrategistPaymentIntentGateway[]: The only gateways attempted. `None` or empty does not narrow by gateway. - `start_item_index` integer: First item attempted. `None` starts at the first one. - `stop_item_index` integer: Last item attempted. `None` runs to the last one. - `process_gateway` union - '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`. - 'cl_banco_de_chile' | 'cl_banco_internacional' | 'cl_banco_estado' | 'cl_banco_scotiabank' | 'cl_banco_bci' | 'cl_banco_do_brasil' | 'cl_banco_corpbanca' | 'cl_banco_bice' | 'cl_hsbc_bank' | 'cl_banco_santander' | 'cl_banco_itau' | 'cl_jp_morgan_chase_bank' | 'cl_banco_de_la_nacion_argentina' | 'cl_the_bank_of_tokyo' | 'cl_banco_security' | 'cl_banco_falabella' | 'cl_banco_ripley' | 'cl_rabobank' | 'cl_banco_consorcio' | 'cl_banco_penta' | 'cl_banco_paris' | 'cl_banco_btg_pactual' | 'cl_china_construction_bank' | 'cl_banco_bbva' | 'cl_banco_coopeuch' | 'cl_prepago_los_heroes' | 'cl_tenpo' | 'cl_tapp_caja_los_andes' | 'cl_global66' | 'cl_fintual' | 'cl_mercado_pago' | 'mock': Institución financiera chilena, identificada por un código propio de Toku con prefijo `cl_`. Es el subconjunto de Chile de las instituciones con las que Toku opera, más `mock`, que existe solo para pruebas. - string - `process_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': 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. - `recurrence_filters` RecurrenceFilters - `custom_filters` CustomFilters - `opt_in` CustomFilterParams[] - `description` string - `filter_params` object - `name` string, required - `opt_out` CustomFilterParams[] - `description` string - `filter_params` object - `name` string, required - `due_date_window_from_charge_date` DueDateWindowFromChargeDate - `calendar_type` 'BUSINESS' | 'CALENDAR', required: Unidad en que se interpreta un conteo de días: `CALENDAR` cuenta todos los días y `BUSINESS` cuenta solo días hábiles, salteando fines de semana y los feriados del país. Aparece por separado en cada configuración que cuenta días, así que una misma estrategia puede usar días hábiles para calcular la fecha de cobro y días corridos para espaciar los reintentos. - `gte_offset` integer - `lte_offset` integer - `entity_filters` EntityFilterParams[] - `column` string, required - `description` string - `filter_type` string - `name` string - `operator` string, required - `table` string, required - `through_table` string - `value` union - integer - string - boolean - integer[] - string[] - boolean[] - `id_accounts` integer[] - `payment_method_gateways` CollectionStrategistPaymentMethodGateway[] - `payment_method_status` PaymentMethodStatusFilters: Adjusts the statuses the base query computes: `(default + opt_in) - opt_out`. - `opt_in` PaymentMethodStatus[] - `opt_out` PaymentMethodStatus[] - `payment_method_toku_products` TokuProduct[] - `rehydration_configuration` RehydrationConfiguration - `rehydration_percentage` number - `toku_product_configuration` CollectionStrategistTokuProductConfiguration - `attempt` integer - `boleto_config_key` string - `charge` boolean - `charge_mode` string - `connection` string - `debiting_institution_ids` string[] - `due_date` string - `id_data_in_file` integer - `ids_data_in_file` integer[] - `include_billable_amounts` boolean - `is_ddo_psp_demo_execution` boolean - `layout` string - `non_blocking_after_attempts` integer - `non_blocking_collection` boolean - `payment_method_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. - `rendition_day_offset` integer - `charge_schedule_configurations_overrides` object - `id_account` integer, required - `product_type` 'CARDS' | 'RENDITION_FILES' | 'PIX' | 'BOLETO', required: Canal de recaudación de una asignación: la familia de rieles por la que sale el cobro. `CARDS` cobra a tarjetas inscritas, `RENDITION_FILES` cobra por archivo de rendición —descuento automático, PAC y los archivos batch de tarjetas—, y `PIX` y `BOLETO` cobran por esos medios brasileños. Es la llave con que se enruta cada cobro, y cada canal exige su propia configuración: qué datos hay que completar antes de poder activar una asignación depende de este valor. El `toku_product` elige después el flujo exacto dentro del canal. - `status` 'DRAFT' | 'ACTIVE' | 'PAUSED' | 'DISABLED' | 'DELETED': Estado de la asignación entre una estrategia de calendario de cobro y una cuenta: es el interruptor con que se prende y se apaga el cobro recurrente. Solo una asignación `ACTIVE` genera fechas de cobro. `DRAFT` es el estado inicial, que permite dejar una asignación configurada sin cobrar todavía. Pasarla a `PAUSED` o a `DISABLED` cancela sus fechas pendientes; la diferencia es quién la apaga y qué pasa después: `PAUSED` es una pausa pedida por la organización y `DISABLED` es la que aplica Toku cuando la cuenta u organización deja de estar vigente, que además impide que se vuelva a crear una asignación por defecto. `DELETED` es terminal. Las transiciones válidas son `DRAFT` → `ACTIVE`, `ACTIVE` ⇄ `PAUSED`, `ACTIVE`/`PAUSED` → `DISABLED`, `DISABLED`/`PAUSED` → `ACTIVE`, y cualquiera → `DELETED`; el resto se rechaza. - `tracking_metadata` AssignmentTrackingMetadataPayload, required: Autoría de la asignación, entregada al momento de la creación. - `author` string, required ## Response `201` Successful Response - CustomStrategyAssignmentCreatedResponse: Ids de la estrategia + asignación creadas. - `id_charge_schedule_strategy` string, required - `id_charge_schedule_strategy_assignment` string, required ## Other responses - `401`: Faltan las credenciales o son inválidas. - `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. ## Changes - **2026-11-03** `a6ef070075b1`: 1 info - endpoint added [Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/:country_code/public/charge-schedules/custom-assignment/post.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)