Desarrolladores

POST /v1/quotes
x-api-key: sk_live_...
x-api-secret: ...

{
  "source_kind": "usdt",
  "dest_kind": "recarga",
  "amount_in": 20
}

POST /v1/orders
Idempotency-Key: order-8891

{ "quote_id": "<quote_id>" }

GET /v1/orders/<id>
GET /v1/catalog?country=CU&kind=topup

Misma autenticación x-api-key / x-api-secret y webhooks firmados con HMAC (avisos automáticos a tu sistema, con firma para comprobar que vienen de nosotros) que la API de envíos. Las cotizaciones caducan a los 60 segundos: pide otra y ya.

Solo sk_test_. La respuesta HTTP es la decisión real; no hay entrega simulada.

Ingresa una clave sandbox para probar.

GET /v1/products?country=CU
x-client-id: sm_test_id_...
x-client-secret: sm_test_sk_...

{
  "product_id": "SM-CU-CUBACEL-500",
  "country": "CU",
  "operator": "Cubacel",
  "recipient_value": 500,
  "recipient_currency": "CUP",
  "price": 18.95,
  "currency": "USD",
  "promo": "Datos ilimitados 24h x 10 dias"
}

price es el precio de tu propia lista. Nunca se devuelven costos de compra, precios de la cuenta superior ni nombres de proveedores. El campo promo cambia: las promociones de Cuba rotan, así que léelo siempre y no lo fijes en tu código.

POST /v1/topups
Idempotency-Key: shop-88213
x-client-id: sm_test_id_...
x-client-secret: sm_test_sk_...

{
  "product_id": "SM-CU-CUBACEL-500",
  "phone": "+53 5 555 0101",
  "reference": "ticket-4471"
}

GET /v1/topups/<id>

Permisos (scopes): catalog:read, prices:read, transactions:create, transactions:read, balance:read. Cada llamada se cobra de tu saldo prepagado con su propia línea en el registro — si la entrega falla, se libera la reserva y no se te cobra.

Abre cuentas por moneda, da números para recibir (ACH en EE. UU., SEPA en Europa), añade fondos, retira con un código de confirmación y mueve o cambia dinero entre tus cuentas.

GET  /v1/banking
POST /v1/banking/accounts            { currency }
POST /v1/banking/receiving-numbers   { account_id, alias }
POST /v1/banking/payins              { account_id, method, amount }
POST /v1/banking/payouts             { account_id, method, amount }
POST /v1/banking/payouts/{id}/confirm { code }
POST /v1/banking/transfers           { from_account_id, to_account_id, amount }
POST /v1/banking/fx                  { from_account_id, to_account_id, amount, execute }

Auth: business keys · scopes banking:read, banking:write

Público, sin clave. Lee países y paquetes abiertos, el ranking de precios en vivo con el vendedor legal de cada uno, el más barato por paquete, y reserva un precio para un número antes de mandar al cliente a pagar. Nunca devuelve ofertas de prueba ni Cuba.

GET  /v1/precio-abierto/catalog?country=BO
GET  /v1/precio-abierto/board?operator_id=<uuid>&currency=USD
GET  /v1/precio-abierto/winners?country=BO
POST /v1/precio-abierto/quotes       { product_id, currency, phone, offer_id? }

Auth: none (public)

El catálogo de gift cards y luego la misma cotización/orden que cualquier producto. Las tasas orientativas están en /v1/rates; el precio real siempre llega con la cotización.

GET  /v1/gift-cards?country=US
GET  /v1/rates?from=USD&to=EUR
POST /v1/quotes
POST /v1/orders

Auth: agency or business keys

Consulta el saldo de tu clave, cada abono y cargo con el saldo después de cada línea, los códigos que emitiste, y crea nuevos para revender (se registra tu comisión del 2,5 %).

GET  /v1/ia/wallet
GET  /v1/ia/ledger?limit=50
GET  /v1/ia/vouchers
POST /v1/ia/vouchers                 { face_credits: 100|300|500|1000 }
POST /api/public/ia/chat             { message }

Auth: Authorization: Bearer ria_…

Tus tiendas con sus contratos y ventas en mostrador, una página de pago que abres desde tu sistema, y los planes de software que alquilamos.

GET  /v1/stores
POST /v1/checkout-sessions           { product_id, recipient, client_reference }
GET  /v1/plans
GET  /api/public/app/{slug}/config

Auth: business keys · scopes stores:read, checkout:create · plans are public