Ir al contenido

Solana y Tron

Las redes Solana y Tron aparecen en GET /api/v1/networks junto a las redes EVM, con family definido como solana o tron. Consulta sus tokens, decimales y minimum_payment en la API; no mantengas tu propia lista. Las direcciones en estas redes usan su propio formato base58 en solicitudes, respuestas y webhooks.

EVM Solana Tron
Dirección de pago Una dirección de contrato. El destinatario queda fijado en la cadena al crear la dirección. Una clave por pago, en manos del firmante de Invoise. Una clave por pago, en manos del firmante de Invoise.
Custodia Los fondos solo pueden ir al destinatario fijado en la cadena, menos la comisión. Invoise retiene un pago solo hasta que lo transfiere a tu destinatario. Invoise retiene un pago hasta que lo transfiere. No hay contrato de pago.
Destinatario El recipient de la tienda PUT /shops/{shop_id}/solana-recipient PUT /shops/{shop_id}/tron-recipient
Delegado Opcional Ninguno Ninguno
Tienda sandbox Sí No: 400 solana_sandbox_unavailable Sí

Por defecto, un comercio puede tener 100 direcciones de depósito de Solana activas a la vez; el personal de Invoise puede fijar otro límite para un comercio. Deshabilita las inactivas para liberar un lugar: consulta Límites.

Una tienda necesita un destinatario de Solana o Tron antes de poder emitir en esa red. Sin uno, crear una factura o depósito devuelve 400 solana_setup_required o 400 tron_setup_required.

Ventana de terminal
curl -X PUT 'https://platform.invoise.me/api/v1/shops/{shop_id}/solana-recipient' \
-H 'Authorization: Bearer <session-token>' \
-H 'Idempotency-Key: <saved-unique-key>' \
-H 'Content-Type: application/json' \
-d '{"address":"<your-solana-wallet>"}'

Usa /tron-recipient para Tron. Configurarlo necesita una sesión de propietario; una clave de API de tienda solo puede leerlo. GET en la misma ruta devuelve {"address":"..."}, con una dirección vacía hasta que se configure una.

El destinatario se configura una sola vez. Enviar la misma dirección de nuevo tiene éxito; otra dirección devuelve 400 shop_addresses_immutable. Comprueba la dirección antes de guardarla.

Red Reglas
Solana Usa una billetera normal, no una dirección derivada de un programa ni una dirección de Invoise: invalid_solana_address. La billetera ya debe tener una cuenta para el token; si no, crear una factura o depósito devuelve solana_recipient_token_account_required. Recibe primero ese token ahí una vez.
Tron Una dirección con formato incorrecto, incluida una con suma de verificación errónea, devuelve invalid_tron_address; una dirección de Invoise devuelve invalid_tron_recipient. Si Invoise desactivó Tron para el comercio, guardarla devuelve merchant_network_disabled.

La billetera de Invoise vive en redes EVM. Una tienda cuyos pagos de Solana o Tron van a la billetera recibe igualmente una dirección de pago en Solana o Tron, e Invoise transfiere cada pago mediante un puente a la billetera en Arbitrum. GET /merchants/{merchant_id}/networks muestra wallet_bridge: true en una red Solana o Tron que admite el puente.

Cuando el puente no es posible, emitir en esa red devuelve 400 solana_bridge_unavailable o 400 tron_bridge_unavailable, y elegir la billetera para Tron se rechaza con tron_bridge_unavailable. Las tiendas que pagan Solana o Tron a su propia dirección no se ven afectadas.

Elige por familia de red con PATCH /shops/{shop_id}: solana_payout_target y tron_payout_target aceptan address o wallet. Consulta la referencia de la API.