Genera un token de sesión dinámico y retorna una checkout_url limpia para procesar compras variables, carritos e integraciones personalizadas.

Cuerpo de Petición (JSON):

{
  "order_id": "ORDEN-2026-9901",
  "amount": 125.50,
  "currency": "USDT",
  "customer_email": "comprador@ejemplo.com",
  "allowed_methods": ["binance", "multichain"],
  "webhook_url": "https://mi-tienda.com/webhook.php",
  "redirect_url": "https://mi-tienda.com/order_success.php?order=ORDEN-2026-9901"
}

Respuesta Exitosa (JSON):

{
  "ok": true,
  "session_token": "sess_8f9a2b3c4d5e6f7a8b9c",
  "checkout_url": "https://paywik.io/pay/session/sess_8f9a2b3c4d5e6f7a8b9c",
  "amount": 125.50,
  "currency": "USDT",
  "expires_at": "2026-07-24T18:30:00Z"
}

Retorna la lista de todas las redes blockchain (TRC20, BEP20, etc.) habilitadas globalmente en Portal Central.

Respuesta Exitosa (JSON):

{
      "ok": true,
      "networks": [
        "TRC20",
        "BEP20"
      ]
    }

Retorna la lista completa de billeteras de destino públicas y redes autorizadas para el comercio. Ideal para no tener que hardcodear billeteras locales en tus integraciones.

Respuesta Exitosa (JSON):

{
      "ok": true,
      "wallets": [
        {
          "currency": "USDT",
          "network": "BEP20",
          "address": "0xfddaddbf6ffdc48abbe099a3507964677337bdda"
        }
      ]
    }

Inicia la validación on-chain remota de depósitos blockchain.

Cuerpo de Petición (JSON):

• order_id * (string): ID de orden interna.
• client_wallet (string): Billetera del cliente pagador.
• dest_wallet * (string): Billetera de recepción.
• currency * (string): Token a validar (ej: USDT, USDC).
• network * (string): Blockchain (ej: BEP20, TRC20).
• amount * (float): Monto exacto.

Crea un job de validación para transacciones C2C por código de nota.

Cuerpo de Petición (JSON):

• order_id * (string): ID de orden interna.
• note_code (string - Opcional): Código de nota de 6 dígitos. Si se omite, se generará de forma automática y única.
• amount * (float): Monto neto.
• currency * (string): Símbolo de moneda.

Retorna los datos completos y el estado actual de conciliación del job.

Consulta el historial completo de jobs de validación creados por tu cuenta con soporte para filtros. (También disponible en /api/mcrv/v2/transactions).

Parámetros Query (URL Parameters):

• type (string): Filtrar por tipo (multichain, binance_personal, o all por defecto).
• status (string): Filtrar por estado (done para aprobadas, failed para rechazadas, queued, processing, o all por defecto).
• environment (string): Filtrar por ambiente (sandbox, production, o all por defecto).
• limit (int): Cantidad máxima de registros (por defecto 20, max 100).
• offset (int): Salto para paginación (por defecto 0).

Ejemplo en PHP (Nativo)

        <?php
        $clientId = 'cli_a5e9...';
        $apiSecret = 'tu_api_secret_segura';
        $endpoint = 'https://paywik.io/api/mcrv/v2/validate';
        $route = '/mcrv/v2/validate';

        $payload = [
            'order_id'      => 'EX-88910',
            'client_wallet' => '0x64573246fC58AA90060318B690526fBcdC15Fa3A',
            'dest_wallet'   => '0xfddaddbf6ffdc48abbe099a3507964677337bdda',
            'currency'      => 'USDT',
            'network'       => 'BEP20',
            'amount'        => 4.00
        ];

        $jsonBody = json_encode($payload);
        $bodyHash = hash('sha256', $jsonBody);
        $timestamp = time();
        $nonce = bin2hex(random_bytes(8));

        $sigData = "POST\n" . $route . "\n" . $timestamp . "\n" . $nonce . "\n" . $bodyHash;
        $signature = hash_hmac('sha256', $sigData, $apiSecret);

        $ch = curl_init($endpoint);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonBody);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Content-Type: application/json',
            "x-hbpv-client-id: $clientId",
            "x-hbpv-ts: $timestamp",
            "x-hbpv-nonce: $nonce",
            "x-hbpv-sign: $signature"
        ]);

        $response = curl_exec($ch);
        curl_close($ch);
        print_r(json_decode($response, true));
        ?>

Ejemplo en Node.js

        const crypto = require('crypto');
        const axios = require('axios');

        const clientId = 'cli_a5e9...';
        const apiSecret = 'tu_api_secret_segura';
        const endpoint = 'https://paywik.io/api/mcrv/v2/validate';
        const route = '/mcrv/v2/validate';

        const payload = {
          order_id: 'EX-88910',
          client_wallet: '0x64573246fC58AA90060318B690526fBcdC15Fa3A',
          dest_wallet: '0xfddaddbf6ffdc48abbe099a3507964677337bdda',
          currency: 'USDT',
          network: 'BEP20',
          amount: 4.00
        };

        const jsonBody = JSON.stringify(payload);
        const bodyHash = crypto.createHash('sha256').update(jsonBody).digest('hex');
        const timestamp = Math.floor(Date.now() / 1000);
        const nonce = crypto.randomBytes(8).toString('hex');

        const sigData = `POST\n${route}\n${timestamp}\n${nonce}\n${bodyHash}`;
        const signature = crypto.createHmac('sha256', apiSecret).update(sigData).digest('hex');

        axios.post(endpoint, payload, {
          headers: {
            'Content-Type': 'application/json',
            'x-hbpv-client-id': clientId,
            'x-hbpv-ts': timestamp.toString(),
            'x-hbpv-nonce': nonce,
            'x-hbpv-sign': signature
          }
        }).then(res => console.log(res.data));