1. Arquitectura general

2. Flujo de pago

1. Checkout
   process_payment()

   • Obtiene token → get_token() (/auth/token).

   • POST /v2/api/checkout con:

     { "origin":"woocommerce_uala",
     "amount": <total>,
     "description": "<nombres productos>",
     "notification_url": "<site>/?wc-api=uala",
     "callback_fail": "<url falló>",
     "callback_success": "<url gracias>",
     "external_reference": "<id pedido>" }

   • Guarda respuesta (uuid, links.checkout_link) en meta _uala y en wp_options (uuid → order_id).

   • Redirige al checkout_link.

2. Webhook de pago /wc-api=uala

   • Confirma con 200 OK.

   • Si status ∈ {APPROVED, PROCESSED} → payment_complete() y nota.

   • Guarda json recibido en _uala_response.

3. Reembolsos nativos

• El gateway declara soporte 'refunds'.

• process_refund()

  1. Lee uuid de _uala.

  2. Token OAuth.

  3. POST
     …/v2/api/orders/{uuid}/refund

     { "amount":"<monto>",
     "notification_url":"<site>/?wc-api=uala-refund" }

  4. Evalúa respuestas:

     • HTTP 200 + "status":"REFUNDED" → crea nota y guarda _uala_refund.

     • Otros estados → devuelve WP_Error → WooCommerce informa fallo.

• Webhook de refund /wc-api=uala-refund

  • Confirma con 200 OK.

  • Mapea uuid a order_id.

  • Si status=REFUNDED y aún no existe un WC_Order_Refund lo crea vía wc_create_refund().

  • Registra nota y guarda payload completo en _uala_refund_webhook.

 

4. Tab “Ualá Bis” en WooCommerce → Ajustes → Pagos

5. Gestión de logs

• Si Guardar log = Sí:

  • Pago → UALA LOG | webhook: …

  • Refund → UALA LOG | refund webhook: …

• Archivo: wp-content/debug.log (requiere WP_DEBUG_LOG=true).

 

6. Endpoints externos usados