Integra la aplicación de tu cliente con Blackstone Payment Gateway

Introducción

Integrar tu aplicación con el Gateway bPayd de Blackstone Merchant Services te permite aceptar pagos de forma segura, automatizar transacciones y mejorar la experiencia del cliente en plataformas web, móviles y en tienda.
Este artículo te guiará a través del proceso de integración completo — desde la creación de tu cuenta de desarrollador hasta el inicio de transacciones reales.

Paso 1: Crear una Cuenta de Desarrollador

Comienza registrándote en el Portal de Desarrolladores de Blackstone.
Una vez registrado, obtendrás acceso a:

• Tu Tablero para gestionar proyectos

• Claves API (Sandbox y Producción)

• Documentación del SDK y credenciales de prueba

💡 Consejo Profesional: Usa credenciales de sandbox separadas durante el desarrollo para simular transacciones de forma segura.

Paso 2: Elige tu Tipo de Integración

Blackstone admite múltiples opciones de integración según el tipo de tu aplicación:

• SDK para Aplicaciones Móviles (iOS/Android): Para aplicaciones construidas en Swift, Kotlin o Flutter.

• SDK Web: Para tiendas en línea o plataformas basadas en la web.

• Página de Pago Alojada: Para configuraciones rápidas y conformes a PCI sin codificación.

• Integración API Personalizada: Para tener control total sobre la lógica de pago y transacciones.

Elige la que se ajuste a la arquitectura de tu aplicación y sigue su documentación específica del SDK.

Paso 3: Instalar el SDK

Para iOS (Swift)

Agrega a través de Swift Package Manager:

.package(url: "https://github.com/blackstone/bpayd-ios-sdk.git", from: "1.0.0")

Luego importa e inicializa:

import BPayd
BPayd.initialize(publicKey: "pk_sandbox_xxxxx")

Para Android (Kotlin)

Agrega la dependencia en build.gradle:

implementation 'com.blackstone.bpayd:bpayd-android-sdk:1.0.0'

Inicialízalo en tu clase de Aplicación:

BPayd.initialize(context = this, publicKey = "pk_sandbox_xxxxx")

⚙️ El SDK maneja la encriptación, el cumplimiento con PCI y la tokenización automáticamente.

Paso 4: Configurar Claves API

Después de la instalación del SDK, configura tus claves API de Sandbox en tu aplicación o entorno de backend.
Necesitarás dos conjuntos:

• Clave Pública – utilizada en el lado del cliente (seguro de exponer)

• Clave Secreta – utilizada en tu servidor backend (mantener segura)

Ejemplo de configuración .env:

BPAYD_PUBLIC_KEY=pk_sandbox_xxxxx
BPAYD_SECRET_KEY=sk_sandbox_xxxxx

Paso 5: Crear una Intención de Pago

La Intención de Pago es la base de cada transacción.

Ejemplo de solicitud API desde tu backend:

curl -X POST https://api.bpayd.com/v1/payment_intents \
  -H "Authorization: Bearer sk_sandbox_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2500,
    "currency": "USD",
    "description": "Order #1021",
    "capture_method": "automatic"
  }'

Esto devuelve un client_secret, que luego es utilizado por tu frontend o SDK móvil para confirmar el pago.

Paso 6: Confirmar el Pago en tu Aplicación

Ejemplo Móvil (Swift)

BPayd.confirmPayment(clientSecret: "pi_123_secret_456") { result in
    if result.status == .succeeded {
        print("Payment successful!")
    } else {
        print("Payment failed: \(result.message)")
    }
}

Ejemplo Web (JS)

BPayd.confirmPayment({
  clientSecret: 'pi_123_secret_456',
  paymentMethod: { type: 'card' }
}).then(result => {
  if (result.status === 'succeeded') {
    console.log('Payment successful!');
  }
});

Paso 7: Configurar Webhooks

Los webhooks mantienen tu backend sincronizado con eventos de pago como:

• payment_intent.succeeded

• payment_intent.failed

• refund.created

Ejemplo de webhook en Node.js:

app.post('/webhooks/bpayd', (req, res) => {
  const event = req.body;
  if (event.type === 'payment_intent.succeeded') {
    // Update order status to paid
  }
  res.sendStatus(200);
});

🧠 Consejo: Siempre verifica las firmas de los webhooks por seguridad usando tu clave secreta de webhook.

Paso 8: Probar en Modo Sandbox

Utiliza el entorno sandbox de Blackstone para probar cada flujo posible:

• Pagos exitosos

• Transacciones fallidas

• Reembolsos y pre-autorizaciones

• Autenticación 3D Secure (SCA)

Todos los resultados de las pruebas aparecerán en tu Tablero de Desarrolladores bajo “Transacciones.”

Paso 9: Hacerlo en Vivo

Una vez que tu integración esté probada y aprobada:

1. Reemplaza las claves API de Sandbox por claves en Vivo.

2. Verifica que los webhooks apunten a producción.

3. Realiza una transacción en vivo de $1 para validación.

4. Activa monitoreo de fraude y alertas de liquidación en tu tablero.

Felicidades — tu aplicación ahora está en vivo y totalmente integrada con el Gateway de Pago bPayd de Blackstone.

Paso 10: Monitorear y Optimizar

Utiliza el Tablero de Comerciantes para:

• Seguimiento de transacciones

• Analíticas en tiempo real

• Gestión de reembolsos

• Monitoreo de suscripciones

• Métricas de uso de API

También puedes automatizar informes utilizando nuestra API de Analíticas para integraciones de nivel empresarial.

Subsección: ¿Por qué Integrar con Blackstone?

Integrar con el Gateway bPayd de Blackstone ofrece a los desarrolladores y negocios acceso a:

• Seguridad PCI DSS Nivel 1

• Soporte para múltiples monedas

• Bolsas digitales (Apple Pay, Google Pay)

• Facturación recurrente tokenizada

• SDKs amigables para desarrolladores

• Soporte de integración 24/7

Ya sea que estés construyendo una aplicación móvil, una tienda en línea o un servicio de plataforma — Blackstone te brinda la infraestructura para aceptar pagos en cualquier lugar de manera segura y eficiente.

Conclusión

Integrar tu aplicación con el Gateway de Pago de Blackstone abre la puerta a soluciones de pago más inteligentes, rápidas y confiables.
Con unas pocas líneas de código y la configuración adecuada, puedes conectar las aplicaciones de tus clientes a un ecosistema de pago totalmente gestionado y conforme a PCI, diseñado para la escalabilidad y el éxito.