Headers requeridos

Query params

Ejemplo cURL

curl -X GET 'https://api.innovapp-soft.com/v2/rates?country=CU' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/rates?country=CU', {
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json'
  }
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "ok",
    "message": "OK",
    "data": {
        "version": 2,
        "country": "CU",
        "base": "USD",
        "sections": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

Notas

• /v2/tasas es un alias compatible de /v2/rates.
• Para nuevas integraciones usa /v2/rates.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/catalog/list' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/catalog/list', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.catalog.list.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/topups/catalog' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"mode":"countries","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/topups/catalog', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "mode": "countries",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.topups.catalog.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/topups/promo' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"country":"CU","brand":"Cubacel","offer_id":"61","promo_code":"PROMO2026","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/topups/promo', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "country": "CU",
    "brand": "Cubacel",
    "offer_id": "61",
    "promo_code": "PROMO2026",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.topups.promo.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/topups/buy' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"country":"CU","brand":"Cubacel","offer_id":"61","phone_number":"+5351234567","client_purchase_id":"topup-2026-000184","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/topups/buy', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "country": "CU",
    "brand": "Cubacel",
    "offer_id": "61",
    "phone_number": "+5351234567",
    "client_purchase_id": "topup-2026-000184",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.topups.buy.ok",
    "message": "OK",
    "data": {
        "status": "pending",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/topups/orders' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"page":1,"per_page":20,"language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/topups/orders', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "page": 1,
    "per_page": 20,
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.topups.orders.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/topups/status' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"order_id":"1842","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/topups/status', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "order_id": "1842",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.topups.status.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/giftcards/catalog' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"mode":"countries","country":"US","page":1,"per_page":20,"language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/giftcards/catalog', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "mode": "countries",
    "country": "US",
    "page": 1,
    "per_page": 20,
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.giftcards.catalog.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/giftcards/buy' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"brand":"Amazon","country":"US","offer_id":"amazon-us-25","client_purchase_id":"gift-2026-000184","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/giftcards/buy', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "brand": "Amazon",
    "country": "US",
    "offer_id": "amazon-us-25",
    "client_purchase_id": "gift-2026-000184",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.giftcards.buy.ok",
    "message": "OK",
    "data": {
        "status": "pending",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/giftcards/orders' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"page":1,"per_page":20,"language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/giftcards/orders', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "page": 1,
    "per_page": 20,
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.giftcards.orders.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/giftcards/status' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"order_id":"1842","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/giftcards/status', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "order_id": "1842",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.giftcards.status.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/imei/catalog' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"page":1,"per_page":20,"search":"iPhone","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/imei/catalog', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "page": 1,
    "per_page": 20,
    "search": "iPhone",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.imei.catalog.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/imei/buy' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"service_id":"115","input":{"IMEI":"356938035643809"},"client_purchase_id":"imei-2026-000184","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/imei/buy', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "service_id": "115",
    "input": {
        "IMEI": "356938035643809"
    },
    "client_purchase_id": "imei-2026-000184",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.imei.buy.ok",
    "message": "OK",
    "data": {
        "status": "pending",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/imei/orders' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"page":1,"per_page":20,"language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/imei/orders', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "page": 1,
    "per_page": 20,
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.imei.orders.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/imei/status' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"order_id":"1842","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/imei/status', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "order_id": "1842",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.imei.status.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/esim/catalog' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"mode":"countries","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/esim/catalog', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "mode": "countries",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.esim.catalog.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/esim/buy' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"country":"US","offer_id":"esim-us-10gb","client_purchase_id":"esim-2026-000184","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/esim/buy', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "country": "US",
    "offer_id": "esim-us-10gb",
    "client_purchase_id": "esim-2026-000184",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.esim.buy.ok",
    "message": "OK",
    "data": {
        "status": "pending",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/esim/orders' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"page":1,"per_page":20,"language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/esim/orders', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "page": 1,
    "per_page": 20,
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.esim.orders.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/esim/status' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"order_id":"1842","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/esim/status', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "order_id": "1842",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.esim.status.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/virtual-numbers/catalog' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"country":"US","limit":20,"language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/virtual-numbers/catalog', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "country": "US",
    "limit": 20,
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.virtual_numbers.catalog.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/virtual-numbers/rent' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"country":"US","e164":"+12125550123","client_purchase_id":"number-2026-000184","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/virtual-numbers/rent', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "country": "US",
    "e164": "+12125550123",
    "client_purchase_id": "number-2026-000184",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.virtual_numbers.rent.ok",
    "message": "OK",
    "data": {
        "status": "pending",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/virtual-numbers/numbers' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"page":1,"per_page":20,"language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/virtual-numbers/numbers', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "page": 1,
    "per_page": 20,
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.virtual_numbers.numbers.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/virtual-numbers/status' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"number_id":"vn_1842","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/virtual-numbers/status', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "number_id": "vn_1842",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.virtual_numbers.status.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/virtual-numbers/messages' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"number_id":"vn_1842","limit":20,"cursor":0,"language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/virtual-numbers/messages', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "number_id": "vn_1842",
    "limit": 20,
    "cursor": 0,
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.virtual_numbers.messages.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/virtual-numbers/conversations' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"number_id":"vn_1842","page":1,"per_page":20,"language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/virtual-numbers/conversations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "number_id": "vn_1842",
    "page": 1,
    "per_page": 20,
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.virtual_numbers.conversations.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/virtual-numbers/mark-read' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"number_id":"vn_1842","message_id":509,"language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/virtual-numbers/mark-read', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "number_id": "vn_1842",
    "message_id": 509,
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.virtual_numbers.mark_read.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/store/virtual-numbers/auto-renew' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"number_id":"vn_1842","auto_renew":true,"client_request_id":"renew-2026-000184","language":"es"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/store/virtual-numbers/auto-renew', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "number_id": "vn_1842",
    "auto_renew": true,
    "client_request_id": "renew-2026-000184",
    "language": "es"
})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "store.virtual_numbers.auto_renew.ok",
    "message": "OK",
    "data": {
        "status": "available",
        "items": []
    },
    "error": [],
    "time": "2026-07-29T15:30:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 40101,
    "message": "Invalid API key."
}

{
    "success": false,
    "code": 47017,
    "message": "Required field is missing: client_purchase_id"
}

{
    "success": false,
    "code": 47020,
    "message": "The Store service is temporarily unavailable."
}

Notas

• No envies userIdentifier: el usuario KeyPay se obtiene del developer autenticado.
• Las compras requieren client_purchase_id unico. Si repites la misma solicitud usa exactamente el mismo valor.
• El catalogo determina los identificadores, montos y campos validos; no construyas offer_id, service_id ni e164 manualmente.
• La API puede devolver pending, processing, completed, failed o refunded segun el producto.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/deposits/crypto/methods' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "language": "es"
}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/deposits/crypto/methods', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({"language":"es"})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "deposits.crypto.methods.ok",
    "message": "OK",
    "data": {
        "catalog": [
            {
                "name": "Criptomonedas",
                "methods": [
                    {
                        "tick": "USDT",
                        "min_amount": 20,
                        "max_amount": "1000000.000"
                    }
                ]
            }
        ]
    },
    "error": [],
    "time": "2026-07-31T10:00:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 10023,
    "message": "Unauthorized."
}

{
    "success": false,
    "code": 48007,
    "message": "The amount is invalid."
}

{
    "success": false,
    "code": 48012,
    "message": "Finance API V2 is not ready. Apply the finance migration first."
}

Notas

• No envies userIdentifier: se usa el usuario KeyPay vinculado al developer autenticado.
• client_reference es obligatoria al crear y evita duplicar la operacion. Reutilizala solamente para reintentar la misma solicitud.
• Guarda siempre el campo data.id. Las consultas get aceptan el ID Developer, no el identificador interno de KeyPay.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/deposits/crypto/create' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": 100,
    "currency": "USDT",
    "client_reference": "deposit-2026-000184",
    "customer_reference": "customer-8291",
    "description": "Recarga de saldo",
    "metadata": {
        "invoice_id": "INV-184"
    },
    "language": "es"
}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/deposits/crypto/create', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({"amount":100,"currency":"USDT","client_reference":"deposit-2026-000184","customer_reference":"customer-8291","description":"Recarga de saldo","metadata":{"invoice_id":"INV-184"},"language":"es"})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "deposits.crypto.create.ok",
    "message": "OK",
    "data": {
        "deposit": {
            "id": "dep_09f4c71092d30b86e30e6ee284c491dd",
            "type": "crypto_deposit",
            "status": "pending",
            "client_reference": "deposit-2026-000184",
            "details": {
                "crypto": {
                    "wallet": "TXxxxxxxxx",
                    "memo": "",
                    "coin_amount": "99.50",
                    "expires_at": "2026-07-31 10:29:00"
                },
                "next_action": "check_crypto"
            }
        },
        "idempotent_replay": false
    },
    "error": [],
    "time": "2026-07-31T10:00:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 10023,
    "message": "Unauthorized."
}

