DÉVELOPPEURS

Référence API

Tous les endpoints REST de SMetaGateway, générés à partir du contrat OpenAPI 3.1. Utilisez des clés API bearer depuis votre serveur ; les montants sont des chaînes décimales.

URL de base: https://smg.sabco24.com/api/v1
Version: 0.2.0 · OpenAPI 3.1

Ouvrir Swagger UI OpenAPI JSON

Endpoints

Toutes les opérations regroupées par ressource.

Méthode	Chemin	Description	Auth.
Système
GET	`/health`	Vérifier l’état du service et le mode de la passerelle.	Publique
GET	`/config`	Lire la configuration publique du client, dont la clé de site du captcha.	Publique
Authentification
POST	`/auth/register`	Inscrire un marchand et ouvrir une session propriétaire.	Publique
POST	`/auth/login`	Se connecter et ouvrir une session propriétaire.	Publique
POST	`/auth/verify-email`	Confirmer une adresse e-mail via le lien envoyé et ouvrir une session propriétaire.	Publique
POST	`/auth/password/forgot`	Envoyer par e-mail un lien de réinitialisation du mot de passe.	Publique
POST	`/auth/password/reset`	Définir un nouveau mot de passe via un lien de réinitialisation et se connecter.	Publique
POST	`/auth/google`	Se connecter ou s’inscrire avec Google et ouvrir une session propriétaire.	Publique
GET	`/auth/session`	Vérifier si ce navigateur est connecté.	Publique
POST	`/auth/logout`	Fermer la session propriétaire en cours.	Publique
Compte
GET	`/me`	Obtenir le compte, les portefeuilles, factures, clés, webhooks et statistiques.	Session propriétaire
PATCH	`/me`	Modifier le nom affiché du marchand.	Session propriétaire
Portefeuilles
GET	`/wallets`	Lister les adresses de réception enregistrées.	Clé API ou session
POST	`/wallets`	Enregistrer une adresse TRON à somme de contrôle valide (propriété non vérifiée).	Session propriétaire
Factures
GET	`/invoices`	Lister les 500 dernières factures.	Clé API ou session
POST	`/invoices`	Créer une facture et réserver un montant exact unique pendant 90 jours.	Clé API ou session
GET	`/invoices/{id}`	Obtenir une facture appartenant à ce marchand.	Clé API ou session
Paiement
GET	`/checkout/{token}`	Lire les informations de paiement destinées au payeur via son jeton.	Publique
Clés API
POST	`/api-keys`	Créer une clé API avec une expiration facultative ; le secret est affiché une seule fois.	Session propriétaire
POST	`/api-keys/{id}/roll`	Remplacer une clé API par un nouveau secret de même nom et de même durée.	Session propriétaire
DELETE	`/api-keys/{id}`	Révoquer immédiatement une clé API.	Session propriétaire
Registre
GET	`/ledger.csv`	Exporter le registre opérationnel complet en CSV.	Clé API ou session
Webhooks
POST	`/webhooks`	Enregistrer un endpoint webhook HTTPS public ; le secret de signature n’est affiché qu’une fois.	Session propriétaire
DELETE	`/webhooks/{id}`	Désactiver un endpoint et annuler ses livraisons en attente.	Session propriétaire
POST	`/webhooks/{id}/test`	Envoyer un événement webhook.test signé.	Session propriétaire
POST	`/webhooks/deliveries/{id}/retry`	Relancer une livraison de webhook échouée ou en attente.	Session propriétaire
Support
POST	`/support/chat`	Démarrer une discussion sur le site avec un nom, un e-mail et un premier message ; renvoie un jeton de discussion privé.	Publique
GET	`/support/chat`	Lire une discussion du site avec son jeton.	Publique
POST	`/support/chat/messages`	Envoyer un autre message dans une discussion du site ; une discussion fermée est rouverte.	Publique
POST	`/support/contact`	Envoyer un message au support sans compte.	Publique
GET	`/support/tickets`	Lister vos tickets de support.	Session propriétaire
POST	`/support/tickets`	Ouvrir un ticket de support.	Session propriétaire
GET	`/support/tickets/{id}`	Lire l’un de vos tickets avec ses messages.	Session propriétaire
POST	`/support/tickets/{id}/messages`	Répondre à votre ticket ; un ticket fermé est rouvert.	Session propriétaire
POST	`/support/tickets/{id}/close`	Fermer votre ticket.	Session propriétaire
GET	`/support/inbox`	Équipe support : lister tous les tickets, ouverts en premier.	Session propriétaire
GET	`/support/inbox/{id}`	Équipe support : lire un ticket avec les coordonnées.	Session propriétaire
POST	`/support/inbox/{id}/messages`	Équipe support : répondre au ticket d’un marchand.	Session propriétaire
POST	`/support/inbox/{id}/status`	Équipe support : changer le statut d’un ticket.	Session propriétaire

Système

GET`/api/v1/health`

Publique

Vérifier l’état du service et le mode de la passerelle.

Renvoie: 200 application/json

Champ	Type	Requis	Description
`status`	`"ok"`	Non
`mode`	`"live"`	Non	Invoices are confirmed from verified TRON mainnet transfers.
`live_payments_enabled`	`true`	Non

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X GET "https://smg.sabco24.com/api/v1/health"

