Monedas admitidas

Campos de la petición

currency es un campo público unificado de la API. Puede contener un código de moneda fiat como USD o el símbolo de un activo cripto como USDT.

En las facturas en fiat, envía currency sin network:

{
  "amount": "100.00",
  "currency": "USD"
}

En las facturas de cripto directo y en los retiros, envía currency junto con network:

{
  "amount": "50.00",
  "currency": "USDT",
  "network": "TRC20"
}

Los retiros solo admiten activos cripto. Puedes retirar cualquier activo del que tengas saldo, pero la matriz de abajo es la de cobro y la de salida es más corta: NEAR y SUI solo reciben y no se pueden poner como destino. Quedan once redes, y dentro de ellas la ruta sigue dependiendo del activo.

network — al crear una factura de cripto directo o un retiro, indica currency junto con network:

{
  "currency": "USDT",
  "network": "TRC20"
}

Valores válidos de network en una factura: TRC20, ERC20, BEP20, POLYGON, ARBITRUM, OPTIMISM, BASE, TON, AVAX, SOL, NEAR, SUI, PLASMA. En un retiro, la misma lista sin NEAR ni SUI.

Modelo de precios

Con precio en fiat (currency = USD/EUR/…), Paymos fija el tipo de cambio en el momento en que el cliente elige token y red en la página de pago. El cliente paga entonces el importe equivalente en token. El tipo fijado se devuelve en la factura como payment.exchange_rate.

Con precio directo en cripto (currency = USDT/USDC/… junto con network), el cliente paga el importe exacto de ese token en esa red. No interviene ningún cambio de divisa.

La liquidación siempre se hace en el activo con el que pagó el cliente. Paymos nunca convierte cripto a fiat: retiras ese mismo activo a tu propia billetera y cualquier conversión a fiat la organizas por tu cuenta, fuera de Paymos.

Monedas fiat

Grupo	Códigos
Principales	USD, EUR, GBP, CHF, CAD, AUD, NZD, JPY
Europa	PLN, CZK, DKK, SEK, NOK, HUF
CEI	RUB, UAH, GEL
Asia	CNY, HKD, KRW, INR, IDR, MYR, PHP, THB, VND, PKR, SGD, BDT, LKR, MMK, TWD
América	BRL, MXN, ARS, CLP, BMD, VEF
Oriente Medio y África	TRY, AED, ILS, NGN, ZAR, BHD, KWD, SAR

Tokens

Token	Símbolo	Redes
Tether USD	USDT	TRC20, ERC20, BEP20, POLYGON, ARBITRUM, OPTIMISM, TON, AVAX, SOL, NEAR, PLASMA
USD Coin	USDC	ERC20, BEP20, POLYGON, ARBITRUM, OPTIMISM, BASE, AVAX, SOL, NEAR, SUI
Tether Gold	XAUT	ERC20
Dai	DAI	ERC20
World Liberty USD	USD1	ERC20, SOL

Redes

Paymos espera la finalidad adecuada de cada red antes de abonar un pago. En las cadenas que cuentan bloques, la profundidad requerida crece con el importe del pago en USD: los pagos pequeños confirman rápido y los grandes esperan más. Las cadenas con finalidad nativa rápida —hoy BNB Smart Chain, Polygon, Solana, Avalanche y Plasma— usan la marca de finalidad de la propia cadena en lugar de un recuento de bloques. Las profundidades exactas de confirmación, y de qué lado de esa línea cae cada cadena, son un parámetro operativo y pueden cambiar sin previo aviso; el valor aplicado a cada pago se devuelve como required_confirmations en las respuestas de la API, y es null cuando la cadena confirma por finalidad y no por un número fijo de bloques. Lee ese campo en lugar de fijar una lista de redes en el código.

Red	Código	Tipo
Tron	TRC20	L1
Ethereum	ERC20	L1
BNB Smart Chain	BEP20	L1
Polygon PoS	POLYGON	L1
Arbitrum One	ARBITRUM	L2
Optimism	OPTIMISM	L2
Base	BASE	L2
TON	TON	L1
Avalanche	AVAX	L1
Solana	SOL	L1
NEAR	NEAR	L1
Sui	SUI	L1
Plasma	PLASMA	L1

Matriz de token y red

No todos los activos cripto están disponibles en todas las redes. La tabla siguiente muestra todas las combinaciones válidas:

	TRC20	ERC20	BEP20	POLYGON	ARBITRUM	OPTIMISM	BASE	TON	AVAX	SOL	NEAR	SUI	PLASMA
USDT	Sí	Sí	Sí	Sí	Sí	Sí	--	Sí	Sí	Sí	Sí	--	Sí
USDC	--	Sí	Sí	Sí	Sí	Sí	Sí	--	Sí	Sí	Sí	Sí	--
XAUT	--	Sí	--	--	--	--	--	--	--	--	--	--	--
DAI	--	Sí	--	--	--	--	--	--	--	--	--	--	--
USD1	--	Sí	--	--	--	--	--	--	--	Sí	--	--	--