{
    "success": false,
    "code": 48007,
    "message": "The amount is invalid."
}

{
    "success": false,
    "code": 48012,
    "message": "Finance API V2 is not ready. Apply the finance migration first."
}

Notas

• No envies userIdentifier: se usa el usuario KeyPay vinculado al developer autenticado.
• client_reference es obligatoria al crear y evita duplicar la operacion. Reutilizala solamente para reintentar la misma solicitud.
• Guarda siempre el campo data.id. Las consultas get aceptan el ID Developer, no el identificador interno de KeyPay.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/deposits/crypto/list' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "page": 1,
    "per_page": 20,
    "status": "completed",
    "customer_reference": "customer-8291",
    "language": "es"
}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/deposits/crypto/list', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({"page":1,"per_page":20,"status":"completed","customer_reference":"customer-8291","language":"es"})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "deposits.crypto.list.ok",
    "message": "OK",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 20,
            "total": 0
        }
    },
    "error": [],
    "time": "2026-07-31T10:00:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 10023,
    "message": "Unauthorized."
}

{
    "success": false,
    "code": 48007,
    "message": "The amount is invalid."
}

{
    "success": false,
    "code": 48012,
    "message": "Finance API V2 is not ready. Apply the finance migration first."
}

Notas

• No envies userIdentifier: se usa el usuario KeyPay vinculado al developer autenticado.
• client_reference es obligatoria al crear y evita duplicar la operacion. Reutilizala solamente para reintentar la misma solicitud.
• Guarda siempre el campo data.id. Las consultas get aceptan el ID Developer, no el identificador interno de KeyPay.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/deposits/crypto/get' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "dep_09f4c71092d30b86e30e6ee284c491dd",
    "language": "es"
}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/deposits/crypto/get', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({"id":"dep_09f4c71092d30b86e30e6ee284c491dd","language":"es"})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "deposits.crypto.get.ok",
    "message": "OK",
    "data": {
        "deposit": {
            "id": "dep_09f4c71092d30b86e30e6ee284c491dd",
            "status": "completed",
            "client_reference": "deposit-2026-000184"
        }
    },
    "error": [],
    "time": "2026-07-31T10:00:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 10023,
    "message": "Unauthorized."
}

{
    "success": false,
    "code": 48007,
    "message": "The amount is invalid."
}

{
    "success": false,
    "code": 48012,
    "message": "Finance API V2 is not ready. Apply the finance migration first."
}

Notas

• No envies userIdentifier: se usa el usuario KeyPay vinculado al developer autenticado.
• client_reference es obligatoria al crear y evita duplicar la operacion. Reutilizala solamente para reintentar la misma solicitud.
• Guarda siempre el campo data.id. Las consultas get aceptan el ID Developer, no el identificador interno de KeyPay.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/withdrawals/methods' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "language": "es"
}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/withdrawals/methods', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({"language":"es"})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "withdrawals.methods.ok",
    "message": "OK",
    "data": {
        "groups": [
            {
                "name": "Criptomonedas",
                "methods": [
                    {
                        "tick": "TRX",
                        "min_amount": "5.000",
                        "max_amount": "5000.000"
                    }
                ]
            }
        ]
    },
    "error": [],
    "time": "2026-07-31T10:00:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 10023,
    "message": "Unauthorized."
}

