Conecta tu web con ONEXFY

curl https://api.onexfy.com/api/public/v1/store \
  -H "X-Api-Key: onxapi_TU_TOKEN"

{
  "error": {
    "code": "invalid_items",
    "message": "Hay items que no se pueden vender.",
    "details": { "items.1": "Sin stock suficiente para 3 unidad(es)." }
  }
}

{
  "data": {
    "id": 1260,
    "name": "Tienda Ejemplo",
    "phone": "3001234567",
    "email": "ventas@tiendaejemplo.com",
    "address": "Cl 10 # 43-20",
    "city": "Medellín",
    "currency": "COP",
    "token": { "name": "Tienda web", "scopes": ["catalog:read", "orders:write"], "price_list_id": null, "storage_id": 31 }
  }
}

{ "data": [
  { "id": 12, "name": "Camisetas", "slug": "camisetas", "description": null, "parent_id": null },
  { "id": 15, "name": "Polos", "slug": "polos", "description": null, "parent_id": 12 }
] }

curl "https://api.onexfy.com/api/public/v1/products?category_id=12&in_stock=true&per_page=50" \
  -H "X-Api-Key: onxapi_TU_TOKEN"

{
  "data": [
    {
      "id": 1532,
      "sku": "CAM-001",
      "name": "Camiseta básica",
      "slug": "camiseta-basica",
      "type": "variable",
      "price": 59900,
      "sale_price": 49900,
      "tax_rate": 19,
      "stock": 14,
      "in_stock": true,
      "image": "https://…/camiseta-basica.webp",
      "categories": [{ "id": 12, "name": "Camisetas", "slug": "camisetas" }],
      "variants_count": 3,
      "updated_at": "2026-10-21T16:02:11-05:00"
    }
  ],
  "meta": { "page": 1, "per_page": 50, "total": 134, "last_page": 3 }
}

{
  "data": {
    "id": 1532,
    "name": "Camiseta básica",
    "type": "variable",
    "price": 59900,
    "sale_price": 49900,
    "images": ["https://…/frente.webp", "https://…/espalda.webp"],
    "variants": [
      { "id": 8811, "sku": "CAM-001-NEG-S", "name": "Negro / S", "price": 59900, "sale_price": 49900, "stock": 0, "in_stock": false },
      { "id": 8812, "sku": "CAM-001-NEG-M", "name": "Negro / M", "price": 59900, "sale_price": 49900, "stock": 4, "in_stock": true }
    ]
  }
}

{ "data": [
  { "id": 1000011, "name": "Contra entrega" },
  { "id": 101, "name": "Pago en línea" }
] }

curl -X POST https://api.onexfy.com/api/public/v1/orders \
  -H "X-Api-Key: onxapi_TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "WEB-10045",
    "payment_method_id": 1000011,
    "paid": false,
    "shipping": 12000,
    "notes": "Entregar en portería",
    "customer": {
      "name": "Laura Gómez",
      "dni": "1036951937",
      "email": "laura@example.com",
      "phone": "3001234567",
      "address": "Cra 43A # 1-50 apto 302",
      "city": "Medellín",
      "state": "Antioquia"
    },
    "items": [
      { "product_id": 1532, "variant_id": 8812, "quantity": 2 },
      { "sku": "GORRA-AZ", "quantity": 1 }
    ]
  }'

// PHP 7.4+ con cURL. El token sale de una variable de entorno, nunca del código.
$payload = [
    'reference' => 'WEB-10045',
    'payment_method_id' => 1000011,
    'paid' => false,
    'shipping' => 12000,
    'customer' => [
        'name' => 'Laura Gómez', 'dni' => '1036951937',
        'phone' => '3001234567', 'email' => 'laura@example.com',
        'address' => 'Cra 43A # 1-50 apto 302', 'city' => 'Medellín',
    ],
    'items' => [
        ['variant_id' => 8812, 'quantity' => 2],
        ['sku' => 'GORRA-AZ', 'quantity' => 1],
    ],
];

$ch = curl_init('https://api.onexfy.com/api/public/v1/orders');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'X-Api-Key: ' . getenv('ONEXFY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);

// 201 creado, 200 ya existía (reintento): ambos son éxito.
if ($status === 201 || $status === 200) {
    $orderId = $body['data']['id'];
} elseif ($status === 422) {
    // Mostrar al comprador: $body['error']['details']
}

// Node 18+ (fetch nativo). Ejecutar en el servidor, nunca en el navegador.
const res = await fetch('https://api.onexfy.com/api/public/v1/orders', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ONEXFY_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    reference: 'WEB-10045',
    payment_method_id: 1000011,
    paid: false,
    shipping: 12000,
    customer: {
      name: 'Laura Gómez', dni: '1036951937', phone: '3001234567',
      email: 'laura@example.com', address: 'Cra 43A # 1-50 apto 302', city: 'Medellín',
    },
    items: [
      { variant_id: 8812, quantity: 2 },
      { sku: 'GORRA-AZ', quantity: 1 },
    ],
  }),
});
const body = await res.json();

if (res.status === 201 || res.status === 200) {
  console.log('Pedido ONEXFY', body.data.id);
} else {
  console.error(body.error.code, body.error.details);
}

{
  "data": {
    "id": 205871,
    "reference": "WEB-10045",
    "paid": false,
    "approved": false,
    "items_total": 134700,
    "shipping": 12000,
    "grand_total": 146700,
    "subtotal": 113193,
    "tax_total": 21506.67,
    "payment_method": { "id": 1000011, "name": "Contra entrega" },
    "invoice_number": null,
    "tracking_number": null,
    "customer": { "name": "Laura Gómez", "dni": "1036951937", "email": "laura@example.com", "phone": "3001234567" },
    "items": [
      { "product_id": 1532, "variant_id": 8812, "sku": "CAM-001-NEG-M", "name": "Camiseta básica Negro / M", "quantity": 2, "unit_price": 59900, "total": 119800 },
      { "product_id": 1610, "variant_id": null, "sku": "GORRA-AZ", "name": "Gorra azul", "quantity": 1, "unit_price": 14900, "total": 14900 }
    ],
    "created_at": "2026-10-22T10:14:03-05:00"
  }
}

curl https://api.onexfy.com/api/public/v1/orders/WEB-10045 \
  -H "X-Api-Key: onxapi_TU_TOKEN"