GET`/api/v1/config`

Publique

Lire la configuration publique du client, dont la clé de site du captcha.

captcha is null when Cloudflare Turnstile is not configured; otherwise send captcha_token with sign-in, registration, contact and chat requests. google is null when Google sign-in is not configured.

Renvoie: 200 application/json

Champ	Type	Requis	Description
`captcha`	`object`	Oui
`google`	`object`	Oui

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X GET "https://smg.sabco24.com/api/v1/config"

Authentification

POST`/api/v1/auth/register`

Publique

Inscrire un marchand et ouvrir une session propriétaire.

No session is started. The account can sign in after the emailed link (valid 24 hours, single use) is confirmed with POST /auth/verify-email. Answers 503 email_unavailable when the server cannot send email.

Corps de la requête

Champ	Type	Requis	Description
`email`	`string (email)`	Oui
`password`	`string (password)`	Oui	length 12–128
`captcha_token`	`string`	Non	Cloudflare Turnstile response token. Required when GET /config returns a captcha site key; each token is single use. — length 0–2048
`name`	`string`	Non	length 0–100
`locale`	`"en" \| "fa" \| "ar" \| "zh" \| "es" \| "fr" \| "ru"`	Non	Language of the email. — default "en"

Renvoie: 201 application/json

Champ	Type	Requis	Description
`verification_required`	`true`	Oui
`email`	`string (email)`	Oui
`email_sent`	`boolean`	Oui	False when the SMTP server rejected the message; signing in later sends a new link.

Réponses

201Account created; confirmation email sent
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error
503Email delivery is not configured (email_unavailable) or captcha verification is unavailable

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{"name":"Example Store","email":"merchant@example.com","password":"a-long-unique-passphrase","locale":"en"}'

POST`/api/v1/auth/login`

Publique

Se connecter et ouvrir une session propriétaire.

An account whose email is not yet confirmed answers 403 email_not_verified after a correct password, and a new confirmation link is emailed at most every 5 minutes.

Corps de la requête

Champ	Type	Requis	Description
`email`	`string (email)`	Oui
`password`	`string (password)`	Oui	length 10–128
`captcha_token`	`string`	Non	Cloudflare Turnstile response token. Required when GET /config returns a captcha site key; each token is single use. — length 0–2048
`locale`	`"en" \| "fa" \| "ar" \| "zh" \| "es" \| "fr" \| "ru"`	Non	Language of the email. — default "en"

Renvoie: 200 application/json

Champ	Type	Requis	Description
`merchant`	`Merchant`	Non

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error
503Captcha verification is temporarily unavailable

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"email":"merchant@example.com","password":"a-long-unique-passphrase"}'

POST`/api/v1/auth/verify-email`

Publique

Confirmer une adresse e-mail via le lien envoyé et ouvrir une session propriétaire.

token comes from the #verify= fragment of the emailed link. Tokens are single use; a newer email replaces older links.

Corps de la requête

Champ	Type	Requis	Description
`token`	`string`	Oui	Single-use token from the emailed link. — pattern ^[A-Za-z0-9_-]{43}$

Renvoie: 200 application/json

Champ	Type	Requis	Description
`merchant`	`Merchant`	Non

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/auth/verify-email" \
  -H "Content-Type: application/json" \
  -d '{"token":"TOKEN_FROM_THE_EMAILED_LINK"}'

POST`/api/v1/auth/password/forgot`

Publique

Envoyer par e-mail un lien de réinitialisation du mot de passe.

Always answers 202 whether or not an account exists. The link is valid for 1 hour and single use.

Corps de la requête

Champ	Type	Requis	Description
`email`	`string (email)`	Oui
`captcha_token`	`string`	Non	Cloudflare Turnstile response token. Required when GET /config returns a captcha site key; each token is single use. — length 0–2048
`locale`	`"en" \| "fa" \| "ar" \| "zh" \| "es" \| "fr" \| "ru"`	Non	Language of the email. — default "en"

Renvoie: 202 application/json

Champ	Type	Requis	Description
`success`	`true`	Oui

Réponses

202Accepted
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error
503Email delivery is not configured (email_unavailable) or captcha verification is unavailable

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/auth/password/forgot" \
  -H "Content-Type: application/json" \
  -d '{"email":"merchant@example.com","locale":"en"}'

POST`/api/v1/auth/password/reset`

Publique

Définir un nouveau mot de passe via un lien de réinitialisation et se connecter.

token comes from the #reset= fragment of the emailed link. Every existing session of the account is revoked, and the email counts as confirmed.

Corps de la requête

Champ	Type	Requis	Description
`token`	`string`	Oui	Single-use token from the emailed link. — pattern ^[A-Za-z0-9_-]{43}$
`password`	`string (password)`	Oui	length 12–128

Renvoie: 200 application/json

Champ	Type	Requis	Description
`merchant`	`Merchant`	Non

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/auth/password/reset" \
  -H "Content-Type: application/json" \
  -d '{"token":"TOKEN_FROM_THE_EMAILED_LINK","password":"a-new-long-unique-passphrase"}'

POST`/api/v1/auth/google`

Publique

