curl -i -X POST \
  https://flux.praxisglobe.com/api/v1/partners/transactions/payouts \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \
  -d '{
    "client_id": "c2d1d1e3-3340-4170-980e-e9269bbbc551",
    "source_instrument_id": "709448c3-7cbf-454d-a87e-feb23801269a",
    "destination_clabe": "734180000069183455",
    "transaction_request": {
      "external_reference": "1234567",
      "description": "lorem ipsum dolor sit amet",
      "amount": "1.95",
      "currency": "MXN"
    }
  }'

{
  "id": "16811ee8-1ef9-4dd4-8d84-9c2df89cf302",
  "bankId": "9d84b03a-28d1-4898-a69c-38824239e2b1",
  "clientId": "c2d1d1e3-3340-4170-980e-e9269bbbc551",
  "externalReference": "1234567",
  "trackingId": "20250306FINCHVLIKQ5SKUM",
  "description": "lorem ipsum dolor sit amet",
  "amount": "1.95",
  "currency": "MXN",
  "category": "DEBIT_TRANS",
  "subCategory": "SPEI_DEBIT",
  "transactionStatus": "INITIALIZED",
  "audit": {
    "createdAt": "2025-03-06 11:57:55.408000-06:00",
    "updatedAt": "2025-03-06 11:57:55.408000-06:00",
    "deletedAt": "None",
    "blockedAt": "None"
  }
}

curl -i -X POST \
  https://flux.praxisglobe.com/api/v1/partners/transactions/collections \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 660e8400-e29b-41d4-a716-446655440001' \
  -d '{
    "client_id": "c2d1d1e3-3340-4170-980e-e9269bbbc551",
    "source_instrument_id": "709448c3-7cbf-454d-a87e-feb23801269a",
    "payer_clabe": "012180015000000012",
    "transaction_request": {
      "external_reference": "7654321",
      "description": "Cobro servicio mensual",
      "amount": "150.00",
      "currency": "MXN"
    }
  }'

{
  "id": "a3b8d1b6-0b3b-4b1a-9c1a-1a2b3c4d5e6f",
  "bankId": "9d84b03a-28d1-4898-a69c-38824239e2b1",
  "clientId": "c2d1d1e3-3340-4170-980e-e9269bbbc551",
  "externalReference": "7654321",
  "trackingId": "20250317FINCHCOLL8K3PQRS",
  "description": "Cobro servicio mensual",
  "amount": "150.00",
  "currency": "MXN",
  "category": "CREDIT_TRANS",
  "subCategory": "SPEI_CREDIT",
  "transactionStatus": "INITIALIZED",
  "audit": {
    "createdAt": "2025-03-17 09:30:00.000000-06:00",
    "updatedAt": "2025-03-17 09:30:00.000000-06:00",
    "deletedAt": "None",
    "blockedAt": "None"
  }
}

const express = require('express');
const app = express();
app.use(express.json());

const WEBHOOK_SECRET = process.env.FLUX_WEBHOOK_SECRET;

app.post('/webhooks/receptor', (req, res) => {
  // 1. Validate X-Secret-key header
  const secretKey = req.headers['x-secret-key'];

  if (secretKey !== WEBHOOK_SECRET) {
    console.error('Invalid secret key');
    return res.status(401).json({ error: 'Unauthorized' });
  }

  // 2. Process the PAYIN event
  const payload = req.body;
  console.log(`Received PAYIN: ${payload.id}`);
  console.log(`Amount: ${payload.amount} MXN`);
  console.log(`Payer: ${payload.payer_name}`);
  console.log(`Tracking Key: ${payload.tracking_key}`);

  // 3. Save to your database
  // await db.transactions.create(payload);

  // 4. Respond with 201 to accept the transaction
  res.status(201).json({ received: true });
});

app.listen(3000, () => {
  console.log('Webhook handler listening on port 3000');
});

Real transaction execution over the Bre-B system. Subject to standard API rate limits.

curl -i -X POST \
  https://flux.praxisglobe.com/api/v1/payments \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: unique-request-id-12345' \
  -d '{
    "amount": { "value": 50000, "currency": "COP" },
    "destination_account": {
      "account_number": "12345678901",
      "account_type": "SAVINGS",
      "holder_name": "Nombre del Beneficiario",
      "holder_document": { "type": "CC", "number": "1020304050" },
      "bank_code": "001"
    },
    "description": "Pago de crédito #A-54321",
    "external_reference": "ref_cliente_xyz_001"
  }'

{
  "id": "pay_1a2b3c4d5e6f",
  "status": "PROCESSING",
  "created_at": "2025-10-08T14:30:00Z",
  "transaction_journal_hash": "0xabcde12345..."
}