{
    "success": false,
    "code": 48007,
    "message": "The amount is invalid."
}

{
    "success": false,
    "code": 48012,
    "message": "Finance API V2 is not ready. Apply the finance migration first."
}

Notas

• No envies userIdentifier: se usa el usuario KeyPay vinculado al developer autenticado.
• client_reference es obligatoria al crear y evita duplicar la operacion. Reutilizala solamente para reintentar la misma solicitud.
• Guarda siempre el campo data.id. Las consultas get aceptan el ID Developer, no el identificador interno de KeyPay.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/withdrawals/method' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "tick": "TRX",
    "language": "es"
}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/withdrawals/method', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({"tick":"TRX","language":"es"})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "withdrawals.method.ok",
    "message": "OK",
    "data": {
        "membership_tier": "gold",
        "method": {
            "tick": "TRX",
            "name": "TRX",
            "destination": {
                "label": "Wallet",
                "fields": [
                    {
                        "key": "Wallet",
                        "label": "Wallet",
                        "type": "text",
                        "required": true
                    }
                ]
            }
        }
    },
    "error": [],
    "time": "2026-07-31T10:00:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 10023,
    "message": "Unauthorized."
}

{
    "success": false,
    "code": 48007,
    "message": "The amount is invalid."
}

{
    "success": false,
    "code": 48012,
    "message": "Finance API V2 is not ready. Apply the finance migration first."
}

Notas

• No envies userIdentifier: se usa el usuario KeyPay vinculado al developer autenticado.
• client_reference es obligatoria al crear y evita duplicar la operacion. Reutilizala solamente para reintentar la misma solicitud.
• Guarda siempre el campo data.id. Las consultas get aceptan el ID Developer, no el identificador interno de KeyPay.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/withdrawals/preview' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "tick": "TRX",
    "amount": 100,
    "language": "es"
}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/withdrawals/preview', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({"tick":"TRX","amount":100,"language":"es"})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "withdrawals.preview.ok",
    "message": "OK",
    "data": {
        "amount_requested": "100.000",
        "system_fee_percent": "1.0000",
        "amount_after_system_fee": "99.000",
        "amount_to_send_usd": "97.218"
    },
    "error": [],
    "time": "2026-07-31T10:00:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 10023,
    "message": "Unauthorized."
}

{
    "success": false,
    "code": 48007,
    "message": "The amount is invalid."
}

{
    "success": false,
    "code": 48012,
    "message": "Finance API V2 is not ready. Apply the finance migration first."
}

Notas

• No envies userIdentifier: se usa el usuario KeyPay vinculado al developer autenticado.
• client_reference es obligatoria al crear y evita duplicar la operacion. Reutilizala solamente para reintentar la misma solicitud.
• Guarda siempre el campo data.id. Las consultas get aceptan el ID Developer, no el identificador interno de KeyPay.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/withdrawals/create' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "tick": "TRX",
    "amount": 100,
    "destination": {
        "Wallet": "TXxxxxxxxx"
    },
    "client_reference": "withdraw-2026-000184",
    "customer_reference": "customer-8291",
    "description": "Retiro semanal",
    "metadata": {
        "invoice_id": "INV-184"
    },
    "language": "es"
}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/withdrawals/create', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({"tick":"TRX","amount":100,"destination":{"Wallet":"TXxxxxxxxx"},"client_reference":"withdraw-2026-000184","customer_reference":"customer-8291","description":"Retiro semanal","metadata":{"invoice_id":"INV-184"},"language":"es"})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "withdrawals.create.ok",
    "message": "OK",
    "data": {
        "withdrawal": {
            "id": "wd_09f4c71092d30b86e30e6ee284c491dd",
            "type": "withdrawal",
            "status": "processing",
            "client_reference": "withdraw-2026-000184"
        },
        "idempotent_replay": false
    },
    "error": [],
    "time": "2026-07-31T10:00:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 10023,
    "message": "Unauthorized."
}

{
    "success": false,
    "code": 48007,
    "message": "The amount is invalid."
}

{
    "success": false,
    "code": 48012,
    "message": "Finance API V2 is not ready. Apply the finance migration first."
}

Notas

• No envies userIdentifier: se usa el usuario KeyPay vinculado al developer autenticado.
• client_reference es obligatoria al crear y evita duplicar la operacion. Reutilizala solamente para reintentar la misma solicitud.
• Guarda siempre el campo data.id. Las consultas get aceptan el ID Developer, no el identificador interno de KeyPay.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/withdrawals/list' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "page": 1,
    "per_page": 20,
    "status": "completed",
    "customer_reference": "customer-8291",
    "language": "es"
}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/withdrawals/list', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({"page":1,"per_page":20,"status":"completed","customer_reference":"customer-8291","language":"es"})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "withdrawals.list.ok",
    "message": "OK",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 20,
            "total": 0
        }
    },
    "error": [],
    "time": "2026-07-31T10:00:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 10023,
    "message": "Unauthorized."
}

{
    "success": false,
    "code": 48007,
    "message": "The amount is invalid."
}

{
    "success": false,
    "code": 48012,
    "message": "Finance API V2 is not ready. Apply the finance migration first."
}

Notas

• No envies userIdentifier: se usa el usuario KeyPay vinculado al developer autenticado.
• client_reference es obligatoria al crear y evita duplicar la operacion. Reutilizala solamente para reintentar la misma solicitud.
• Guarda siempre el campo data.id. Las consultas get aceptan el ID Developer, no el identificador interno de KeyPay.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v2/withdrawals/get' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "wd_09f4c71092d30b86e30e6ee284c491dd",
    "language": "es"
}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v2/withdrawals/get', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({"id":"wd_09f4c71092d30b86e30e6ee284c491dd","language":"es"})
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "withdrawals.get.ok",
    "message": "OK",
    "data": {
        "withdrawal": {
            "id": "wd_09f4c71092d30b86e30e6ee284c491dd",
            "status": "completed",
            "client_reference": "withdraw-2026-000184"
        }
    },
    "error": [],
    "time": "2026-07-31T10:00:00-04:00"
}

