Referencia APITransfers

Crear una transferencia

Mueve dinero desde tu balance al `destination` que indiques. En la mayoría de los casos basta pasar **el identificador como string** — el formato indica a dónde va el dinero: | `destination` | A dónde va | Registro creado | |---|---|---| | `"ba_..."` | Retiro a tu cuenta bancaria | `wi_` (asíncrono) | | `"ac_..."` | Transferencia instantánea a esa cuenta de Recurrente | `tr_` | | `"@handle"` | Transferencia a la cuenta con ese handle | `tr_` | | `"co_..."` | Transferencia al teléfono de ese contacto guardado | `tr_` | | `"+50255667788"` | Envío a un teléfono; queda `unclaimed` hasta que lo reclamen con KYC | `tr_` | Para stablecoin (requiere verificación de stablecoin) o para ser explícito, usa la forma de objeto: `destination: {type: "crypto_address", address: "0x…", chain: "base", currency: "USDC"}` crea un envío `sw_`. Requiere una llave con movimiento de dinero habilitado y la cuenta verificada. Usa `account_id` para operar sobre una cuenta conectada (hija) verificada — admite destinos `bank_account`, y destinos `account` dentro de su misma plataforma (la cuenta madre o cuentas hermanas), para comisiones y liquidaciones.

Authentication

X-SECRET-KEYstring
Tu clave secreta de API

Headers

Idempotency-KeystringOptional

Clave de idempotencia para reintentos seguros de operaciones críticas, especialmente las que mueven dinero o cambian estado operativo. Reintentar con la misma clave y el mismo cuerpo devuelve la respuesta original (header Idempotency-Replayed: true); reusarla con parámetros distintos devuelve 409.

Request

This endpoint expects an object.
amount_in_centsintegerRequired

Monto en centavos que se debita del balance en currency

destinationstring or objectRequired

A dónde va el dinero — el identificador como string (ba_/ac_/co_ id, @handle o teléfono), o el objeto tipado para stablecoin y casos avanzados

currencyenumOptional

Moneda del balance de origen. Para destinos bank_account es opcional (por defecto, la moneda de la cuenta bancaria); requerida para los demás destinos.

Allowed values:
notestringOptional

(Opcional) Nota o descripción del movimiento

is_instantbooleanOptional

Solo destinos bank_account — retiro instantáneo (sujeto a elegibilidad y comisión)

should_perform_currency_conversionbooleanOptional

Solo destinos bank_account — convierte el balance a la moneda de la cuenta bancaria destino

account_idstringOptional

(Opcional) Opera sobre esta cuenta conectada (hija) verificada; admite destinos bank_account y transferencias a la cuenta madre o hermanas

Response

Movimiento creado. Los retiros (wi_) y envíos cripto (sw_) son asíncronos — la respuesta trae el estado inicial; consulta el estado o suscríbete a los webhooks.

idstring

ID del movimiento (tr_ / wi_ / sw_)

statusenum

Estado canónico del movimiento

status_detailstring

Estado crudo del registro subyacente (p. ej. approved, rejected, review_requested)

amount_in_centsinteger
Monto en centavos debitado del balance
currencystring
Moneda del balance de origen
fee_in_centsinteger

Comisión en centavos (retiros instantáneos / internacionales; 0 para p2p)

net_amount_in_centsinteger

Monto neto que llega al destino después de comisiones

notestring or null
Nota del movimiento
destinationobject

Destino del movimiento. Los campos presentes dependen de type.

created_atdatetime

Fecha de creación

senderobject

(Solo registros tr_) Cuenta emisora — campo legado

recipientobject

(Solo registros tr_) Destinatario — campo legado

Errors

400
Bad Request Error
403
Forbidden Error
422
Unprocessable Entity Error