Se connecter ou s’inscrire avec Google et ouvrir une session propriétaire.

Send the credential returned by Google Identity Services. The server verifies the RS256 signature against Google keys, the issuer, audience (GOOGLE_CLIENT_ID), expiry and email_verified. A new email creates an account (201). An existing confirmed account with the same email is linked to the Google account on first use; an unconfirmed one is claimed by the Google owner and its password stops working.

Corps de la requête

Champ	Type	Requis	Description
`credential`	`string`	Oui	Google ID token (JWT). — length 20–4096

Renvoie: 200 application/json

Champ	Type	Requis	Description
`merchant`	`Merchant`	Non

Réponses

200Signed in
201Account created
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error
503Google keys are temporarily unreachable

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/auth/google" \
  -H "Content-Type: application/json" \
  -d '{"credential":"GOOGLE_ID_TOKEN_FROM_GOOGLE_IDENTITY_SERVICES"}'

GET`/api/v1/auth/session`

Publique

Vérifier si ce navigateur est connecté.

Renvoie: 200 application/json

Champ	Type	Requis	Description
`signed_in`	`boolean`	Oui

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X GET "https://smg.sabco24.com/api/v1/auth/session"

POST`/api/v1/auth/logout`

Publique

Fermer la session propriétaire en cours.

Renvoie: 200 application/json

Champ	Type	Requis	Description
`success`	`true`	Oui

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/auth/logout" \
  -H "Content-Type: application/json" \
  -d '{}'

Compte

GET`/api/v1/me`

Session propriétaire

Obtenir le compte, les portefeuilles, factures, clés, webhooks et statistiques.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Renvoie: 200 Dashboard

Champ	Type	Requis
`merchant`	`Merchant`	Oui
`wallets`	`Wallet[]`	Oui
`invoices`	`Invoice[]`	Oui
`events`	`Event[]`	Oui
`api_keys`	`ApiKey[]`	Oui
`webhooks`	`Webhook[]`	Oui
`deliveries`	`Delivery[]`	Oui
`stats`	`object`	Oui

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X GET "https://smg.sabco24.com/api/v1/me" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com"

PATCH`/api/v1/me`

Session propriétaire

Modifier le nom affiché du marchand.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Corps de la requête

Champ	Type	Requis	Description
`name`	`string`	Oui	length 1–100

Renvoie: 200 Dashboard

Champ	Type	Requis
`merchant`	`Merchant`	Oui
`wallets`	`Wallet[]`	Oui
`invoices`	`Invoice[]`	Oui
`events`	`Event[]`	Oui
`api_keys`	`ApiKey[]`	Oui
`webhooks`	`Webhook[]`	Oui
`deliveries`	`Delivery[]`	Oui
`stats`	`object`	Oui

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X PATCH "https://smg.sabco24.com/api/v1/me" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com" \
  -H "Content-Type: application/json" \
  -d '{"name":"string"}'

Portefeuilles

GET`/api/v1/wallets`

Clé API ou session

Lister les adresses de réception enregistrées.

Renvoie: 200 application/json

Champ	Type	Requis	Description
`wallets`	`Wallet[]`	Non

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X GET "https://smg.sabco24.com/api/v1/wallets" \
  -H "Authorization: Bearer $SMETA_API_KEY"

POST`/api/v1/wallets`

Session propriétaire

Enregistrer une adresse TRON à somme de contrôle valide (propriété non vérifiée).

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Corps de la requête

Champ	Type	Requis	Description
`label`	`string`	Oui	length 1–80
`address`	`string`	Oui	pattern ^T[1-9A-HJ-NP-Za-km-z]{33}$

Renvoie: 200 application/json

Champ	Type	Requis	Description
`wallet`	`Wallet`	Non

Réponses

200Existing address
201Registered
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/wallets" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com" \
  -H "Content-Type: application/json" \
  -d '{"label":"Main business wallet","address":"T_YOUR_PUBLIC_TRON_ADDRESS"}'

Factures

GET`/api/v1/invoices`

Clé API ou session

Lister les 500 dernières factures.

Renvoie: 200 application/json

Champ	Type	Requis	Description
`invoices`	`Invoice[]`	Non

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X GET "https://smg.sabco24.com/api/v1/invoices" \
  -H "Authorization: Bearer $SMETA_API_KEY"

POST`/api/v1/invoices`

Clé API ou session

Créer une facture et réserver un montant exact unique pendant 90 jours.

Amount allocation is global for (network, token contract, receiving address, final payable micro-units), including merchants sharing an address. Reservations outlive invoice expiry. Historical amount reuse is assigned review status. The invoice is confirmed only when a verified TRON transfer of exactly payable_amount reaches wallet_address between creation and expiry.

En-têtes requis

Champ	Type	Requis	Description
`Idempotency-Key`	`string`	Oui	Clé unique par tentative de facture ; réutilisez-la lors des relances.

Corps de la requête `CreateInvoice`

