Actualmente no disponemos de documentaci\u00f3n en profundidad para desarrolladores, pero a continuaci\u00f3n se incluyen algunos fragmentos de c\u00f3digo y recursos \u00fatiles para desarrolladores, que pueden ser de utilidad o que otros clientes han solicitado en el pasado.<\/p>\n\n\n\n
El plugin tiene sus propias tablas de base de datos de las que puedes obtener ciertos datos:<\/p>\n\n\n\n
wcusage_activity - Registro de actividad.<\/p>\n\n\n\n
wcusage_campaigns - Campa\u00f1as de URL de referencia.<\/p>\n\n\n\n
wcusage_clicks - Registro de clics en URL de referencia.<\/p>\n\n\n\n
wcusage_directlinks - Dominios de seguimiento de enlaces directos.<\/p>\n\n\n\n
wcusage_mlainvites - Invitaciones para afiliados multinivel.<\/p>\n\n\n\n
wcusage_payouts - Pago de comisiones<\/p>\n\n\n\n
wcusage_register - Aplicaciones de registro de afiliados.<\/p>\n\n\n\n
Obtiene todos los pedidos de afiliados de un cup\u00f3n, sin un rango de datos determinado. Esto devuelve un array de datos que incluye los c\u00e1lculos totales de todos los pedidos, y todos los pedidos individuales.<\/p>\n\n\n\n
$orders = wcusage_wh_getOrderbyCouponCode( $coupon_code, $start_date, $end_date, '', 1 );<\/code><\/pre>\n\n\n\nDatos del pedido<\/h2>\n\n\n\n
Puede obtener un array de datos relacionados con afiliados para un determinado pedido a trav\u00e9s de esta funci\u00f3n. Esto devuelve una matriz de datos incluyendo las ganancias de comisi\u00f3n.<\/p>\n\n\n\n
$order_data = wcusage_calculate_order_data( $order_id, $coupon_code, 0, 1 );<\/code><\/pre>\n\n\n\nPara obtener la comisi\u00f3n del pedido, por ejemplo:<\/p>\n\n\n\n
$commission = $order_data['totalcommission'];<\/code><\/pre>\n\n\n\nURL de afiliado<\/h2>\n\n\n\n
Obtenga la URL de afiliaci\u00f3n de un cup\u00f3n mediante la siguiente funci\u00f3n:<\/p>\n\n\n\n
$coupon_code = \"\"; \/\/ Establezca aqu\u00ed el nombre del c\u00f3digo del cup\u00f3n.\n$affiliate_url = wcusage_get_affiliate_url($coupon_code);<\/code><\/pre>\n\n\n\nO si quieres construir tu propia URL personalizada aqu\u00ed tienes un ejemplo:<\/p>\n\n\n\n
$coupon_code = \"\"; \/\/ Establezca aqu\u00ed el nombre del c\u00f3digo del cup\u00f3n.\n$prefix = wcusage_get_setting_value('wcusage_field_urls_prefix', 'coupon');\n$affiliate_url = get_home_url() . \"?\" . $prefix . \"=\" . 1TP4C\u00f3digo_cup\u00f3n;<\/code><\/pre>\n\n\n\nTotal ventas y comisiones<\/h2>\n\n\n\n
Obtenga el total de ventas y comisiones obtenidas por un cup\u00f3n determinado, sin un intervalo de fechas determinado. Deje $start_date vac\u00edo para obtener todas las ventas.<\/em><\/p>\n\n\n\n$orders = wcusage_wh_getOrderbyCouponCode( $coupon_code, $start_date, $end_date, '', 1 );\n$total_orders = $orders['total_orders']; \/\/ Ventas totales\n$total_discounts = $orders['full_discount']; \/\/ Descuentos totales\n$total_commission = $orders['total_commission']; \/\/ Comisi\u00f3n total\n$order_count = $orders['total_count']; \/\/ Recuento de pedidos<\/code><\/pre>\n\n\n\nComisi\u00f3n no pagada<\/h2>\n\n\n\n
Obt\u00e9n la comisi\u00f3n total no pagada por un cup\u00f3n de afiliado.<\/p>\n\n\n\n
$coupon_id = \"\"; \/\/ Establezca aqu\u00ed el ID del c\u00f3digo del cup\u00f3n.\n$unpaid_commission = get_post_meta( $coupon_id, 'wcu_text_unpaid_commission', true );<\/code><\/pre>\n\n\n\nGancho (Acci\u00f3n): Se presenta el registro de nuevos afiliados<\/h2>\n\n\n\n
Cuando haya un nuevo registro de afiliado, se ejecutar\u00e1 el hook \"wcusage_hook_registration_new\" que pasar\u00e1 el ID de registro, el ID de usuario y el c\u00f3digo de cup\u00f3n.<\/p>\n\n\n\n
Por lo tanto, podr\u00eda llamar a este hook para aceptar autom\u00e1ticamente el registro bajo ciertas condiciones con la funci\u00f3n \"wcusage_set_registration_status\". Por ejemplo, esto aceptar\u00e1 autom\u00e1ticamente el registro si el rol del usuario es \"ejemplo\":<\/p>\n\n\n\n
add_action( 'wcusage_hook_registration_new', 'trigger_wcusage_hook_registration_new', 10, 3 );\nfunction trigger_wcusage_hook_registration_new( $registration_id, $user_id, $coupon_code ) {\n $user_info = get_userdata( $user_id );\n $roles = $user_info->roles;\n\n if ( in_array( 'ejemplo', $roles ) ) {\n wcusage_set_registration_status( 'accepted', $registration_id, $user_id, $coupon_code, '', '' );\n }\n}<\/code><\/pre>\n\n\n\nGancho (Acci\u00f3n): Nuevo afiliado aceptado<\/h2>\n\n\n\n
Cuando un nuevo afiliado es aceptado y a\u00f1adido a su programa, se ejecutar\u00e1 el \"wcusage_hook_affiliate_register_accepted\" que pasar\u00e1 lo siguiente:<\/p>\n\n\n\n
\n- $id - ID de registro.<\/li>\n\n\n\n
- $userid - ID de usuario.<\/li>\n\n\n\n
- $coupon_code - C\u00f3digo del cup\u00f3n.<\/li>\n\n\n\n
- $message - El mensaje de aceptaci\u00f3n del registro.<\/li>\n\n\n\n
- $status - El estado de su registro.<\/li>\n<\/ul>\n\n\n\n
add_action( 'wcusage_hook_affiliate_register_accepted', 'trigger_wcusage_hook_registration_accepted', 10, 5 );\nfunction trigger_wcusage_hook_registration_accepted( $id, $userid, $coupon_code, $message, $status ) {\n\/\/ Su c\u00f3digo aqu\u00ed.\n}<\/code><\/pre>\n\n\n\nAPI Endpoint: Informaci\u00f3n del cup\u00f3n<\/h2>\n\n\n\n
En Informaci\u00f3n sobre cupones<\/code> le permite obtener informaci\u00f3n detallada sobre un cup\u00f3n espec\u00edfico por su ID. Esto incluye el nombre del cup\u00f3n, la comisi\u00f3n no pagada y los pagos pendientes, por lo que es una herramienta esencial para el seguimiento del rendimiento del cup\u00f3n y el estado de los pagos. S\u00f3lo los administradores pueden acceder a este punto final.<\/p>\n\n\n\nPara utilizar la API, env\u00ede un GET<\/strong> solicitar a \/wp-json\/woo-coupon-usage\/v1\/coupon-info<\/code> con el par\u00e1metro requerido cup\u00f3n_id<\/code> (el ID del cup\u00f3n que desea consultar). La respuesta incluir\u00e1 una matriz que contendr\u00e1 nombre_cup\u00f3n<\/code>, comisi\u00f3n_no_pagada<\/code>y pagos_pendientes<\/code>.<\/p>\n\n\n\nAPI Endpoint: Cupones de usuarios<\/h2>\n\n\n\n
En Cupones de usuario<\/code> El punto final de API le permite recuperar una lista de ID de cup\u00f3n asignados a un usuario espec\u00edfico, junto con su comisi\u00f3n no pagada asociada. Esta funcionalidad es \u00fatil para supervisar y gestionar las asignaciones de cupones y comisiones espec\u00edficas de un usuario. El acceso a este punto final est\u00e1 limitado a los administradores.<\/p>\n\n\n\nPara utilizar la API, env\u00ede un GET<\/strong> solicitar a \/wp-json\/woo-coupon-usage\/v1\/users-coupons<\/code> con el par\u00e1metro requerido usuario<\/code> (el nombre de usuario cuyos cupones desea recuperar). La API devolver\u00e1 una matriz de ID de cup\u00f3n junto con su comisi\u00f3n no pagada, proporcionando una visi\u00f3n general de la actividad de cupones del usuario.<\/p>\n\n\n\nAPI Endpoint: Solicitar pago<\/h2>\n\n\n\n
En Solicitar pago<\/code> El punto final de API le permite activar solicitudes de pago para un cup\u00f3n espec\u00edfico. Verifica el usuario que solicita el pago y comprueba si la comisi\u00f3n no pagada del cup\u00f3n es v\u00e1lida y est\u00e1 lista para su procesamiento.<\/p>\n\n\n\nPara utilizar la API, haga una POST<\/strong> solicitar a \/wp-json\/woo-coupon-usage\/v1\/request-payout<\/code> con dos par\u00e1metros obligatorios: cup\u00f3n_id<\/code> (el ID del cup\u00f3n) y usuario<\/code> (el nombre de usuario del usuario que solicita el pago). Aseg\u00farese de que el usuario que llama tiene permisos de administrador. Si la validaci\u00f3n es correcta, el sistema procesa la solicitud de pago y devuelve 1<\/code> para el \u00e9xito o 0<\/code> para el fracaso.<\/p>\n\n\n\n—<\/p>\n\n\n\n
\u00bfNecesita ayuda con una funci\u00f3n personalizada? P\u00f3ngase en contacto con nosotros y le indicaremos c\u00f3mo hacerlo.<\/p>","protected":false},"excerpt":{"rendered":"
Actualmente no disponemos de documentaci\u00f3n en profundidad para desarrolladores, pero aqu\u00ed hay algunos fragmentos de c\u00f3digo y recursos \u00fatiles para desarrolladores, que pueden ser de utilidad o que otros clientes han solicitado en el pasado. Tablas de base de datos El plugin tiene sus propias tablas de base de datos de las que puede obtener ciertos datos: wcusage_activity - Registro de actividad. wcusage_campaigns [...]<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","footnotes":"","_links_to":"","_links_to_target":""},"doc_category":[136],"doc_tag":[],"class_list":["post-14525","docs","type-docs","status-publish","hentry","doc_category-developers","wpbf-post"],"year_month":"2026-04","word_count":872,"total_views":"3194","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"display_name":"Elliot Sowersby","author_link":"#"},"doc_category_info":[{"term_name":"Developers","term_url":"https:\/\/couponaffiliates.com\/es\/categoria-docs\/desarrolladores\/"}],"doc_tag_info":[],"taxonomy_info":{"doc_category":[{"value":136,"label":"Developers"}]},"featured_image_src_large":false,"comment_info":0,"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/couponaffiliates.com\/es\/wp-json\/wp\/v2\/docs\/14525","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/couponaffiliates.com\/es\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/couponaffiliates.com\/es\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/couponaffiliates.com\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/couponaffiliates.com\/es\/wp-json\/wp\/v2\/comments?post=14525"}],"version-history":[{"count":24,"href":"https:\/\/couponaffiliates.com\/es\/wp-json\/wp\/v2\/docs\/14525\/revisions"}],"predecessor-version":[{"id":22499,"href":"https:\/\/couponaffiliates.com\/es\/wp-json\/wp\/v2\/docs\/14525\/revisions\/22499"}],"wp:attachment":[{"href":"https:\/\/couponaffiliates.com\/es\/wp-json\/wp\/v2\/media?parent=14525"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/couponaffiliates.com\/es\/wp-json\/wp\/v2\/doc_category?post=14525"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/couponaffiliates.com\/es\/wp-json\/wp\/v2\/doc_tag?post=14525"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}