Volver a la guía

API: servicios, precios, pedidos, estado y refill

Parámetros y respuestas de acciones publicadas.

Última actualización:

Cómo funciona, paso a paso

  1. services devuelve un array con service, description, platform, min, max, rate, price_per_item, pricing_unit, refill, cancel y EUR. rate es referencia por 1000, no presupuesto para cualquier cantidad.
  2. balance consulta saldo. add requiere service, link y quantity. Conserva order, charge y currency. El motor del sitio calcula total y mínimos aplicables.
  3. Usa idempotency_key estable por compra y sus reintentos: opcional, máximo 120 caracteres y vinculada a la clave API.
  4. status acepta order u orders con hasta 100 ID numéricos separados por comas de tus propios pedidos API. start_count y remains son null.
  5. refill recibe order y devuelve un identificador si se acepta. No se publican acciones de estado refill o cancelación; cancel del catálogo no es un endpoint.

Atención

Estados API: Pending, In progress, Processing, Partial, Completed y Canceled. No deduzcas cantidades de null ni presupongas aceptación de refill.

Ejemplos API

services

curl --request POST https://nexwa.store/api/v2 \
  --header "Authorization: Bearer ${NEXWA_API_KEY}" \
  --data-urlencode "action=services"

balance

curl --request POST https://nexwa.store/api/v2 \
  --header "Authorization: Bearer ${NEXWA_API_KEY}" \
  --data-urlencode "action=balance"

add

curl --request POST https://nexwa.store/api/v2 \
  --header "Authorization: Bearer ${NEXWA_API_KEY}" \
  --data-urlencode "action=add" \
  --data-urlencode "service=${NEXWA_SERVICE_ID}" \
  --data-urlencode "link=${NEXWA_TARGET_URL}" \
  --data-urlencode "quantity=${NEXWA_QUANTITY}" \
  --data-urlencode "idempotency_key=${NEXWA_PURCHASE_ID}"

status

curl --request POST https://nexwa.store/api/v2 \
  --header "Authorization: Bearer ${NEXWA_API_KEY}" \
  --data-urlencode "action=status" \
  --data-urlencode "order=${NEXWA_ORDER_ID}"

refill

curl --request POST https://nexwa.store/api/v2 \
  --header "Authorization: Bearer ${NEXWA_API_KEY}" \
  --data-urlencode "action=refill" \
  --data-urlencode "order=${NEXWA_ORDER_ID}"

Referencia API pública

POST https://nexwa.store/api/v2
AcciónParámetrosRespuesta
servicesactionArray<{service, name, category, platform, type, rate, price_per_item, pricing_unit, description, min, max, refill, cancel, currency}>
balanceaction{balance, currency}
addaction, service, link, quantity, idempotency_key?{order, charge, currency, balance?} | {order, duplicate: true}
statusaction, order | orders{charge, start_count: null, status, remains: null, currency} | {"<order>": result}
refillaction, order{refill}

Abrir función

Claves APIPrecios

Artículos relacionados

¿Necesitas ayuda?

Abre soporte en tu cuenta para una consulta concreta. Si no puedes acceder, escribe por correo.

Abrir soporteEscribir por correo