Integrar ADDI con WooCommerce de WordPress

por

Aquí tienes la forma correcta, actual y oficial de integrar ADDI con WooCommerce + WordPress.
ADDI sí tiene integración para comercios, pero no existe plugin oficial en el repositorio de WordPress, así que se hace por dos caminos:

✅ OPCIÓN 1 – Plugin oficial ADDI (se solicita al equipo técnico)

ADDI ofrece un plugin privado para WooCommerce que ellos entregan directamente al comercio.

✔ Cómo obtenerlo

Tienes que solicitarlo a:

📩 soporte@addi.com
📩 partners@addi.com

O desde su formulario empresarial:
https://www.addi.com/for-merchants (sección Comercios)

Ellos te envían:

  • Plugin WooCommerce (.zip)
  • Merchant ID
  • API Key
  • API Secret
  • URLs de callback/notificaciones

Con ese ZIP, simplemente lo subes en:

👉 Plugins → Añadir nuevo → Subir plugin

🟦 OPCIÓN 2 – Integración manual por API (si no te dan plugin)

ADDI usa un flujo estándar de “redirigir → pagar → retornar”.

1️⃣ Crear el pedido en ADDI (PHP)

Ejemplo básico:

function addi_create_order($order_id) {
    $order = wc_get_order($order_id);

    $body = [
        "amount" => intval($order->get_total()),
        "currency" => "COP",
        "orderId" => strval($order_id),
        "buyer" => [
            "email" => $order->get_billing_email(),
            "phone" => $order->get_billing_phone(),
            "document" => $order->get_meta('_billing_dni')
        ],
        "redirectUrl" => $order->get_checkout_order_received_url()
    ];

    $response = wp_remote_post("https://api.addi.com/payments/v1/sessions", [
        "headers" => [
            "Content-Type" => "application/json",
            "X-Api-Key" => "TU_API_KEY"
        ],
        "body" => json_encode($body)
    ]);

    if (is_wp_error($response)) return false;

    $data = json_decode($response['body'], true);

    return $data["checkoutUrl"];
}

Luego WooCommerce redirige a ese enlace.

🟨 Flujo completo del checkout ADDI

  1. Cliente selecciona “Paga con ADDI – compra ahora y paga después”
  2. WooCommerce crea el pedido
  3. Redirige al checkout de ADDI
  4. El cliente ingresa su documento
  5. ADDI aprueba / rechaza
  6. Retorna al sitio
  7. WooCommerce actualiza el pedido:
  • processing = aprobado
  • failed = rechazado
  • on-hold = en revisión

🎯 OPCIÓN 3 – Te creo un gateway personalizado (totalmente funcional)

Si no te lo entregan o lo necesitas YA, puedo hacerte:

✔ Un método de pago ADDI en WooCommerce
✔ Con botón, logo y textos en checkout
✔ Con redirección automática al checkout ADDI
✔ Con actualización de estado por webhook

Solo necesitaría:

  • API Key
  • Merchant ID
  • URL de sesión (endpoint oficial)

📌 Pregunta final (importante para seguir):

¿Ya tienes cuenta de comercio en ADDI y las credenciales (API Key / Merchant ID)?

Si no, te digo cómo registrarte correctamente.

Deja un comentario