{
  "id": "pay_1a2b3c4d5e6f",
  "status": "COMPLETED",
  "created_at": "2025-10-08T14:30:00Z",
  "completed_at": "2025-10-08T14:30:03Z",
  "amount": { "value": 50000, "currency": "COP" },
  "description": "Pago de crédito #A-54321",
  "external_reference": "ref_cliente_xyz_001",
  "transaction_journal_hash": "0xabcde12345..."
}

curl -i -X POST \
  https://flux.praxisglobe.com/api/v1/accounts/acc_12345/keys \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "alias": "My first FluX Key",
  "key_config": "open_input",
  "open_input": "@FLXMyBusiness123"
}'

{
  "id": "key_TQjvIO8UFf1bv81",
  "key_value": "@FLXMyBusiness123",
  "source_id": "acc_12345",
  "alias": "My first FluX Key",
  "connectivity": {
    "status": "processing",
    "description": ""
  },
  "previous_action": {
    "action_requested": "create",
    "action_code": "",
    "action_description": ""
  },
  "created_at": "2025-11-28T21:32:08Z",
  "updated_at": "2025-11-28T21:32:08Z"
}

curl -i -X POST \
  https://flux.praxisglobe.com/api/v1/qr/static \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "correlationId": "123e4567-e89b-12d3-a456-426614174000",
  "keyString": "3001234567",
  "keyType": "PHONE_NUMBER",
  "payment": {
    "reference": "orden-9876",
    "currency": "COP",
    "amount": 25075.00
  },
  "qrCodeData": { "imgWidth": 250 }
}'

{
  "correlationId": "123e4567-e89b-12d3-a456-426614174000",
  "qrCode": {
    "emv": "000201010212...",
    "imgContent": "base64string=="
  }
}

{
  "correlationId": "unique-dynamic-id-654321",
  "payment": {
    "currency": "COP",
    "amount": 5000.00
  },
  "qrCodeData": { "imgWidth": 250 }
}

{
  "correlationId": "unique-dynamic-id-654321",
  "payment": { "status": "ACTIVE" },
  "qrCode": {
    "emv": "000201010212...",
    "imgContent": "base64string=="
  }
}

{
  "correlationId": "3a7d5245-1fed-4eba-af0c-5f150ef18a38",
  "creditor": {
    "name": "JUAN PEREZ",
    "participantId": "1",
    "nit": "191680120"
  },
  "payment": {
    "transactionAmount": 5000.00,
    "transactionCurrency": "COP"
  },
  "qrCodeType": "DYNAMIC",
  "status": "SUCCESS"
}

{
  "id": "pay_1a2b3c4d5e6f",
  "event": "payment.completed",
  "status": "COMPLETED",
  "created_at": "2025-10-08T14:30:00Z",
  "completed_at": "2025-10-08T14:30:03Z",
  "amount": { "value": 50000, "currency": "COP" },
  "destination_account": {
    "account_number": "12345678901",
    "bank_code": "001",
    "holder_name": "Nombre del Beneficiario"
  },
  "description": "Pago de crédito #A-54321",
  "external_reference": "ref_cliente_xyz_001",
  "transaction_journal_hash": "0xabcde12345..."
}

{
  "id": "pay_9z8y7x6w5v4u",
  "event": "payment.failed",
  "status": "FAILED",
  "created_at": "2025-10-08T14:30:00Z",
  "failed_at": "2025-10-08T14:30:05Z",
  "amount": { "value": 50000, "currency": "COP" },
  "destination_account": {
    "account_number": "12345678901",
    "bank_code": "001",
    "holder_name": "Nombre del Beneficiario"
  },
  "description": "Pago de crédito #A-54321",
  "external_reference": "ref_cliente_xyz_001",
  "failure_reason": "ACCOUNT_NOT_FOUND"
}

const express = require('express');
const app = express();
app.use(express.json());

const WEBHOOK_SECRET = process.env.FLUX_WEBHOOK_SECRET;

app.post('/webhooks/flux-co', (req, res) => {
  // 1. Validate X-Secret-key header
  const secretKey = req.headers['x-secret-key'];
  if (secretKey !== WEBHOOK_SECRET) {
    console.error('Invalid secret key');
    return res.status(401).json({ error: 'Unauthorized' });
  }

  // 2. Process the event
  const { event, id, status, external_reference } = req.body;

  switch (event) {
    case 'payment.completed':
      console.log(`S& Payment ${id} completed - ref: ${external_reference}`);
      // Update your database, notify customer, etc.
      break;

    case 'payment.failed':
      const { failure_reason } = req.body;
      console.log(`R Payment ${id} failed: ${failure_reason}`);
      // Handle retries or notify operations team
      break;

    default:
      console.log(`Unknown event: ${event}`);
  }

  // 3. Acknowledge receipt
  res.status(200).json({ received: true });
});

app.listen(3000, () => {
  console.log('CO Webhook handler listening on port 3000');
});