Ejemplos de error

{
    "success": false,
    "code": 10023,
    "message": "Unauthorized."
}

{
    "success": false,
    "code": 48007,
    "message": "The amount is invalid."
}

{
    "success": false,
    "code": 48012,
    "message": "Finance API V2 is not ready. Apply the finance migration first."
}

Notas

• No envies userIdentifier: se usa el usuario KeyPay vinculado al developer autenticado.
• client_reference es obligatoria al crear y evita duplicar la operacion. Reutilizala solamente para reintentar la misma solicitud.
• Guarda siempre el campo data.id. Las consultas get aceptan el ID Developer, no el identificador interno de KeyPay.

Headers requeridos

Body params

Ejemplo cURL

# Tu servidor recibe un POST en la URL configurada.
# Verifica X-InnovappSoft-Signature antes de procesar el body.

Ejemplo JavaScript

const expected = hmacSha256(secret, timestamp + '.' + rawBody);
if (!timingSafeEqual(signature, expected)) throw new Error('Invalid signature');

Respuesta exitosa

{
    "event": "withdrawal.completed",
    "sent_at": "2026-07-31 10:00:00",
    "developer": {
        "id": 4,
        "name": "Mi empresa",
        "app_name": "Mi aplicacion"
    },
    "api_key": {
        "id": 14,
        "label": "Produccion",
        "key_prefix": "dk_live_0c953c"
    },
    "data": {
        "id": "wd_09f4c71092d30b86e30e6ee284c491dd",
        "type": "withdrawal",
        "status": "completed",
        "client_reference": "withdraw-2026-000184",
        "customer_reference": "customer-8291",
        "description": "Retiro semanal",
        "amount": "100.000",
        "currency": "TRX",
        "destination": {
            "Wallet": "TXxxxxxxxx"
        },
        "metadata": {
            "invoice_id": "INV-184"
        }
    }
}

Notas

• Eventos: crypto_deposit.completed, crypto_deposit.expired, withdrawal.completed, withdrawal.cancelled y withdrawal.failed_refunded.
• La firma es HMAC-SHA256 usando como mensaje timestamp + punto + body JSON crudo y como clave el secret del webhook.
• Responde con HTTP 2xx. Las entregas fallidas quedan registradas y pueden reenviarse desde el portal.
• Los webhooks pueden entregarse mas de una vez ante fallos de red. Deduplica usando X-InnovappSoft-Delivery o la combinacion event + data.id.

Headers requeridos

Query params

Ejemplo cURL

curl -X GET 'https://api.innovapp-soft.com/v1/tasas?country=CU' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v1/tasas?country=CU', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json'
  }
})
.then(r => r.json())
.then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "ok",
    "message": "OK",
    "data": {
        "status": "true",
        "message": "ok",
        "version": "1",
        "scope": "cuba",
        "base": "USD",
        "date": "2026-06-22",
        "updated_at": "2026-06-22 20:30:53",
        "country": {
            "code": "CU",
            "name": "Cuba",
            "currency": "CUP",
            "supported": true
        },
        "countries": [
            {
                "code": "GLOBAL",
                "name": "Global",
                "currency": "USD",
                "supported": true
            },
            {
                "code": "CU",
                "name": "Cuba",
                "currency": "CUP",
                "supported": true
            },
            {
                "code": "MX",
                "name": "Mexico",
                "currency": "MXN",
                "supported": true
            }
        ],
        "history": {
            "today": {
                "date": "2026-06-22",
                "updated_at": "2026-06-22 20:30:53"
            },
            "yesterday": {
                "date": "2026-06-21",
                "updated_at": "2026-06-21 20:30:53"
            },
            "week": {
                "date": "2026-06-15",
                "updated_at": "2026-06-15 20:30:53"
            }
        },
        "sections": [
            {
                "id": "innovapp",
                "title": "InnovappSoft KeyCoin",
                "base": "KCOIN",
                "unit": "currency per 1 KCOIN",
                "rates": [
                    {
                        "code": "CUP",
                        "name": "Cuban Peso",
                        "value": 700,
                        "yesterday": 690,
                        "week": 680,
                        "change": 10,
                        "change_week": 20,
                        "source": "cuba_p2p_kcoin",
                        "image_url": "https://innovapp-soft.com/assets/img/tasas/CUP.png",
                        "image_png": "https://innovapp-soft.com/assets/img/tasas/CUP.png",
                        "image_jpg": "https://innovapp-soft.com/assets/img/tasas/CUP.jpg",
                        "image_fallback": "CU"
                    }
                ]
            },
            {
                "id": "eltoque",
                "title": "elToque",
                "base": "CUP",
                "unit": "CUP per 1 unit",
                "rates": [
                    {
                        "code": "USD",
                        "name": "US Dollar",
                        "value": 695,
                        "yesterday": 690,
                        "week": 680,
                        "change": 5,
                        "change_week": 15,
                        "source": "cu_eltoque_trmi",
                        "image_url": "https://innovapp-soft.com/assets/img/tasas/USD.png",
                        "image_png": "https://innovapp-soft.com/assets/img/tasas/USD.png",
                        "image_jpg": "https://innovapp-soft.com/assets/img/tasas/USD.jpg",
                        "image_fallback": "US"
                    }
                ]
            }
        ]
    },
    "error": []
}

Ejemplos de error

{
    "success": false,
    "code": 10023,
    "message": "Unauthorized",
    "data": [],
    "error": []
}

Notas

• La autenticacion se envia siempre en el header Authorization con formato Bearer.
• data.sections es la parte recomendada para UI: cada seccion trae rates con value, yesterday, week, change y change_week.
• country=GLOBAL devuelve comparativas globales contra USD. country=CU devuelve las fuentes cubanas. Otros paises devuelven tasas contra la moneda local del pais.
• EUR y ECU se normalizan como EUR.
• Cada rate incluye image_url, image_png, image_jpg e image_fallback para que la app pueda mostrar iconos de moneda con fallback.

