Integración & API v1.0

Guía de Integración para Empresas y Sistemas

Aprende a integrar 1pay con puntos de venta (POS), software contable, ERPs y tiendas online mediante webhooks en tiempo real y SDKs de verificación.

1. Esquema de Tarifas & Licencias

Precios claros y sin comisiones por transacción, cotizados en dólares estadounidenses (USD):

Comercio Pyme

$15 USD / mes

1 teléfono receptor de cobranza, cobro en efectivo con cálculo de vuelto, soundbox TTS y 30 días gratis con cupón 1PAY30.

Empresas & Cadenas

$49 USD / mes

Múltiples sucursales y teléfonos receptores, webhook dedicado de alta concurrencia hacia ERP/POS y soporte prioritario.

2. Sandbox Interactivo de Pruebas

Prueba en vivo la verificación instantánea contra el ledger seguro de 1pay:

⚡ Consola de Verificación en Vivo ● Conectado a Firestore API

RESPUESTA HTTP JSON Latencia: -- ms

3. Patrón 1: Webhooks en Tiempo Real (Push)

Recomendado para 1tab, 1commerce, tiendas e-commerce y despachos automáticos:

Payload JSON Recibido en tu Endpoint

{
  "event": "PAYMENT_RECEIVED",
  "storeId": "cus_657cf98b",
  "bank": "Banco de Venezuela",
  "reference": "007373140250",
  "referenceSuffix4": "0250",
  "referenceSuffix6": "140250",
  "amount": "150.00",
  "currency": "VES",
  "type": "AUTO_RELAY",
  "timestamp": "2026-09-19T17:30:00.000Z",
  "rawNotification": "Pago Movil recibido por Bs. 150,00 ref 007373140250"
}

4. Patrón 2: SDKs de Verificación (Pull)

Para sistemas de punto de venta (POS físicos) o checkouts web que validan la referencia ingresada por el cliente:

import { verifyPayment } from 'https://pay-dev.1group.media/sdk/1pay.js';

// Verificación por los últimos 4 dígitos ingresados por el cliente
const payment = await verifyPayment({
  reference: '0250',
  amount: '150.00',
  storeId: 'cus_657cf98b'
});

if (payment.verified) {
  console.log(`✅ Pago aprobado: ${payment.amount} ${payment.currency} en ${payment.bank}`);
}

from onepay import OnePay

client = OnePay(store_id="cus_657cf98b")
payment = client.verify_payment(reference="0250", amount=150.00)

if payment.is_verified:
    print(f"Pago confirmado: {payment.bank} - Ref: {payment.reference}")

curl -X POST "https://pay-dev.1group.media/api/v1/verify" \
  -H "Content-Type: application/json" \
  -H "X-Store-Id: cus_657cf98b" \
  -d '{
    "reference": "0250",
    "amount": "150.00"
  }'

<?php
// Verificación directa para WooCommerce / PHP
$payload = json_encode([
    'reference' => '0250',
    'amount' => '150.00',
    'storeId' => 'cus_657cf98b'
]);

$ch = curl_init('https://pay-dev.1group.media/api/v1/verify');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($ch);
$data = json_decode($response, true);

if (!empty($data['verified'])) {
    echo "Pago confirmado por {$data['amount']} {$data['currency']}";
}
?>

5. Ambientes Sandbox vs Producción

Ambiente Sandbox (Pruebas): APK de desarrollo 1pay-dev.apk (Tema Cyber Amber) · Permite simular alertas bancarias y verificar webhooks en tus servidores de desarrollo sin dinero real.
Ambiente de Producción: APK oficial de cobro disponible en pay.1group.media (Tema Esmeralda & Oro).