Intermediación Ciega Certificada
Integraciones E-commerce / Buenos Aires
R
Regalación. Blind Gifting & Buffer
REST API v1 & Webhooks | Para Comercios Asociados

Guía de Integración para Tiendas E-commerce

Conectá tu tienda (WooCommerce, Tiendanube, Shopify, VTEX o plataforma propia) para procesar órdenes con Blind Shipping. El cliente paga en tu pasarela y Regalación custodia la reserva domiciliaria.

Método 01

Drop-in JavaScript SDK

Una sola línea de script en tu tienda. Detecta el token o creador en URL y persiste el contexto de regalo durante toda la navegación.

Método 02

Hooks de Carrito & Checkout

Tiendanube y WooCommerce. Al recibir un gift_token, consulta privadamente el CP para cotizar el flete real del correo.

Método 03

REST API Machine-to-Machine

Para desarrollos propios en Python, Node, PHP o Go. Control total mediante cabecera X-Store-Api-Key y webhooks seguros.

SDK Universal Drop-in

v1.0 Producción

Pegá esta etiqueta antes del cierre de </body> en tu tienda:

<script src="https://regalacion.com/assets/regalacion.js" data-store-key="TU_STORE_API_KEY"></script>
Especificación Técnica

Endpoints Principales

GET /v1/users/{username}/gift-context
Header: X-Store-Api-Key: {api_key}

Permite a cualquier tienda verificar si un creador existe, consultar sus notas de preferencias y obtener su Código Postal para calcular el envío en el checkout sin exponerlo al cliente.

Ejemplo de consulta cURL:
curl -X GET "https://regalacion.com/v1/users/marianotubio/gift-context" \
-H "X-Store-Api-Key: store_key_aldos_2026"
GET /v1/gifts/{gift_token}/context
Header: X-Store-Api-Key: {api_key}

Invocado por el backend del checkout de la tienda para obtener el Código Postal del receptor y el modo de despacho (standard_blind o charity_buffer).

POST /v1/gifts/{gift_token}/payment-cleared
Header: X-Store-Api-Key: {api_key}

La tienda notifica a Regalación que el comprador completó exitosamente el pago del pedido. La orden queda en espera preventiva y se dispara la notificación al receptor.

POST /v1/gifts/{gift_token}/dispatch
Header: X-Store-Api-Key: {api_key}

Devuelve al comercio los datos físicos exactos (calle, número, piso, teléfono de contacto) para imprimir la guía del correo una vez que el receptor los ha confirmado.

POST /v1/gifts/{gift_token}/cancel
Header: X-Store-Api-Key: {api_key}

Cancela la orden en el comercio si el receptor declina el regalo o si transcurrieron 72 horas sin aprobación, liberando el reembolso al comprador.