Headers requeridos

Query params

Ejemplo cURL

curl -X GET 'https://api.innovapp-soft.com/v1/store/mobile_topup?category=Mobile-Top-Up' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v1/store/mobile_topup?category=Mobile-Top-Up', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json'
  }
})
.then(r => r.json())
.then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "ok",
    "message": "OK",
    "data": [
        {
            "id": "4f",
            "category": "Mobile-Top-Up",
            "title": "SUPER OFERTA 6GB 60 MIN 60 SMS",
            "details": [
                "6GB",
                "60 MIN",
                "60 SMS"
            ],
            "price": "21.00"
        },
        {
            "id": "4g",
            "category": "Mobile-Micro-Top-Up",
            "title": "Plan de saldo 250 CUP",
            "details": [
                "250 CUP"
            ],
            "price": "5.25"
        }
    ],
    "error": [],
    "time": {
        "datetime": "2026-04-22T18:10:00-04:00",
        "date": "2026-04-22",
        "time": "18:10:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1776895800
    }
}

Ejemplos de error

{
    "success": false,
    "code": 10023,
    "message": "Unauthorized",
    "data": [],
    "error": [],
    "time": {
        "datetime": "2026-04-22T18:10:00-04:00",
        "date": "2026-04-22",
        "time": "18:10:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1776895800
    }
}

{
    "success": false,
    "code": 45001,
    "message": "Method not allowed",
    "data": [],
    "error": {
        "details": "PUT"
    },
    "time": {
        "datetime": "2026-04-22T18:10:00-04:00",
        "date": "2026-04-22",
        "time": "18:10:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1776895800
    }
}

Notas

• El parámetro category es opcional.
• Valores soportados actualmente para category: Mobile-Top-Up y Mobile-Micro-Top-Up.
• El campo details puede traer un array descriptivo del plan.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v1/store/mobile_topup' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"id":"4f","phone":"51234567"}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v1/store/mobile_topup', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    id: '4f',
    phone: '51234567'
  })
})
.then(r => r.json())
.then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "ok",
    "message": "Purchase completed successfully.",
    "data": {
        "transation_id": "et_153_x9Ab3Kp2",
        "recharge_status": "Completed"
    },
    "error": [],
    "time": {
        "datetime": "2026-04-22T18:14:00-04:00",
        "date": "2026-04-22",
        "time": "18:14:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1776896040
    }
}

Ejemplos de error

{
    "success": false,
    "code": 46001,
    "message": "Operation in progress. Please check your history before buying again.",
    "data": [],
    "error": [],
    "time": {
        "datetime": "2026-04-22T18:14:00-04:00",
        "date": "2026-04-22",
        "time": "18:14:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1776896040
    }
}

{
    "success": false,
    "code": 46009,
    "message": "The phone number is invalid.",
    "data": [],
    "error": [],
    "time": {
        "datetime": "2026-04-22T18:14:00-04:00",
        "date": "2026-04-22",
        "time": "18:14:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1776896040
    }
}

{
    "success": false,
    "code": 46012,
    "message": "Insufficient credit.",
    "data": [],
    "error": [],
    "time": {
        "datetime": "2026-04-22T18:14:00-04:00",
        "date": "2026-04-22",
        "time": "18:14:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1776896040
    }
}

Notas

• El campo id debe ser exactamente el id devuelto por GET /v1/store/mobile_topup.
• El campo phone se valida y normaliza antes de enviar la recarga.
• El endpoint usa control de concurrencia por lock para evitar compras duplicadas.
• Si el débito de crédito ocurre y luego falla la compra, el crédito se revierte.
• El estado final devuelto hoy es transation_id + recharge_status.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v1/payment_links' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"amount":"25.00","currency":"KCOIN","external_reference":"ORDER-10045","title":"Payment request","description":"Recharge order","message":"Complete the payment from your KeyCard app","expires_in_minutes":60,"metadata":{"customer_id":"CUST-88"}}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v1/payment_links', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: '25.00',
    currency: 'KCOIN',
    external_reference: 'ORDER-10045',
    title: 'Payment request',
    description: 'Recharge order',
    message: 'Complete the payment from your KeyCard app',
    expires_in_minutes: 60,
    metadata: {
      customer_id: 'CUST-88'
    }
  })
})
.then(r => r.json())
.then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "ok",
    "message": "Payment link created successfully.",
    "data": {
        "payment_id": "6d4f21d15e7bc3d9276ea4f0d89ab21c",
        "payment_url": "https://keypay.innovapp-soft.com/pay/6d4f21d15e7bc3d9276ea4f0d89ab21c",
        "status": "pending",
        "amount": "25.000",
        "currency": "KCOIN",
        "external_reference": "ORDER-10045",
        "title": "Payment request",
        "description": "Recharge order",
        "message": "Complete the payment from your KeyCard app",
        "expires_at": "2026-06-02 19:30:00",
        "created_at": "2026-06-02 18:30:00"
    },
    "error": [],
    "time": {
        "datetime": "2026-06-02T18:30:00-04:00",
        "date": "2026-06-02",
        "time": "18:30:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1770100200
    }
}

Ejemplos de error

{
    "success": false,
    "code": 47001,
    "message": "Amount is required.",
    "data": [],
    "error": [],
    "time": {
        "datetime": "2026-06-02T18:30:00-04:00",
        "date": "2026-06-02",
        "time": "18:30:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1770100200
    }
}

{
    "success": false,
    "code": 47002,
    "message": "The amount is invalid.",
    "data": [],
    "error": [],
    "time": {
        "datetime": "2026-06-02T18:30:00-04:00",
        "date": "2026-06-02",
        "time": "18:30:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1770100200
    }
}

{
    "success": false,
    "code": 47009,
    "message": "The metadata is invalid.",
    "data": [],
    "error": [],
    "time": {
        "datetime": "2026-06-02T18:30:00-04:00",
        "date": "2026-06-02",
        "time": "18:30:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1770100200
    }
}

