https://app.gudink.com/api/v1. No hay una cuenta ni un entorno aparte: probás con tu clave gk_live_, tus productos y tu destino de avisos, que son los mismos que después vas a usar para vender.
Hay dos formas, y conviene empezar por la primera:
- Pedidos en borrador (
/order-drafts): Gudink valida el pedido y te devuelve el costo, pero no crea ningún pedido. No reserva stock, no te llega ningún mail y no aparece en tu panel. Es la forma de probar tu integración sin dejar rastro. - Pedidos sin pagar: un pedido real que no pagás. Sirve para probar lo que pasa después de crearlo (consultarlo, cancelarlo, los avisos).
Probar con pedidos en borrador
Mandás el mismo cuerpo que aPOST /orders, pero a POST /order-drafts:
201 con status: "draft", el desglose de costos (totals) y su vencimiento. Se validan las mismas cosas que en un pedido real: productos, variantes, datos de facturación y la cotización del envío. Si algo está mal, el error es el mismo que te devolvería POST /orders.
Lo que podés hacer con un borrador:
- Verlo:
GET /order-drafts/{id}, o todos conGET /order-drafts. - Borrarlo:
DELETE /order-drafts/{id}. - Confirmarlo:
POST /order-drafts/{id}/confirmlo convierte en un pedido real, igual que si lo hubieras creado conPOST /orders: vuelve a chequear stock y precio en ese momento y responde el pedido, condraft_idyprice_changed(truesi el total cambió desde el borrador). Si la cotización del envío venció, mandá una nueva en el cuerpo:{ "shipping": { "quote_id": "..." } }. Confirmar dos veces el mismo borrador devuelve el mismo pedido, sin duplicarlo.
Probar con pedidos sin pagar
Lo que lo hace seguro es el pago. Un pedido creado por API nace sin pagar (pending_payment) y Gudink no lo produce ni te lo cobra hasta que lo pagás vos desde tu panel. Si no lo pagás, no pasa nada: lo cancelás o vence solo.
Lo que necesitás
- Tu cuenta de Gudink, con el email verificado y los datos de facturación completos.
- Al menos un producto diseñado en tu cuenta.
- Una clave, que creás vos en Integraciones > API. Ver Claves y autenticación.
- Si vas a usar avisos, un destino dado de alta en Integraciones > API > Avisos.
Qué pasa con un pedido de prueba
No pagues desde
payment.pay_url un pedido de prueba. Pagarlo lo convierte en un pedido real: se produce, se envía a la dirección que mandaste y se te cobra.
Cancelá cada pedido de prueba
- Cancelalo cuando termines con
POST /orders/{id}/cancel. Responde 200 constatus: "cancelled"ycancel_reason: "cancelled_by_seller", y sus unidades vuelven a estar disponibles en el momento. - Si te olvidás, vence solo a las 72 horas de creado, con
cancel_reason: "unpaid_expired". Mientras tanto retiene stock, y tus próximas pruebas pueden responder 409out_of_stockaunque la variante digaavailable: true. - Cuentan para el tope de pedidos sin pagar. Podés tener hasta 20 pedidos por API sin pagar a la vez, y hasta 50 unidades entre todos. Pasado eso, el siguiente responde 409
too_many_unpaid_ordershasta que canceles o pagues alguno. Ver Límites. - Usá un prefijo de
external_idque se distinga a simple vista, por ejemploprueba-k7p2-0001, así los reconocés en tu panel.
out_of_stock. Tu código tiene que manejarlo igual: probalo, por ejemplo, con un doble de la API en tus tests.
Probar product_archived
No se puede archivar un producto por la API. Para probar el rechazo:- En tu panel, diseñá un producto de prueba y archivalo.
- Mandá un pedido con su
product_id. Responde 409product_archived. Ese chequeo va antes que el de la cotización, así que sirve cualquierquote_id.
GET /products, GET /products/{id} responde 404 y cotizarlo también responde 404 not_found.
Probar los avisos
- “Mandar prueba”, en Integraciones > API > Avisos, te envía un aviso
webhook.testfirmado con el secreto de tu destino. Ver el aviso de prueba. - Crear un pedido manda
order.created, y cancelarlo mandaorder.cancelled. Los dos salen igual que con un pedido real. - La firma y cada
typede aviso los podés probar sin red, firmando vos los avisos: ver Probar tu destino sin publicarlo. - Si tu servidor corre en tu máquina, necesitás cualquier túnel
httpscon un nombre de host público: Gudink no puede mandar avisos alocalhost, a una IP ni a un puerto que no sea 443. Cuando termines, borrá ese destino.
Ver los estados que vienen después del pago
Pagado, en producción, despachado y entregado sólo se ven con un pedido pagado. Para verlos de verdad, pagá un pedido real: por ejemplo, una muestra para vos, con tu dirección como destino. Así recibísorder.paid, order.in_production, order.shipped (con el número de seguimiento real) y order.delivered, y de paso ves el producto terminado.
Hasta ese momento, probá esos avisos firmándolos vos con el vector de prueba: tu código no distingue un aviso firmado por vos de uno de Gudink.
Recorrido de prueba de punta a punta
Corré estos pasos, en orden. Si salen bien, tu integración está lista para vender.
Si tu tienda ofrece retiro en sucursal, hacé también un pedido con la opción
pickup: va con pickup_point_id y sin shipping_address (ver Retiro en sucursal). Cancelalo igual al terminar.
Los pasos 5 a 7, con curl:
Antes de empezar a vender
- Cancelá los pedidos de prueba que hayan quedado sin pagar: ocupan lugar en el tope de 20 y retienen stock.
- Borrá el destino de avisos del túnel, si usaste uno, y dejá dado de alta el de tu servidor.
- Si hiciste las pruebas con una clave que ya no vas a usar, revocala.
- Repasá el checklist antes de pasar a producción.

