Taxas

Requer autenticação
GET/v2/account/fees

Retorna as taxas configuradas para a credencial, por moeda e tipo de operação. Use no checkout pra exibir o valor líquido que o cliente vai receber.

Sem parâmetros. Apenas o token no header.

Rate limit

60 reqs/min.

Erros

CódigoHTTPDescrição
UNAUTHORIZED401Token inválido ou expirado
MISSING_FEE_CONFIG500Configuração de taxa não encontrada — contate o suporte
cURL
PHP
JavaScript
Python
curl -X GET https://api.bspay.co/v2/account/fees \
  -H "Authorization: Bearer SEU_TOKEN"

Resposta 200

{
  "success": true,
  "data": {
    "fees": {
      "BRL": {
        "cashin":            { "type": "percent", "value": "1.50", "min": "0.50", "max": "100.00" },
        "cashout":           { "type": "fixed",   "value": "1.00" },
        "internal_transfer": { "type": "fixed",   "value": "0.00" }
      },
      "USDT": {
        "cashin":  { "type": "fixed", "value": "1.00" },
        "cashout": { "type": "fixed", "value": "1.50" }
      },
      "MXN": {
        "cashin":  { "type": "percent", "value": "2.00", "min": "5.00" },
        "cashout": { "type": "fixed",   "value": "10.00" }
      }
    },
    "conversion": {
      "spread_percent": "0.40",
      "fee_percent": "0.10"
    }
  },
  "request_id": "39316c1fcf4333e9f4726180",
  "timestamp": "2026-04-30T13:20:30Z"
}
CampoDescrição
typepercent (% sobre o valor) ou fixed (valor absoluto)
valueTaxa nominal — % ou valor absoluto
min / maxPiso/teto absoluto (apenas em type: percent)
conversion.spread_percentSpread aplicado sobre a taxa de mercado
conversion.fee_percentTaxa adicional sobre o valor convertido

Cálculo

PHP — fee de cashin BRL
JavaScript
Python
function calculateFee(array $feeConfig, float $amount): float {
    if ($feeConfig['type'] === 'fixed') {
        return (float) $feeConfig['value'];
    }
    $fee = $amount * ((float) $feeConfig['value'] / 100);
    if (isset($feeConfig['min'])) $fee = max($fee, (float) $feeConfig['min']);
    if (isset($feeConfig['max'])) $fee = min($fee, (float) $feeConfig['max']);
    return $fee;
}

Esta página foi útil?