Champ	Type	Requis	Description
`merchant_order_id`	`string`	Oui	Unique per merchant. Reuse the original idempotency key for retries. — length 1–120
`amount`	`string`	Oui	Base price in USDT; minimum 0.000001, maximum 1000000000. The server adds a disclosed identification adjustment. — pattern ^(0\|[1-9][0-9]{0,9})(\.[0-9]{1,6})?$ · e.g. "49.95"
`wallet_id`	`string`	Oui	ID of a wallet registered to this merchant. — length 1–100
`description`	`string`	Non	length 1–1000
`metadata`	`object`	Non	JSON object, at most 16 KiB when serialized. Keep customer secrets out of metadata.
`expires_in_minutes`	`integer`	Non	range 1–1440 · default 20

Renvoie: 200 InvoiceEnvelope

Champ	Type	Requis	Description
`invoice`	`Invoice`	Oui
`idempotent_replay`	`boolean`	Non

Réponses

200Identical idempotent replay
201Invoice allocated
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/invoices" \
  -H "Authorization: Bearer $SMETA_API_KEY" \
  -H "Idempotency-Key: order-1001" \
  -H "Content-Type: application/json" \
  -d '{"merchant_order_id":"1001","amount":"49.95","wallet_id":"WALLET_ID","description":"Example order","expires_in_minutes":20}'

GET`/api/v1/invoices/{id}`

Clé API ou session

Obtenir une facture appartenant à ce marchand.

Paramètres de chemin

Champ	Type	Requis	Description
`id`	`string`	Oui	Invoice ID

Renvoie: 200 application/json

Champ	Type	Requis	Description
`invoice`	`Invoice`	Non

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X GET "https://smg.sabco24.com/api/v1/invoices/ID" \
  -H "Authorization: Bearer $SMETA_API_KEY"

Paiement

GET`/api/v1/checkout/{token}`

Publique

Lire les informations de paiement destinées au payeur via son jeton.

Paramètres de chemin

Champ	Type	Requis	Description
`token`	`string`	Oui	Checkout capability token from checkout_url

Renvoie: 200 application/json

Champ	Type	Requis	Description
`invoice`	`CheckoutInvoice`	Non

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X GET "https://smg.sabco24.com/api/v1/checkout/TOKEN"

Clés API

POST`/api/v1/api-keys`

Session propriétaire

Créer une clé API avec une expiration facultative ; le secret est affiché une seule fois.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Corps de la requête

Champ	Type	Requis	Description
`name`	`string`	Oui	length 1–80
`expires_in_days`	`integer \| null`	Non	Days until the key expires. Omit or send null for a key that never expires. — range 1–3650 · e.g. 90

Renvoie: 201 application/json

Champ	Type	Requis
`api_key`	`ApiKey & object`	Non
`secret`	`string`	Non
`warning`	`string`	Non

Réponses

201Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/api-keys" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com" \
  -H "Content-Type: application/json" \
  -d '{"name":"string"}'

POST`/api/v1/api-keys/{id}/roll`

Session propriétaire

Remplacer une clé API par un nouveau secret de même nom et de même durée.

The old key is revoked in the same transaction. The new secret is shown once.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Paramètres de chemin

Champ	Type	Requis	Description
`id`	`string`	Oui	API key ID

Renvoie: 201 application/json

Champ	Type	Requis
`api_key`	`ApiKey & object`	Non
`secret`	`string`	Non
`warning`	`string`	Non
`replaced_key_id`	`string`	Non

Réponses

201Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/api-keys/ID/roll" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE`/api/v1/api-keys/{id}`

Session propriétaire

Révoquer immédiatement une clé API.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Paramètres de chemin

Champ	Type	Requis	Description
`id`	`string`	Oui	API key ID

Renvoie: 200 application/json

Champ	Type	Requis	Description
`success`	`true`	Oui

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X DELETE "https://smg.sabco24.com/api/v1/api-keys/ID" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com"

Registre

GET`/api/v1/ledger.csv`

Clé API ou session

Exporter le registre opérationnel complet en CSV.

Renvoie: 200 text/csv

Réponses

200CSV includes separate base, adjustment and payable columns; not a statutory accounting report.
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X GET "https://smg.sabco24.com/api/v1/ledger.csv" \
  -H "Authorization: Bearer $SMETA_API_KEY"

Webhooks

POST`/api/v1/webhooks`

Session propriétaire

Enregistrer un endpoint webhook HTTPS public ; le secret de signature n’est affiché qu’une fois.

Port 443 only. Local/private targets, IP literals, credentials, URL fragments and redirects are rejected. DNS is resolved and checked again at delivery time.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Corps de la requête

Champ	Type	Requis	Description
`url`	`string (uri)`	Oui	length 0–2048

Renvoie: 201 application/json

Champ	Type	Requis	Description
`webhook`	`Webhook & object`	Non
`secret`	`string`	Non

Réponses

201Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/webhooks" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://merchant.example.com/hooks/smeta"}'

DELETE`/api/v1/webhooks/{id}`

Session propriétaire

Désactiver un endpoint et annuler ses livraisons en attente.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Paramètres de chemin

Champ	Type	Requis	Description
`id`	`string`	Oui	Webhook ID

Renvoie: 200 application/json

Champ	Type	Requis	Description
`success`	`true`	Oui

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X DELETE "https://smg.sabco24.com/api/v1/webhooks/ID" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com"

POST`/api/v1/webhooks/{id}/test`

Session propriétaire

