Inspectez chaque point de terminaison de production et Testnet directement depuis notre spécification canonique /.well-known/openapi.json , téléchargez notre Collection Postman v2.1 prête à l'emploi, ou générez du code applicatif complet dans 8 langages.
xpayr_health_check
Vérifiez l'état opérationnel, la version et l'horodatage serveur de l'API XPayr Gateway v1.
curl -X GET "https://xpayr.com/api/v1/health"
xpayr_create_payment_session
Créez une session de paiement crypto non dépositaire prenant en charge le paiement Web3 en 1 clic, le transfert QR direct depuis un exchange, les liens multichaînes, les liens réutilisables 1 an et l'envoi automatique de factures HTML par e-mail.
curl -X POST "https://xpayr.com/api/v1/payments" \
-H "Authorization: Bearer sk_test_your_workspace_key" \
-H "Content-Type: application/json" \
-d '{"amount":49.9,"currency":"USDT","network":"tron-mainnet","order_id":"ORD-1001","description":"Pro SaaS Annual Plan","is_multi_chain":true,"is_reusable":false,"send_invoice_email":true,"customer_email":"buyer@example.com","ipn_callback_url":"https://example.com/webhooks/xpayr"}'
xpayr_list_payment_sessions
Listez les sessions de paiement crypto du marchand avec filtrage par statut, devise, réseau et pagination.
curl -X GET "https://xpayr.com/api/v1/payments" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_payment_session
Récupérez l'ensemble des détails, métadonnées, montants de répartition du règlement, mode de paiement et hachage de transaction on-chain d'une session de paiement.
curl -X GET "https://xpayr.com/api/v1/payments/{session_id}" \
-H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_public_payment_status
Interrogez en temps réel le statut public du paiement, le tx_hash on-chain, l'adresse du portefeuille expéditeur, les confirmations de bloc et l'horodatage paid_at sans clé API.
curl -X GET "https://xpayr.com/api/v1/payments/{session_id}/status"
xpayr_apply_payment_coupon
Validez et appliquez un code promo marchand à une session de paiement active en attente.
curl -X POST "https://xpayr.com/api/v1/payments/{session_id}/coupon" \
-H "Authorization: Bearer sk_test_your_workspace_key" \
-H "Content-Type: application/json" \
-d '{"coupon_code":"XPAYR-DEMO"}'
xpayr_get_merchant_profile
Récupérez le profil marchand authentifié, l'adresse du portefeuille de règlement, le taux de commission en points de base (50 bps = 0.5%) et les clés API actives.
curl -X GET "https://xpayr.com/api/v1/me" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_merchant_balance
Interrogez le volume de règlement non dépositaire confirmé, le nombre de transactions et les frais de plateforme regroupés par devise et réseau blockchain.
curl -X GET "https://xpayr.com/api/v1/me/balance" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_supported_networks
Listez tous les réseaux blockchain actifs EVM, TRON, Solana et Arc Mainnet/Testnet, les ID de chaîne, les points de terminaison RPC, les contrats répartiteurs et les jetons pris en charge.
curl -X GET "https://xpayr.com/api/v1/me/networks" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_webhook_config
Inspectez l'URL de rappel webhook du marchand, le secret de signature HMAC-SHA256 masqué et les événements du cycle de vie des paiements souscrits.
curl -X GET "https://xpayr.com/api/v1/webhooks" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_set_webhook_endpoint
Configurez ou mettez à jour l'URL réceptrice HTTPS de webhook du marchand et générez un nouveau secret de signature HMAC-SHA256 de 32 octets.
curl -X POST "https://xpayr.com/api/v1/webhooks" \
-H "Authorization: Bearer sk_test_your_workspace_key" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/webhooks/xpayr"}'
xpayr_send_test_webhook
Envoyez une charge utile test.webhook signée avec des en-têtes HMAC-SHA256 afin de valider la vérification de signature webhook du marchand.
curl -X POST "https://xpayr.com/api/v1/webhooks/test" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_create_ai_agent
Provisionnez une nouvelle identité d'agent commercial IA gérée par le marchand avec des identifiants à portée définie et des garde-fous de dépenses programmables.
curl -X POST "https://xpayr.com/api/v1/agents" \
-H "Authorization: Bearer sk_test_your_workspace_key" \
-H "Content-Type: application/json" \
-d '{"name":"Autonomous Cloud Buyer","description":"Pays API and compute invoices under $50 automatically.","wallet_address":"0x71C...89A"}'
xpayr_list_ai_agents
Listez tous les agents commerciaux IA gérés par le marchand avec leur statut, leurs portefeuilles attribués et leurs politiques de dépenses.
curl -X GET "https://xpayr.com/api/v1/agents" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_update_ai_agent_policy
Configurez les garde-fous de politique de dépenses d'un agent IA (montant max. USD par transaction, plafond quotidien, seuil d'approbation automatique, chaînes/jetons autorisés).
curl -X PUT "https://xpayr.com/api/v1/agents/{agent_id}/policy" \
-H "Authorization: Bearer sk_test_your_workspace_key" \
-H "Content-Type: application/json" \
-d '{"max_tx_amount":100,"daily_limit_amount":500,"auto_approve_under":25}'
xpayr_submit_agent_payment_intent
Soumettez une intention de paiement autonome d'agent IA évaluée en temps réel selon les règles de politique du marchand (approved, pending_approval, rejected).
curl -X POST "https://xpayr.com/api/v1/agent-intents" \
-H "Authorization: Bearer sk_test_your_workspace_key" \
-H "Content-Type: application/json" \
-d '{"amount":19.99,"currency":"USDC","network":"arc-testnet","recipient_address":"0xb0bD2f3A86db752dA693D8a686C406E269E57c99","reason":"Monthly GPU cluster invoice #402"}'
xpayr_list_agent_payment_intents
Listez les intentions de paiement des agents IA, les décisions d'évaluation des politiques et les pistes d'audit du marchand.
curl -X GET "https://xpayr.com/api/v1/agent-intents" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_bridge_agent_intent_to_checkout
Convertissez une intention de paiement d'agent IA approuvée en session de paiement XPayr exécutable en direct avec URL de paiement hébergée et vérification on-chain.
curl -X POST "https://xpayr.com/api/v1/agent-intents/{intent_id}/bridge" \
-H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_approve_agent_intent
Approuvez une intention de paiement d'agent IA en attente depuis la file d'approbation du marchand et transférez-la vers le paiement.
curl -X POST "https://xpayr.com/api/v1/agent-approvals/{intent_id}/approve" \
-H "Authorization: Bearer sk_test_your_workspace_key" \
-H "Content-Type: application/json" \
-d '{"note":"Approved by Treasury Manager"}'
xpayr_reject_agent_intent
Rejetez une intention de paiement d'agent IA en attente dans la file d'approbation du marchand avec un motif d'audit.
curl -X POST "https://xpayr.com/api/v1/agent-approvals/{intent_id}/reject" \
-H "Authorization: Bearer sk_test_your_workspace_key" \
-H "Content-Type: application/json" \
-d '{"reason":"Exceeds vendor budget allocation"}'
All REST API v1 endpoints are served from https://xpayr.com/api/v1 using standard Bearer token authentication (Authorization: Bearer sk_test_... for Testnet or sk_live_... for Mainnet). Public endpoints like GET /api/v1/health and GET /api/v1/payments/{session_id}/status require no secret key.
Oui ! Importez https://xpayr.com/postman.json (Collection Postman v2.1) ou https://xpayr.com/.well-known/openapi.json (OpenAPI 3.1.0) en un clic.
Oui. Le passage de sk_test_ à sk_live_ conserve exactement les mêmes URL de points de terminaison, noms de champs JSON et schémas d'événements webhook HMAC-SHA256.