{
    "success": false,
    "code": 47012,
    "message": "Method not allowed",
    "data": [],
    "error": {
        "details": "GET"
    },
    "time": {
        "datetime": "2026-06-02T18:30:00-04:00",
        "date": "2026-06-02",
        "time": "18:30:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1770100200
    }
}

Notas

• El campo amount es obligatorio y acepta hasta 3 decimales.
• El campo currency hoy soporta KCOIN.
• El campo payment_id es generado por el sistema y no es predecible.
• El enlace público devuelto en payment_url debe abrirse desde la app o el flujo externo de pago.
• El cobro se crea inicialmente en estado pending.
• El usuario paga el monto del enlace. La liquidación al developer puede descontar el fee de payment link configurado por la plataforma.
• Ejemplo: si el enlace es de 100.000 KCOIN y el fee configurado es 2%, el usuario paga 100.000 KCOIN y el developer recibe 98.000 KCOIN.

Headers requeridos

Ejemplo cURL

curl -X GET 'https://api.innovapp-soft.com/v1/transactions' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v1/transactions', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json'
  }
})
.then(r => r.json())
.then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "ok",
    "message": "OK",
    "data": [
        {
            "payment_id": "6d4f21d15e7bc3d9276ea4f0d89ab21c",
            "status": "pending",
            "amount": "25.000",
            "currency": "KCOIN",
            "external_reference": "ORDER-10045",
            "title": "Payment request",
            "description": "Recharge order",
            "message": "Complete the payment from your KeyCard app",
            "paid_transaction_id": null,
            "paid_at": null,
            "expires_at": "2026-06-02 19:30:00",
            "created_at": "2026-06-02 18:30:00",
            "updated_at": "2026-06-02 18:30:00"
        },
        {
            "payment_id": "9f61ad13db19e6d2a80b8b6248ca5f88",
            "status": "paid",
            "amount": "14.500",
            "currency": "KCOIN",
            "external_reference": "ORDER-10046",
            "title": "Service payment",
            "description": "Premium service",
            "message": "Please complete your payment",
            "paid_transaction_id": "trx_4K91AB2",
            "paid_at": "2026-06-02 18:42:11",
            "expires_at": "2026-06-02 19:10:00",
            "created_at": "2026-06-02 18:10:00",
            "updated_at": "2026-06-02 18:42:11"
        }
    ],
    "error": [],
    "time": {
        "datetime": "2026-06-02T18:45:00-04:00",
        "date": "2026-06-02",
        "time": "18:45:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1770101100
    }
}

Ejemplos de error

{
    "success": false,
    "code": 47110,
    "message": "Unauthorized",
    "data": [],
    "error": [],
    "time": {
        "datetime": "2026-06-02T18:45:00-04:00",
        "date": "2026-06-02",
        "time": "18:45:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1770101100
    }
}

{
    "success": false,
    "code": 47111,
    "message": "Method not allowed",
    "data": [],
    "error": {
        "details": "POST"
    },
    "time": {
        "datetime": "2026-06-02T18:45:00-04:00",
        "date": "2026-06-02",
        "time": "18:45:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1770101100
    }
}

Notas

• Si no se envía un public_id en la ruta, el endpoint devuelve las últimas 10 transacciones del developer autenticado.
• La respuesta en data es un array.
• Cada elemento representa un payment link creado previamente.

Headers requeridos

Ejemplo cURL

curl -X GET 'https://api.innovapp-soft.com/v1/transactions/6d4f21d15e7bc3d9276ea4f0d89ab21c' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v1/transactions/6d4f21d15e7bc3d9276ea4f0d89ab21c', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json'
  }
})
.then(r => r.json())
.then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "ok",
    "message": "OK",
    "data": {
        "payment_id": "6d4f21d15e7bc3d9276ea4f0d89ab21c",
        "status": "pending",
        "amount": "25.000",
        "currency": "KCOIN",
        "external_reference": "ORDER-10045",
        "title": "Payment request",
        "description": "Recharge order",
        "message": "Complete the payment from your KeyCard app",
        "metadata": {
            "customer_id": "CUST-88"
        },
        "paid_transaction_id": null,
        "paid_at": null,
        "expires_at": "2026-06-02 19:30:00",
        "created_at": "2026-06-02 18:30:00",
        "updated_at": "2026-06-02 18:30:00"
    },
    "error": [],
    "time": {
        "datetime": "2026-06-02T18:45:00-04:00",
        "date": "2026-06-02",
        "time": "18:45:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1770101100
    }
}

Ejemplos de error

{
    "success": false,
    "code": 47103,
    "message": "The transaction does not exist.",
    "data": [],
    "error": [],
    "time": {
        "datetime": "2026-06-02T18:45:00-04:00",
        "date": "2026-06-02",
        "time": "18:45:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1770101100
    }
}

{
    "success": false,
    "code": 47102,
    "message": "The transaction identifier is invalid.",
    "data": [],
    "error": [],
    "time": {
        "datetime": "2026-06-02T18:45:00-04:00",
        "date": "2026-06-02",
        "time": "18:45:00",
        "timezone": "America/Kentucky/Louisville",
        "offset": "-04:00",
        "timestamp": 1770101100
    }
}

Notas

• El valor {public_id} debe ser el payment_id generado al crear el payment link.
• La respuesta en data es un objeto único.
• Solo el developer dueño de la transacción puede consultarla.

Headers requeridos

Body params

Ejemplo cURL