Envoyer un événement webhook.test signé.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Paramètres de chemin

Champ	Type	Requis	Description
`id`	`string`	Oui	Webhook ID

Renvoie: 200 application/json

Champ	Type	Requis	Description
`event`	`Event`	Non
`deliveries`	`Delivery[]`	Non

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/webhooks/ID/test" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com" \
  -H "Content-Type: application/json" \
  -d '{}'

POST`/api/v1/webhooks/deliveries/{id}/retry`

Session propriétaire

Relancer une livraison de webhook échouée ou en attente.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Paramètres de chemin

Champ	Type	Requis	Description
`id`	`string`	Oui	Delivery ID

Renvoie: 200 application/json

Champ	Type	Requis	Description
`delivery`	`Delivery`	Non

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/webhooks/deliveries/ID/retry" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com" \
  -H "Content-Type: application/json" \
  -d '{}'

POST`https://your-server.example/hooks/smeta`

Receive a signed gateway event at your configured URL

Verify HMAC-SHA256(secret, timestamp + "." + original raw body). The signature header is sha256=<lowercase hex>. Reject timestamps outside your five-minute window and deduplicate event IDs. Each retry is freshly signed. GET the saved invoice with your server key and reconcile it before fulfilling once. invoice.confirmed includes the matched on-chain transaction.

En-têtes requis

X-SMeta-Event-IdX-SMeta-TimestampX-SMeta-Signature

Réponses

200Persisted successfully or already processed. Any 2xx acknowledges delivery.
400Invalid event
401Invalid or stale signature
503Temporary failure; retry delivery

Support

POST`/api/v1/support/chat`

Publique

Démarrer une discussion sur le site avec un nom, un e-mail et un premier message ; renvoie un jeton de discussion privé.

Opens a ticket from the visitor's first message, name and email. The response contains chat_token, shown only here; send it as X-Support-Chat-Token to read replies and continue. Contact details are never echoed back.

Corps de la requête

Champ	Type	Requis	Description
`message`	`string`	Oui	length 1–5000
`name`	`string`	Oui	length 1–100
`email`	`string (email)`	Oui	length 0–254
`captcha_token`	`string`	Non	Cloudflare Turnstile response token. Required when GET /config returns a captcha site key; each token is single use. — length 0–2048

Renvoie: 201 application/json

Champ	Type	Requis	Description
`chat_token`	`string`	Oui	Private bearer token for this conversation.
`ticket`	`object`	Oui
`name`	`string`	Oui
`messages`	`SupportMessage[]`	Oui

Réponses

201Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error
503Captcha verification is temporarily unavailable

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/support/chat" \
  -H "Content-Type: application/json" \
  -d '{"message":"Do you support WooCommerce?","name":"Jane Doe","email":"jane@example.com","captcha_token":"TURNSTILE_RESPONSE_TOKEN"}'

GET`/api/v1/support/chat`

Publique

Lire une discussion du site avec son jeton.

En-têtes requis

Champ	Type	Requis	Description
`X-Support-Chat-Token`	`string`	Oui	chat_token returned when the chat was started. Keep it private; it is the only key to this conversation.

Renvoie: 200 application/json

Champ	Type	Requis
`ticket`	`object`	Oui
`name`	`string`	Oui
`messages`	`SupportMessage[]`	Oui

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X GET "https://smg.sabco24.com/api/v1/support/chat" \
  -H "X-Support-Chat-Token: VALUE"

POST`/api/v1/support/chat/messages`

Publique

Envoyer un autre message dans une discussion du site ; une discussion fermée est rouverte.

En-têtes requis

Champ	Type	Requis	Description
`X-Support-Chat-Token`	`string`	Oui	chat_token returned when the chat was started. Keep it private; it is the only key to this conversation.

Corps de la requête

Champ	Type	Requis	Description
`message`	`string`	Oui	length 1–5000

Renvoie: 201 application/json

Champ	Type	Requis
`ticket`	`object`	Oui
`name`	`string`	Oui
`messages`	`SupportMessage[]`	Oui

Réponses

201Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/support/chat/messages" \
  -H "X-Support-Chat-Token: VALUE" \
  -H "Content-Type: application/json" \
  -d '{"message":"Thanks, that helps."}'

POST`/api/v1/support/contact`

Publique

Envoyer un message au support sans compte.

Creates a ticket that the support team answers by email. Only the reference is returned.

Corps de la requête

Champ	Type	Requis	Description
`name`	`string`	Oui	length 1–100
`email`	`string (email)`	Oui	length 0–254
`subject`	`string`	Oui	length 1–150
`category`	`"general" \| "payments" \| "technical" \| "account" \| "other"`	Non	default "general"
`message`	`string`	Oui	length 1–5000
`captcha_token`	`string`	Non	Cloudflare Turnstile response token. Required when GET /config returns a captcha site key; each token is single use. — length 0–2048

Renvoie: 201 application/json

Champ	Type	Requis	Description
`ticket`	`object`	Non

Réponses

201Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error
503Captcha verification is temporarily unavailable

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/support/contact" \
  -H "Content-Type: application/json" \
  -d '{"name":"Jane Doe","email":"jane@example.com","subject":"Question about pricing","category":"general","message":"Do you charge per invoice?","captcha_token":"TURNSTILE_RESPONSE_TOKEN"}'

