Compras dentro de la aplicación

​

Información general

npm install @elata-biosciences/app-payments

​

Crea tu catálogo

​

El flujo correcto

import {
  getCatalog,
  getOwnedItems,
  requestPurchase,
  AppPaymentsError,
} from '@elata-biosciences/app-payments';

const formatUsdc = (base: string) => `$${(Number(base) / 1e6).toFixed(2)}`;

// 1. Read the catalog and what the user already owns.
const [items, owned] = await Promise.all([getCatalog(), getOwnedItems()]);
const ownedSet = new Set(owned);

// 2. Re-apply benefits on startup. Elata is the source of truth,
//    so this survives reloads and device changes.
for (const id of owned) applyBenefit(id);

// 3. Buy, then branch on status.
async function buy(item) {
  try {
    const result = await requestPurchase({
      contentId: item.contentId,
      priceUsdc: formatUsdc(item.priceUsdc), // display hint only
      title: item.title,
    });
    if (result.status === 'success') {
      ownedSet.add(item.contentId);
      applyBenefit(item.contentId);
    } else if (result.status === 'error') {
      showError(result.error);
    }
    // 'cancelled': the user backed out. Do nothing.
  } catch (err) {
    // Only thrown for local problems: no parent frame, bad input, timeout.
    showError(err instanceof AppPaymentsError ? err.code : String(err));
  }
}

​

Cosas que debes saber

​

Errores

​

Modelo de seguridad

• Los registros de compra de Elata se crean después de la verificación de pago del lado del servidor. Su interfaz de usuario debe utilizar consultas de propiedad del host como fuente de verdad.
• Su aplicación nunca ve detalles de pago, claves de billetera o tokens de sesión.
• Reproducir una solicitud de grabación con el mismo requestId es idempotente. Esto no hace que enviar un segundo pago en cadena sea seguro.
• El divisor deduce la tarifa de la plataforma configurada y envía la parte del creador a la billetera de pagos. Consulte Ingresos y pagos.

​

Pruébalo

• examples/iap-demo: un archivo HTML autónomo con un almacén simulado incorporado, para que pueda ejecutar el flujo completo localmente.
• Paquete README en npm

​

Estados de pago y UI

​

Prueba tu integración

• Vuelva a abrir la aplicación y restaure los beneficios que ya posee de la propiedad del host.
• Mostrar Utilice o Propiedad para artículos comprados y Comprar para artículos disponibles sin propietario.
• Maneje una respuesta exitosa que ya sea de propiedad con un hash de transacción vacío.
• Maneje los estados de cierre de sesión, cancelación, fondos insuficientes, pago no disponible y error de búsqueda.
• Desactive un artículo y verifique que los propietarios existentes aún puedan utilizar su beneficio.