Solana und Tron
Solana- und Tron-Netzwerke werden in GET /api/v1/networks neben EVM-Netzwerken aufgeführt, mit family auf solana oder tron gesetzt. Lesen Sie deren Token, Dezimalstellen und minimum_payment aus der API; führen Sie keine eigene Liste. Adressen in diesen Netzwerken verwenden ihr eigenes Base58-Format in Anfragen, Antworten und Webhooks.
Unterschiede zu EVM
Abschnitt betitelt „Unterschiede zu EVM“| EVM | Solana | Tron | |
|---|---|---|---|
| Zahlungsadresse | Eine Contract-Adresse. Der Empfänger ist beim Erstellen der Adresse on-chain fest zugewiesen. | Ein Schlüssel pro Zahlung, gehalten vom Invoise-Signer. | Ein Schlüssel pro Zahlung, gehalten vom Invoise-Signer. |
| Verwahrung | Mittel können nur an den on-chain fest zugewiesenen Empfänger gehen, abzüglich der Gebühr. | Invoise hält eine Zahlung nur, bis sie an Ihren Empfänger weitergeleitet wird. | Invoise hält eine Zahlung, bis sie weitergeleitet wird. Es gibt keinen Zahlungscontract. |
| Empfänger | Der recipient des Shops |
PUT /shops/{shop_id}/solana-recipient |
PUT /shops/{shop_id}/tron-recipient |
| Delegierter | Optional | Keiner | Keiner |
| Sandbox-Shop | Ja | Nein: 400 solana_sandbox_unavailable |
Ja |
Standardmäßig kann ein Händler 100 Solana-Einzahlungsadressen gleichzeitig aktiv halten; das Invoise-Team kann für einen Händler ein anderes Limit festlegen. Deaktivieren Sie ungenutzte, um Platz zu schaffen: siehe Limits.
Den Empfänger festlegen
Abschnitt betitelt „Den Empfänger festlegen“Ein Shop benötigt einen Solana- oder Tron-Empfänger, bevor er in diesem Netzwerk ausstellen kann. Ohne einen gibt das Erstellen einer Rechnung oder Einzahlung 400 solana_setup_required oder 400 tron_setup_required zurück.
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>"}'Verwenden Sie /tron-recipient für Tron. Das Festlegen erfordert eine Inhaber-Sitzung; ein Shop-API-Schlüssel kann ihn nur lesen. GET auf demselben Pfad gibt {"address":"..."} zurück, mit einer leeren Adresse, bis eine festgelegt wird.
Der Empfänger wird einmalig festgelegt. Das erneute Senden derselben Adresse ist erfolgreich; eine andere Adresse gibt 400 shop_addresses_immutable zurück. Prüfen Sie die Adresse, bevor Sie sie speichern.
| Netzwerk | Regeln |
|---|---|
| Solana | Verwenden Sie eine gewöhnliche Wallet, keine Program Derived Address und keine Invoise-Adresse: invalid_solana_address. Die Wallet muss bereits ein Konto für den Token besitzen; andernfalls gibt das Erstellen einer Rechnung oder Einzahlung solana_recipient_token_account_required zurück. Empfangen Sie diesen Token dort zunächst einmal. |
| Tron | Eine fehlerhafte Adresse, auch mit falscher Prüfsumme, gibt invalid_tron_address zurück; eine Invoise-Adresse gibt invalid_tron_recipient zurück. Hat Invoise Tron für den Händler abgeschaltet, gibt das Setzen merchant_network_disabled zurück. |
Einzahlung in die Invoise-Wallet
Abschnitt betitelt „Einzahlung in die Invoise-Wallet“Die Invoise-Wallet läuft auf EVM-Netzwerken. Ein Shop, dessen Solana- oder Tron-Auszahlungen an die Wallet gehen, erhält trotzdem eine Solana- oder Tron-Zahlungsadresse, und Invoise überbrückt jede Zahlung in die Wallet auf Arbitrum. GET /merchants/{merchant_id}/networks zeigt wallet_bridge: true bei einem Solana- oder Tron-Netzwerk, das überbrücken kann.
Wenn eine Überbrückung nicht möglich ist, gibt das Ausstellen in diesem Netzwerk 400 solana_bridge_unavailable oder 400 tron_bridge_unavailable zurück, und die Wahl der Wallet für Tron wird mit tron_bridge_unavailable abgelehnt. Shops, die Solana oder Tron an eine eigene Adresse auszahlen, sind nicht betroffen.
Wählen Sie pro Netzwerkfamilie mit PATCH /shops/{shop_id}: solana_payout_target und tron_payout_target nehmen address oder wallet entgegen. Siehe die API-Referenz.