Inicio
API de Afiliados y Marketplace

Lista nuestros productos. Gana en cada venta referida.

Creado para marketplaces y publishers que quieren listar nuestros productos y ganar una comisión - no revenderlos. Obtén nuestro catálogo retail por una API JSON pública, enlaza con tu código de referido y nosotros gestionamos el checkout, la entrega y el soporte. Ganas en cada venta atribuida a ti durante 90 días (first-touch, gana el primer enlace).

Endpoint del catálogo

GET https://buyukesim.com/api/affiliate/catalog

Cómo funciona el modelo de afiliados

  1. 1. Listas nuestros productos en tu plataforma usando la API de catálogo de abajo.
  2. 2. Tus usuarios llegan a buyukesim.com con tu código de referido adjunto.
  3. 3. Nos pagan en cripto y nosotros entregamos y damos soporte al pedido.
  4. 4. La venta se te atribuye durante 90 días (first-touch). Ganas tu comisión acordada.

1Obtén tu código de referido

Incorporamos a los afiliados directamente - cada socio recibe un código de referido único y una tasa de comisión acordada de antemano. Solicita una cuenta desde la página de afiliados o escribe a support@buyukesim.com. Recibirás tu code más un enlace privado al panel para seguir tus ganancias.

2Obtén el catálogo

Un feed JSON de solo lectura de cada producto comprable a precio retail. Autentícate con tu Authorization: Bearer YOUR_API_KEY secreto - la clave aparece en tu panel y te identifica, por lo que cada url de producto vuelve con tu código de referido ya adjunto (sin ?ref). El opcional ?location_code=GB filtra los paquetes de eSIM de viaje a un país. Mantén la clave en secreto; es por cuenta y bloquea solicitudes no autorizadas.

$ curl -H "Authorization: Bearer YOUR_API_KEY" \
    "https://buyukesim.com/api/affiliate/catalog"

{
  "success": true,
  "currency": "USD",
  "referral": {
    "code": "YOUR_CODE",
    "valid": true,
    "attribution_days": 90,
    "attribution_model": "first_touch",
    "param": "ref",
    "short_link": "https://buyukesim.com/r/YOUR_CODE"
  },
  "products": [
    {
      "type": "uk_number",
      "name": "UK Number (+44)",
      "tagline": "Real +44 number, worldwide, yours forever",
      "description": "A real, dedicated +44 UK mobile number ... kept active forever with a small top-up (~$15 every 6 months).",
      "retail_price_usd": 25,
      "url": "https://buyukesim.com/en/uk-esim/?ref=YOUR_CODE"
    },
    {
      "type": "otp_code",
      "name": "One-Time Code",
      "tagline": "One SMS code, no account, no trace",
      "description": "A disposable number for a single SMS verification code ... no account, no SIM. If no code arrives, it is free.",
      "retail_price_usd": 12.99,
      "url": "https://buyukesim.com/en/one-time-code/?ref=YOUR_CODE"
    },
    {
      "type": "travel_data",
      "name": "Travel eSIM",
      "tagline": "Data in 190+ countries, QR in minutes",
      "from_price_usd": 1.99,
      "url": "https://buyukesim.com/en/travel-esim/?ref=YOUR_CODE",
      "packages": [
        {
          "package_code": "CKH253",
          "name": "United Kingdom 1GB 7Days",
          "location_code": "GB",
          "retail_price_usd": 1.99,
          "volume_label": "1 GB",
          "duration": 7,
          "duration_unit": "DAY"
        }
      ]
    }
  ]
}

Los precios son retail en USD. uk_number cuesta $25, otp_code es un fijo de $12.99, y travel_data lista precios por paquete. Cachea unos minutos; refresca a diario.

Ejemplos ejecutables de cURL / Python / Node en GitHub

3Enlaza con atribución

La atribución es first-touch en una ventana de 90 días - gana el primer enlace que trae al visitante. Cualquier enlace con tu código cuenta - el enlace corto, una landing o un deep-link de producto. Los códigos de referido no distinguen mayúsculas: TIKTOK, tiktok y TikTok resuelven al mismo código.

Short link (all products):
  https://buyukesim.com/r/YOUR_CODE

Landing with attribution:
  https://buyukesim.com/en/?ref=YOUR_CODE

Deep-link a single product:
  https://buyukesim.com/en/uk-esim/?ref=YOUR_CODE
  https://buyukesim.com/en/one-time-code/?ref=YOUR_CODE
  https://buyukesim.com/en/travel-esim/?ref=YOUR_CODE

The catalog API returns each product's url with ?ref= already appended
when you pass ?ref=YOUR_CODE - just render those.

4Sigue ventas y comisión

Tu panel privado muestra pedidos atribuidos, ingresos, comisión ganada, pagado y saldo en tiempo real - también disponible como JSON para integrarlo en tu propio dashboard:

GET https://buyukesim.com/api/affiliate_panel.php?code=YOUR_CODE&token=YOUR_PANEL_TOKEN

{ "commission_pct": 20, "paid_orders": 42, "revenue_usd": 1050.00, "earned_usd": 210.00, "balance_usd": 60.00 }

Tu token es privado - se emite con tu cuenta, nunca lo expongas en el cliente.

5Comisión y pagos

La comisión es un porcentaje de los ingresos retail sobre pedidos atribuidos y pagados - en todos los productos (Número UK, Código de un uso, eSIM de viaje, bundles) - más recargas de clientes que referiste (emparejados por email). Tu tasa se acuerda al unirte. Los pagos se hacen en cripto a pedido cuando tu saldo supera un pequeño mínimo. Sin comisiones, sin permanencia.

¿Listo para listar nuestros productos?

Obtén un código de referido y tu tasa de comisión, luego obtén el catálogo y publica.