GET`/api/v1/support/tickets`

Session propriétaire

Lister vos tickets de support.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Renvoie: 200 application/json

Champ	Type	Requis	Description
`tickets`	`SupportTicket[]`	Non

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X GET "https://smg.sabco24.com/api/v1/support/tickets" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com"

POST`/api/v1/support/tickets`

Session propriétaire

Ouvrir un ticket de support.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Corps de la requête

Champ	Type	Requis	Description
`subject`	`string`	Oui	length 1–150
`category`	`"general" \| "payments" \| "technical" \| "account" \| "other"`	Non	default "general"
`message`	`string`	Oui	length 1–5000

Renvoie: 201 SupportThread

Champ	Type	Requis	Description
`ticket`	`SupportTicket`	Oui
`messages`	`SupportMessage[]`	Oui

Réponses

201Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/support/tickets" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com" \
  -H "Content-Type: application/json" \
  -d '{"subject":"Webhook signature fails","category":"technical","message":"Deliveries return 401 since yesterday."}'

GET`/api/v1/support/tickets/{id}`

Session propriétaire

Lire l’un de vos tickets avec ses messages.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Paramètres de chemin

Champ	Type	Requis	Description
`id`	`string`	Oui	Ticket ID

Renvoie: 200 SupportThread

Champ	Type	Requis	Description
`ticket`	`SupportTicket`	Oui
`messages`	`SupportMessage[]`	Oui

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X GET "https://smg.sabco24.com/api/v1/support/tickets/ID" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com"

POST`/api/v1/support/tickets/{id}/messages`

Session propriétaire

Répondre à votre ticket ; un ticket fermé est rouvert.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Paramètres de chemin

Champ	Type	Requis	Description
`id`	`string`	Oui	Ticket ID

Corps de la requête

Champ	Type	Requis	Description
`message`	`string`	Oui	length 1–5000

Renvoie: 201 SupportThread

Champ	Type	Requis	Description
`ticket`	`SupportTicket`	Oui
`messages`	`SupportMessage[]`	Oui

Réponses

201Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/support/tickets/ID/messages" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com" \
  -H "Content-Type: application/json" \
  -d '{"message":"string"}'

POST`/api/v1/support/tickets/{id}/close`

Session propriétaire

Fermer votre ticket.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Paramètres de chemin

Champ	Type	Requis	Description
`id`	`string`	Oui	Ticket ID

Renvoie: 200 SupportThread

Champ	Type	Requis	Description
`ticket`	`SupportTicket`	Oui
`messages`	`SupportMessage[]`	Oui

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/support/tickets/ID/close" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com" \
  -H "Content-Type: application/json" \
  -d '{}'

GET`/api/v1/support/inbox`

Session propriétaire

Équipe support : lister tous les tickets, ouverts en premier.

Requires a session for an account listed in SUPPORT_STAFF_EMAILS.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Renvoie: 200 application/json

Champ	Type	Requis	Description
`tickets`	`SupportTicket[]`	Non

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X GET "https://smg.sabco24.com/api/v1/support/inbox" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com"

GET`/api/v1/support/inbox/{id}`

Session propriétaire

Équipe support : lire un ticket avec les coordonnées.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Paramètres de chemin

Champ	Type	Requis	Description
`id`	`string`	Oui	Ticket ID

Renvoie: 200 SupportThread

Champ	Type	Requis	Description
`ticket`	`SupportTicket`	Oui
`messages`	`SupportMessage[]`	Oui

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X GET "https://smg.sabco24.com/api/v1/support/inbox/ID" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com"

POST`/api/v1/support/inbox/{id}/messages`

Session propriétaire

Équipe support : répondre au ticket d’un marchand.

Contact-form tickets return 409 email_reply_required because the visitor has no account.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Paramètres de chemin

Champ	Type	Requis	Description
`id`	`string`	Oui	Ticket ID

Corps de la requête

Champ	Type	Requis	Description
`message`	`string`	Oui	length 1–5000

Renvoie: 201 SupportThread

Champ	Type	Requis	Description
`ticket`	`SupportTicket`	Oui
`messages`	`SupportMessage[]`	Oui

Réponses

201Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/support/inbox/ID/messages" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com" \
  -H "Content-Type: application/json" \
  -d '{"message":"string"}'

POST`/api/v1/support/inbox/{id}/status`

Session propriétaire

Équipe support : changer le statut d’un ticket.

Nécessite le cookie de session du propriétaire du tableau de bord ; les clés API sont refusées pour cette opération.

Paramètres de chemin

Champ	Type	Requis	Description
`id`	`string`	Oui	Ticket ID

Corps de la requête

Champ	Type	Requis	Description
`status`	`"open" \| "answered" \| "closed"`	Oui

Renvoie: 200 SupportThread

Champ	Type	Requis	Description
`ticket`	`SupportTicket`	Oui
`messages`	`SupportMessage[]`	Oui

Réponses

200Success
400Validation error
401Authentication required
403Insufficient scope or invalid origin
404Resource not found
409Conflict, exhausted amount pool or manual review required
429Rate limit exceeded
500Internal server error