curl -X POST 'https://api.innovapp-soft.com/v1/payment_intents' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"amount":"10.00","currency":"KCOIN","external_reference":"ORDER-1001","title":"Premium purchase","return_url":"myapp://keypay-return","platform":"ios","bundle_id":"com.example.app","metadata":{"order_id":"1001"}}'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v1/payment_intents', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: '10.00',
    currency: 'KCOIN',
    external_reference: 'ORDER-1001',
    title: 'Premium purchase',
    return_url: 'myapp://keypay-return',
    platform: 'ios',
    bundle_id: 'com.example.app',
    metadata: { order_id: '1001' }
  })
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "ok",
    "message": "PaymentIntent created successfully.",
    "data": {
        "id": "pi_6d4f21d15e7bc3d9276ea4f0d89ab21c",
        "object": "payment_intent",
        "status": "requires_payment",
        "amount": "10.000",
        "currency": "KCOIN",
        "client_secret": "kpi_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "checkout_url": "https://keypay.innovapp-soft.com/pay/6d4f21d15e7bc3d9276ea4f0d89ab21c?intent=pi_...",
        "payment_link_id": "6d4f21d15e7bc3d9276ea4f0d89ab21c",
        "expires_at": "2026-06-16 19:30:00",
        "created_at": "2026-06-16 18:30:00"
    },
    "error": []
}

Notas

• Nunca coloques la API key dk_live dentro de iOS o Android.
• El backend del developer crea el PaymentIntent y entrega a la app solo client_secret + checkout_url.
• En esta versión el PaymentIntent está respaldado por el flujo existente de payment links.
• La confirmación final debe hacerse por webhook o consultando GET /v1/payment_intents/{id}.

Headers requeridos

Body params

Ejemplo cURL

git clone https://github.com/innovappsoft/KeyPayPaymentSDK.git

# O en Xcode:
# File > Add Package Dependencies > https://github.com/innovappsoft/KeyPayPaymentSDK.git
# Version: Up to Next Major desde 1.0.0

Ejemplo SwiftUI

import SwiftUI
import KeyPayPaymentSDK

@main
struct MyApp: App {
    init() {
        KeyPay.configure(
            paymentIntentEndpoint: URL(string: "https://tuapp.com/api/keypay/payment-intents")!,
            paymentStatusEndpoint: URL(string: "https://tuapp.com/api/keypay/payment-intents")!,
            returnURLScheme: "myapp",
            merchantDisplayName: "My App"
        )
    }

    var body: some Scene {
        WindowGroup { ContentView() }
    }
}

struct ContentView: View {
    @State private var status = ""

    var body: some View {
        KeyPayPaymentButton(
            request: KeyPayPaymentRequest(
                amount: 10,
                title: "Premium Plan",
                description: "Monthly subscription",
                externalReference: "order_1001",
                metadata: ["order_id": "1001"]
            )
        ) { result in
            switch result {
            case .succeeded(let intent): status = "Paid: \(intent.id)"
            case .pending(let intent): status = "Pending: \(intent.id)"
            case .cancelled: status = "Cancelled"
            case .failed(let error): status = error.localizedDescription
            }
        }
    }
}

Respuesta exitosa

{
    "package": "KeyPayPaymentSDK",
    "github": "https://github.com/innovappsoft/KeyPayPaymentSDK.git",
    "current_version": "v1.0.0",
    "product": "KeyPayPaymentSDK",
    "minimum_ios": "15.0",
    "main_components": [
        "KeyPay.configure",
        "KeyPayPaymentButton",
        "KeyPayPaymentSheet",
        "KeyPayPaymentRequest",
        "KeyPayPaymentResult"
    ]
}

Notas

• El proyecto del SDK está en GitHub: https://github.com/innovappsoft/KeyPayPaymentSDK.git
• Para instalar en Xcode usa File > Add Package Dependencies y pega la URL del repo.
• El developer no debe poner dk_live dentro de la app; dk_live vive solo en su backend.
• El backend del developer debe exponer POST /payment-intents y GET /payment-intents/{id}.
• El SDK incluye UI SwiftUI lista, traducciones EN/ES y sheet de pago tipo plug-and-play.
• Para publicar nuevas versiones crea tags semánticos como v1.0.1, v1.1.0 o v2.0.0.

Headers requeridos

Body params

Ejemplo cURL

1) Instalación recomendada con JitPack

settings.gradle.kts:
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://jitpack.io") }
    }
}

gradle/libs.versions.toml:
[versions]
keypaySdkVersion = "v1.0.1"

[libraries]
keypay-android-sdk = { module = "com.github.innovappsoft.KeyPayPaymentAndroidSDK:keypay-payment-sdk", version.ref = "keypaySdkVersion" }

app/build.gradle.kts:
dependencies {
    implementation(libs.keypay.android.sdk)
}

Importante:
- Usa v1.0.1 o superior. v1.0.0 no se debe usar para Gradle porque fue source-only y no tenía metadata Maven para JitPack.
- El módulo que se importa es keypay-payment-sdk. El módulo sample-app es solo una demo.
- Si JitPack todavía no terminó de construir el tag, espera unos minutos o usa la opción AAR local.

2) AndroidManifest para recibir el callback

<activity android:name="com.innovappsoft.keypay.payment.KeyPayReturnActivity" android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="myapp" android:host="keypay-return" />
    </intent-filter>
</activity>

El returnUrlScheme configurado en el SDK debe coincidir con android:scheme.
Ejemplo: returnUrlScheme = "myapp" usa myapp://keypay-return.

3) Opción de prueba local con AAR

En el repo del SDK:
./gradlew :keypay-payment-sdk:assembleRelease

Copia:
keypay-payment-sdk/build/outputs/aar/keypay-payment-sdk-release.aar

a:
app/libs/keypay-payment-sdk-release.aar

app/build.gradle.kts:
dependencies {
    implementation(files("libs/keypay-payment-sdk-release.aar"))
    implementation(libs.androidx.appcompat)
    implementation(libs.material)
}

Cuando se usa AAR local, Android no descarga dependencias transitivas automáticamente, por eso appcompat y material deben estar en la app.

4) Backend requerido del developer

La app nunca debe guardar dk_live. La API key vive en el backend del developer.
El backend debe exponer:
- POST /payment-intents para crear el PaymentIntent usando dk_live.
- GET /payment-intents/{id} para consultar estado y devolverlo a la app.

5) Errores comunes

Could not find com.github.innovappsoft.KeyPayPaymentAndroidSDK:keypay-payment-sdk:v1.0.0
Solución: usar v1.0.1 o superior, o probar con AAR local.

