Ejemplos por Método

const coins = await fetch('https://api.qvapay.com/coins/v2?enabled_out=1').then(r => r.json())
const coin = coins.find(c => c.tick === 'USDCASH')

const keys = coin.working_data.map(field => field.name)
// ["Nombre y Apellidos", "Carnet de Identidad", "Nro de Celular", "Dirección", "Municipio", "Provincia"]

curl -X POST https://api.qvapay.com/withdraw \
  -H "Content-Type: application/json" \
  -H "app-id: {tu-app-id}" \
  -H "app-secret: {tu-app-secret}" \
  -d '{
    "pay_method": "USDT",
    "amount": 100,
    "details": {
      "Wallet": "TXxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    },
    "note": "Pedido 4521",
    "webhook": "https://tu-dominio.com/webhooks/qvapay/withdraw",
    "idempotency_key": "pedido-4521",
    "compliance": {
      "purposeCode": "W-1",
      "attestations": {
        "notProhibitedOfficial": true,
        "notProhibitedPartyMember": true,
        "notRestrictedList": true,
        "lawfulPurpose": true
      },
      "purposeNote": "Billetera personal",
      "language": "es"
    }
  }'

const norm = (s) => String(s ?? '')
  .normalize('NFD').replace(/[̀-ͯ]/g, '')
  .toLowerCase().replace(/\s+/g, ' ').trim()

const { margin_pct, zones } = await fetch('https://api.qvapay.com/withdraw/cash-zones?coin=USDCASH').then(r => r.json())

// Provincia y municipio de la dirección de tu cliente
function findZone(province, municipality) {
  return zones.find(z =>
    (norm(z.province_name) === norm(province) || norm(z.province_code) === norm(province)) &&
    norm(z.municipality) === norm(municipality)
  ) ?? null
}

const zone = findZone('Villa Clara', 'Santa Clara')
if (!zone) throw new Error('No hay entrega de efectivo en ese municipio')

const zoneMargin = zone.margin_pct ?? margin_pct
const zoneCharge = Math.max(amount * zone.provider_pct / 100, zone.small_flat_usd ?? 0) + amount * zoneMargin / 100

curl -X POST https://api.qvapay.com/withdraw \
  -H "Content-Type: application/json" \
  -H "app-id: {tu-app-id}" \
  -H "app-secret: {tu-app-secret}" \
  -d '{
    "pay_method": "USDCASH",
    "amount": 200,
    "details": {
      "Nombre y Apellidos": "Yanelis Pérez Rodríguez",
      "Carnet de Identidad": "85010112345",
      "Nro de Celular": "+5355512345",
      "Dirección": "Calle Martí #123 e/ Céspedes y Maceo, Reparto Centro",
      "Municipio": "Santa Clara",
      "Provincia": "Villa Clara"
    },
    "note": "Pedido 4521",
    "webhook": "https://tu-dominio.com/webhooks/qvapay/withdraw",
    "idempotency_key": "pedido-4521",
    "compliance": {
      "purposeCode": "P-1",
      "attestations": {
        "notProhibitedOfficial": true,
        "notProhibitedPartyMember": true,
        "notRestrictedList": true,
        "lawfulPurpose": true
      },
      "purposeNote": "Ayuda familiar",
      "language": "es"
    }
  }'

$payload = [
    'pay_method' => 'USDCASH',
    'amount' => 200,
    'details' => [
        'Nombre y Apellidos' => 'Yanelis Pérez Rodríguez',
        'Carnet de Identidad' => '85010112345', // string, no int
        'Nro de Celular' => '+5355512345',      // C mayúscula
        'Dirección' => 'Calle Martí #123 e/ Céspedes y Maceo, Reparto Centro',
        'Municipio' => 'Santa Clara',           // municipality del tarifario
        'Provincia' => 'Villa Clara',           // province_name del tarifario
    ],
    'note' => 'Pedido 4521',
    'webhook' => 'https://tu-dominio.com/webhooks/qvapay/withdraw',
    'idempotency_key' => 'pedido-4521',
    'compliance' => [
        'purposeCode' => 'P-1',
        'attestations' => [
            'notProhibitedOfficial' => true,
            'notProhibitedPartyMember' => true,
            'notRestrictedList' => true,
            'lawfulPurpose' => true,
        ],
        'purposeNote' => 'Ayuda familiar',
        'language' => 'es',
    ],
];

$response = $client->request('POST', 'https://api.qvapay.com/withdraw', [
    'headers' => ['app-id' => $appId, 'app-secret' => $appSecret],
    'json' => $payload,
]);

{
  "result": "OK",
  "data": {
    "withdraw_id": 123456,
    "transaction_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "receive_amount": 192,
    "receive_amount_coin": 192,
    "fee_to_apply": 8,
    "amount": 200,
    "coin": "USDCASH"
  }
}

curl -X POST https://api.qvapay.com/withdraw \
  -H "Content-Type: application/json" \
  -H "app-id: {tu-app-id}" \
  -H "app-secret: {tu-app-secret}" \
  -d '{
    "pay_method": "BANK_CUP",
    "amount": 50,
    "details": {
      "Nombre y Apellidos": "Yanelis Pérez Rodríguez",
      "Nro de tarjeta": "9227 0699 1234 5678",
      "Nro de celular": "+5355512345"
    },
    "note": "Pedido 4522",
    "idempotency_key": "pedido-4522",
    "compliance": {
      "purposeCode": "P-1",
      "attestations": {
        "notProhibitedOfficial": true,
        "notProhibitedPartyMember": true,
        "notRestrictedList": true,
        "lawfulPurpose": true
      },
      "language": "es"
    }
  }'

{
  "pay_method": "ZELLE",
  "amount": 100,
  "details": {
    "Nombre y Apellidos": "John Smith",
    "Correo o Celular": "[email protected]"
  },
  "idempotency_key": "pedido-4523"
}

{
  "pay_method": "BANK",
  "amount": 500,
  "details": {
    "Nombre y Apellidos": "Acme Supplies LLC",
    "Nombre del Banco": "Bank of America",
    "Nro de Cuenta": "000123456789",
    "Nro de Ruta o ACH": "026009593",
    "Nro de telefono": "+13055551234",
    "Direccion": "100 Main St, Miami, FL 33101"
  },
  "idempotency_key": "pedido-4524"
}