Exemple de requête

curl -X POST "https://smg.sabco24.com/api/v1/support/inbox/ID/status" \
  -H "Cookie: smg_session=$SESSION" \
  -H "Origin: https://smg.sabco24.com" \
  -H "Content-Type: application/json" \
  -d '{"status":"open"}'

Schémas

Objets renvoyés et acceptés par l’API.

Error

Champ	Type	Requis	Description
`error`	`object`	Oui
`mode`	`"live"`	Oui	Invoices are confirmed from verified TRON mainnet transfers.

Merchant

Champ	Type	Requis	Description
`id`	`string`	Oui
`name`	`string`	Oui
`email`	`string (email)`	Oui
`mode`	`"live"`	Oui	Invoices are confirmed from verified TRON mainnet transfers.
`support_staff`	`boolean`	Non	True when this account is listed in SUPPORT_STAFF_EMAILS and may use the support inbox.

SupportTicket

Champ	Type	Requis	Description
`id`	`string`	Oui
`reference`	`string`	Oui	Human-friendly reference such as SMG-1A2B3C4D5E.
`subject`	`string`	Oui
`category`	`"general" \| "payments" \| "technical" \| "account" \| "other"`	Oui	default "general"
`status`	`"open" \| "answered" \| "closed"`	Oui	open: waiting for support; answered: support replied; closed: resolved.
`source`	`"dashboard" \| "contact" \| "chat"`	Oui	dashboard: merchant ticket; contact: contact form, answered by email; chat: website chat widget, answered in place.
`created_at`	`string (date-time)`	Oui
`updated_at`	`string (date-time)`	Oui
`name`	`string`	Non	Support inbox only.
`email`	`string (email)`	Non	Support inbox only.
`merchant_id`	`string \| null`	Non	Support inbox only. Null for contact-form and website-chat tickets.
`merchant_name`	`string \| null`	Non	Support inbox only.

SupportMessage

Champ	Type	Requis
`id`	`string`	Oui
`author`	`"customer" \| "staff"`	Oui
`body`	`string`	Oui
`created_at`	`string (date-time)`	Oui

SupportThread

Champ	Type	Requis	Description
`ticket`	`SupportTicket`	Oui
`messages`	`SupportMessage[]`	Oui

Wallet

Champ	Type	Requis
`id`	`string`	Oui
`label`	`string`	Oui
`address`	`string`	Oui
`network`	`"tron-mainnet"`	Oui
`verified`	`false`	Oui
`verification_status`	`"unverified"`	Oui
`created_at`	`string (date-time)`	Oui

CheckoutInvoice

Champ	Type	Requis	Description
`id`	`string`	Oui
`base_amount`	`string`	Oui	Exact USDT decimal string, six fractional digits in responses. Never a floating point number. — pattern ^[0-9]+\.[0-9]{6}$ · e.g. "49.953821"
`adjustment`	`string`	Oui	Exact USDT decimal string, six fractional digits in responses. Never a floating point number. — pattern ^[0-9]+\.[0-9]{6}$ · e.g. "49.953821"
`payable_amount`	`string`	Oui	Exact USDT decimal string, six fractional digits in responses. Never a floating point number. — pattern ^[0-9]+\.[0-9]{6}$ · e.g. "49.953821"
`wallet_address`	`string`	Oui
`status`	`"pending" \| "confirmed" \| "expired" \| "review"`	Oui
`created_at`	`string (date-time)`	Non
`expires_at`	`string (date-time)`	Non
`reserved_until`	`string (date-time)`	Non
`description`	`string`	Non
`tx_hash`	`string \| null`	Non	TRON transaction hash of the matched USDT transfer (64 hex characters).
`mode`	`"live"`	Oui	Invoices are confirmed from verified TRON mainnet transfers.
`network`	`"tron-mainnet"`	Non
`token`	`"USDT"`	Non
`token_contract`	`"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"`	Non
`amount_reuse_review`	`boolean`	Non
`merchant_name`	`string`	Oui	Merchant business display name.

Invoice

Champ	Type	Requis	Description
`id`	`string`	Oui
`base_amount`	`string`	Oui	Exact USDT decimal string, six fractional digits in responses. Never a floating point number. — pattern ^[0-9]+\.[0-9]{6}$ · e.g. "49.953821"
`adjustment`	`string`	Oui	Exact USDT decimal string, six fractional digits in responses. Never a floating point number. — pattern ^[0-9]+\.[0-9]{6}$ · e.g. "49.953821"
`payable_amount`	`string`	Oui	Exact USDT decimal string, six fractional digits in responses. Never a floating point number. — pattern ^[0-9]+\.[0-9]{6}$ · e.g. "49.953821"
`wallet_address`	`string`	Oui
`status`	`"pending" \| "confirmed" \| "expired" \| "review"`	Oui
`created_at`	`string (date-time)`	Non
`expires_at`	`string (date-time)`	Non
`reserved_until`	`string (date-time)`	Non
`description`	`string`	Non
`tx_hash`	`string \| null`	Non	TRON transaction hash of the matched USDT transfer (64 hex characters).
`mode`	`"live"`	Oui	Invoices are confirmed from verified TRON mainnet transfers.
`network`	`"tron-mainnet"`	Non
`token`	`"USDT"`	Non
`token_contract`	`"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"`	Non
`amount_reuse_review`	`boolean`	Non
`checkout_url`	`string (uri)`	Non
`checkout_token`	`string`	Non	Capability token. Treat checkout URLs as confidential invoice links.
`merchant_order_id`	`string`	Oui
`wallet_id`	`string`	Oui
`metadata`	`object`	Oui