KeyPayReturnActivity aparece en rojo en Android Studio
Solución: la dependencia no está resuelta. Revisa JitPack, Sync Gradle o usa el AAR local.

Cannot generate dependency accessors
Solución: no dupliques alias en libs.versions.toml. Usa keypaySdkVersion para la versión y keypay-android-sdk para la librería.

AndroidX core 1.19 pide compileSdk 37 / AGP 9.1
Solución: baja coreKtx a 1.17.0 o actualiza compileSdk y Android Gradle Plugin.

Ejemplo Kotlin / Java

import com.innovappsoft.keypay.payment.KeyPay
import com.innovappsoft.keypay.payment.KeyPayCheckoutButton
import com.innovappsoft.keypay.payment.KeyPayConfiguration
import com.innovappsoft.keypay.payment.KeyPayPaymentRequest
import com.innovappsoft.keypay.payment.KeyPayPaymentResult

KeyPay.configure(
    KeyPayConfiguration(
        paymentIntentEndpoint = "https://tuapp.com/api/keypay/payment-intents",
        paymentStatusEndpoint = "https://tuapp.com/api/keypay/payment-intents",
        returnUrlScheme = "myapp",
        merchantDisplayName = "My App"
    )
)

val request = KeyPayPaymentRequest(
    amount = "10.00",
    title = "Premium Plan",
    description = "Monthly subscription",
    externalReference = "order_1001",
    metadata = mapOf("order_id" to "1001")
)

val button = KeyPayCheckoutButton(this).apply {
    configure(
        activity = this@MainActivity,
        request = request,
        callback = { result ->
            when (result.status) {
                KeyPayPaymentResult.Status.SUCCEEDED -> {}
                KeyPayPaymentResult.Status.PENDING -> {}
                KeyPayPaymentResult.Status.CANCELLED -> {}
                KeyPayPaymentResult.Status.FAILED -> {}
            }
        },
        title = "Pay with KeyPay"
    )
}

// Java compatible:
// KeyPay.configure(new KeyPayConfiguration(
//     "https://tuapp.com/api/keypay/payment-intents",
//     "https://tuapp.com/api/keypay/payment-intents",
//     "myapp",
//     "My App"
// ));
// KeyPay.startCheckout(this, request, result -> { });

Respuesta exitosa

{
    "package": "KeyPayPaymentAndroidSDK",
    "github": "https://github.com/innovappsoft/KeyPayPaymentAndroidSDK.git",
    "current_version": "v1.0.1",
    "product": "keypay-payment-sdk",
    "minimum_sdk": "API 24 / Android 7.0",
    "languages": [
        "Kotlin",
        "Java"
    ],
    "modules": [
        "keypay-payment-sdk",
        "sample-app"
    ],
    "main_components": [
        "KeyPay.configure",
        "KeyPayCheckoutButton",
        "KeyPayCheckoutActivity",
        "KeyPayPaymentRequest",
        "KeyPayPaymentResult",
        "KeyPayReturnActivity"
    ],
    "manifest_callback": "<activity android:name=\"com.innovappsoft.keypay.payment.KeyPayReturnActivity\" android:exported=\"true\"><intent-filter><action android:name=\"android.intent.action.VIEW\"/><category android:name=\"android.intent.category.DEFAULT\"/><category android:name=\"android.intent.category.BROWSABLE\"/><data android:scheme=\"myapp\" android:host=\"keypay-return\"/></intent-filter></activity>"
}

Ejemplos de error

[]

[]

[]

[]

Notas

• El proyecto del SDK Android está en GitHub: https://github.com/innovappsoft/KeyPayPaymentAndroidSDK.git
• Usa v1.0.1 o superior para JitPack. v1.0.0 fue una versión source-only y no tenía metadata Maven para Gradle.
• El módulo real de la librería es keypay-payment-sdk; sample-app es solo una app de ejemplo.
• Si Android Studio marca KeyPayReturnActivity en rojo, la dependencia no está resuelta: revisa JitPack, Sync Gradle o usa AAR local.
• Si Gradle dice Could not find com.github..., usa v1.0.1 o genera/copias el AAR local.
• Si Gradle dice Cannot generate dependency accessors, evita alias duplicados: usa keypaySdkVersion para la versión y keypay-android-sdk para la librería.
• Si AndroidX core 1.19 exige compileSdk 37 / AGP 9.1, baja coreKtx a 1.17.0 o actualiza AGP/compileSdk.
• El SDK incluye UI Android nativa, traducciones EN/ES y botón plug-and-play KeyPayCheckoutButton.
• Compatible con Kotlin y Java mediante API pública Java-friendly.
• El developer debe registrar el returnUrlScheme en AndroidManifest usando KeyPayReturnActivity.
• El developer no debe poner dk_live dentro de la app; dk_live vive solo en su backend.
• El backend del developer debe exponer POST /payment-intents y GET /payment-intents/{id}.
• Para publicar nuevas versiones crea tags semánticos como v1.0.2, v1.1.0 o v2.0.0.

Headers requeridos

Ejemplo cURL

curl -X GET 'https://api.innovapp-soft.com/v1/payment_intents/pi_6d4f21d15e7bc3d9276ea4f0d89ab21c' \
  -H 'Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json'

Ejemplo JavaScript

fetch('https://api.innovapp-soft.com/v1/payment_intents/pi_6d4f21d15e7bc3d9276ea4f0d89ab21c', {
  headers: {
    'Authorization': 'Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx',
    'Accept': 'application/json'
  }
}).then(r => r.json()).then(console.log);

Respuesta exitosa

{
    "success": true,
    "code": "ok",
    "message": "OK",
    "data": {
        "id": "pi_6d4f21d15e7bc3d9276ea4f0d89ab21c",
        "object": "payment_intent",
        "status": "succeeded",
        "amount": "10.000",
        "currency": "KCOIN",
        "paid_transaction_id": "trx_4K91AB2",
        "paid_at": "2026-06-16 18:42:11"
    },
    "error": []
}

Notas

• Este endpoint es para backend. No lo llames desde la app móvil con dk_live.
• El SDK móvil debe devolver control a tu app; tu backend confirma el estado real.