Settlement de payouts fiat

Esta página cubre settlement en la misma moneda para BOB, MXN y ARS. No convierte un saldo fiat en otra moneda fiat.

Un payout puede debitar un saldo fiat local cuando la moneda del payout y settlement_asset son iguales. La tasa de settlement es "1" y los spreads de settlement son cero. Las comisiones configuradas en USDT se convierten con la cotización bloqueada y se redondean hacia arriba a la unidad mínima de la moneda del payout.

curl -X POST https://api.qbank.cl/platform/v1/payouts \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: payout-bob-001" \
  -d '{
    "country": "BO",
    "currency": "BOB",
    "method": "bank_transfer",
    "local_amount": "100.00",
    "settlement_asset": "BOB",
    "beneficiary": {
      "name": "Ana Pérez",
      "country_code": "BO",
      "bank_code": "0016",
      "account_number": "1234567890",
      "account_type": "checking"
    },
    "idempotency_key": "payout-bob-001"
  }'

{
  "payout_id": "7b2e…",
  "country": "BO",
  "currency": "BOB",
  "local_amount": "100.00",
  "settlement_asset": "BOB",
  "settlement_amount": "100.01",
  "settlement_rate": "1",
  "settlement_spread": "0",
  "platform_settlement_spread": "0",
  "status": "processing",
  "funds_debited": true
}

El beneficiario recibe 100.00 BOB; los 0.01 BOB adicionales son la comisión configurada, convertida y redondeada hacia arriba en moneda local. Si el payout falla, el settlement_amount retenido se reembolsa sin cambios. GET /v1/rates marca los assets fiat locales con same_currency_only: true:

{
  "settlement": {
    "default_asset": "USD",
    "assets": [
      {
        "asset": "BOB",
        "available": true,
        "settlement_rate": "1",
        "same_currency_only": true
      }
    ]
  }
}

El settlement cross-fiat se rechaza. Por ejemplo, un payout MXN no puede debitar un saldo BOB:

{
  "error": "pricing_unavailable",
  "message": "fiat settlement is only available in the payout currency"
}

Para BOB, MXN y ARS, los montos con más de dos decimales responden 400 invalid_amount; por ejemplo, "100.001". Usa la unidad mínima de la moneda del payout: CBPay no redondea silenciosamente el monto local. Consulta Errores para el contrato público de errores.

¿Puedo debitar BOB para un payout MXN?

No. En esta versión el settlement cross-fiat no es una conversión FX. Elige la moneda del payout u otro asset de settlement soportado.

¿Se aplican spreads al fiat de la misma moneda?

No. Usa tasa identidad y spreads de settlement cero. Las comisiones configuradas siguen cobrándose y se convierten a fiat.

USD como activo principal del ledger

Las cuentas usan USD como valor predeterminado de settlement_asset y payin_settlement_asset; cámbialo cuando quieras con PUT /v1/settlement. Las operaciones en vuelo nunca se vuelven a cotizar. Los montos del ledger en USD usan centavos (dos decimales). Los créditos y d débitos directos, las comisiones y los flujos de payout, checkout, POS y tarjetas usan USD solo cuando el campo de activo de ese flujo lo acepta. Los swaps entre USD y USDT usan paridad 1:1 y no consultan un oráculo FX. BOB, MXN y ARS siguen siendo activos fiat separados del ledger; en v1 el pricing de money-out para esos activos sigue no disponible. Un payin acreditado directamente a una cuenta USD-principal expone credit_asset: USD y el monto fiat acreditado en centavos; usdt_credited sigue siendo el equivalente USD para reportes. El hold de una controversia sigue el activo acreditado: los créditos USD usan hold_asset: USD. disputed y held usan las unidades del activo retenido; disputed_usdt y held_usdt son equivalentes normalizados.

Comenzar

Conceptos

Flujos de integración

Productos

Integración

Recursos

Settlement de payouts fiat

USD como activo principal del ledger

​USD como activo principal del ledger

USD como activo principal del ledger