CreateInvoice

Champ	Type	Requis	Description
`merchant_order_id`	`string`	Oui	Unique per merchant. Reuse the original idempotency key for retries. — length 1–120
`amount`	`string`	Oui	Base price in USDT; minimum 0.000001, maximum 1000000000. The server adds a disclosed identification adjustment. — pattern ^(0\|[1-9][0-9]{0,9})(\.[0-9]{1,6})?$ · e.g. "49.95"
`wallet_id`	`string`	Oui	ID of a wallet registered to this merchant. — length 1–100
`description`	`string`	Non	length 1–1000
`metadata`	`object`	Non	JSON object, at most 16 KiB when serialized. Keep customer secrets out of metadata.
`expires_in_minutes`	`integer`	Non	range 1–1440 · default 20

InvoiceEnvelope

Champ	Type	Requis	Description
`invoice`	`Invoice`	Oui
`idempotent_replay`	`boolean`	Non

ApiKey

Champ	Type	Requis	Description
`id`	`string`	Oui
`name`	`string`	Oui
`prefix`	`string`	Oui	First characters of the secret, for identification only.
`mode`	`"live"`	Oui	Invoices are confirmed from verified TRON mainnet transfers.
`scopes`	`"invoices:read" \| "invoices:write" \| "ledger:read"[]`	Oui
`created_at`	`string (date-time)`	Non
`last_used_at`	`string \| null (date-time)`	Non
`revoked_at`	`string \| null (date-time)`	Non
`expires_at`	`string \| null (date-time)`	Non	Null when the key never expires.
`expired`	`boolean`	Non

Webhook

Champ	Type	Requis
`id`	`string`	Oui
`url`	`string (uri)`	Oui
`created_at`	`string (date-time)`	Non
`active`	`boolean`	Oui

Delivery

Champ	Type	Requis
`id`	`string`	Oui
`webhook_id`	`string`	Oui
`event_id`	`string`	Oui
`status`	`"pending" \| "sending" \| "delivered" \| "failed" \| "cancelled"`	Oui
`attempts`	`integer`	Oui
`next_attempt_at`	`string \| null (date-time)`	Non
`last_error`	`string \| null`	Non
`response_status`	`integer \| null`	Non
`created_at`	`string (date-time)`	Non
`delivered_at`	`string \| null (date-time)`	Non

Event

Champ	Type	Requis	Description
`id`	`string`	Oui
`type`	`"invoice.created" \| "invoice.confirmed" \| "invoice.expired" \| "invoice.review" \| "webhook.test"`	Oui
`created_at`	`string (date-time)`	Oui
`mode`	`"live"`	Oui	Invoices are confirmed from verified TRON mainnet transfers.
`data`	`object`	Oui

ConfirmedEvent

Champ	Type	Requis	Description
`id`	`string`	Oui
`type`	`"invoice.confirmed"`	Oui
`created_at`	`string (date-time)`	Oui
`mode`	`"live"`	Oui	Invoices are confirmed from verified TRON mainnet transfers.
`data`	`object`	Oui

Dashboard

Champ	Type	Requis
`merchant`	`Merchant`	Oui
`wallets`	`Wallet[]`	Oui
`invoices`	`Invoice[]`	Oui
`events`	`Event[]`	Oui
`api_keys`	`ApiKey[]`	Oui
`webhooks`	`Webhook[]`	Oui
`deliveries`	`Delivery[]`	Oui
`stats`	`object`	Oui

Endpoints

Système

Réponses

Réponses

Authentification

Corps de la requête

Réponses

Corps de la requête

Réponses

Corps de la requête

Réponses

Corps de la requête

Réponses

Corps de la requête

Réponses

Corps de la requête

Réponses

Réponses

Réponses

Compte

Réponses

Corps de la requête

Réponses

Portefeuilles

Réponses

Corps de la requête

Réponses

Factures

Réponses

En-têtes requis

Corps de la requête CreateInvoice

Réponses

Paramètres de chemin

Réponses

Paiement

Paramètres de chemin

Réponses

Clés API

Corps de la requête

Réponses

Paramètres de chemin

Réponses

Paramètres de chemin

Réponses

Registre

Réponses

Webhooks

Corps de la requête

Réponses

Paramètres de chemin

Réponses

Paramètres de chemin

Réponses

Paramètres de chemin

Réponses

En-têtes requis

Réponses

Support

Corps de la requête

Réponses

En-têtes requis

Réponses

En-têtes requis

Corps de la requête

Réponses

Corps de la requête

Réponses

Réponses

Corps de la requête

Réponses

Paramètres de chemin

Réponses

Paramètres de chemin

Corps de la requête

Réponses

Paramètres de chemin

Réponses

Réponses

Paramètres de chemin

Réponses

Corps de la requête `CreateInvoice`