Documentación de la API & Webhooks en Tiempo Real

// Ejemplo: Servidor Receptor de Webhook en Node.js (Express)
const express = require('express');
const app = express();

app.use(express.json());

app.post('/mi-webhook-pagos', (req, res) => {
  const webhookKey = req.headers['x-webhook-key'];
  
  // Validar autenticidad de Pago Cierto
  if (webhookKey !== process.env.PAGOS_LIVE_API_KEY) {
    return res.status(401).send('Unauthorized');
  }

  const { event, payment } = req.body;

  if (event === 'payment.detected') {
    console.log(`¡Pago recibido! ${payment.payer_name} pagó ${payment.currency} ${payment.amount}`);
    // Aquí puedes activar tu pedido en tu tienda o entregar el producto digital
  }

  res.status(200).json({ received: true });
});

app.listen(3000, () => console.log('Escuchando webhooks de Pago Cierto en puerto 3000'));

# Ejemplo: Servidor Receptor de Webhook en Python (Flask)
from flask import Flask, request, jsonify
import os

app = Flask(__name__)

@app.route('/mi-webhook-pagos', methods=['POST'])
def webhook_pagos():
    webhook_key = request.headers.get('x-webhook-key')
    
    # Validar autenticidad de Pago Cierto
    if webhook_key != os.environ.get('PAGOS_LIVE_API_KEY'):
        return 'Unauthorized', 401

    data = request.json
    event = data.get('event')
    payment = data.get('payment')

    if event == 'payment.detected':
        print(f"¡Pago recibido! {payment['payer_name']} pagó {payment['currency']} {payment['amount']}")
        # Aquí puedes activar tu pedido en tu tienda o entregar el producto digital

    return jsonify({"received": True}), 200

if __name__ == '__main__':
    app.run(port=3000)

<?php
// Ejemplo: Servidor Receptor de Webhook en PHP Nativo

// Leer Headers
$headers = getallheaders();
$webhookKey = isset($headers['X-Webhook-Key']) ? $headers['X-Webhook-Key'] : null;
$myApiKey = 'TU_API_KEY'; // Reemplazar con tu API Key real o variable de entorno

// Validar autenticidad de Pago Cierto
if ($webhookKey !== $myApiKey) {
    http_response_code(401);
    die('Unauthorized');
}

// Obtener payload JSON
$payload = file_get_contents('php://input');
$data = json_decode($payload, true);

if ($data && $data['event'] === 'payment.detected') {
    $payment = $data['payment'];
    error_log("¡Pago recibido! {$payment['payer_name']} pagó {$payment['currency']} {$payment['amount']}");
    // Aquí puedes activar tu pedido en tu tienda o entregar el producto digital
}

// Responder OK
http_response_code(200);
echo json_encode(["received" => true]);
?>

# Ejemplo: Consultar Pagos Detectados usando cURL

curl -X GET "https://tudominio.com/api/external/payments?period=day" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json"

# Ejemplo: Conciliar Yape rápido usando cURL

curl -X POST "https://tudominio.com/api/external/yape/claim" \
  -H "X-API-Key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "security_code": "482910",
    "amount": 20.00
  }'