Her canlı ortam ve Testnet uç noktasını doğrudan resmi /.well-known/openapi.json spesifikasyonumuzdan inceleyin, çalıştırmaya hazır Postman v2.1 Koleksiyonumuzuindirin veya 8 dilde eksiksiz uygulama kodu oluşturun.
xpayr_health_check
XPayr Gateway API v1 operasyonel sağlığını, sürümünü ve sunucu zaman damgasını kontrol edin.
curl -X GET "https://xpayr.com/api/v1/health"
xpayr_create_payment_session
Web3 Tek Tık Ödeme, Doğrudan Borsa QR Transferi, Çok Zincirli Bağlantılar, 1 Yıllık Tekrar Kullanılabilir Bağlantılar ve Otomatik HTML Fatura E-posta Gönderimini destekleyen gözetimsiz bir kripto ödeme oturumu oluşturun.
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
İşyeri kripto ödeme oturumlarını durum, para birimi, ağ ve sayfalama filtreleriyle listeleyin.
curl -X GET "https://xpayr.com/api/v1/payments" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_payment_session
Bir ödeme oturumu için tüm ayrıntıları, meta verileri, takas dağılım tutarlarını, ödeme modunu ve zincir üstü işlem karmasını (hash) alın.
curl -X GET "https://xpayr.com/api/v1/payments/{session_id}" \
-H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_public_payment_status
API anahtarı olmadan gerçek zamanlı açık ödeme durumunu, zincir üstü tx_hash değerini, gönderen cüzdan adresini, blok onaylarını ve paid_at zaman damgasını sorgulayın.
curl -X GET "https://xpayr.com/api/v1/payments/{session_id}/status"
xpayr_apply_payment_coupon
Beklemedeki aktif bir ödeme oturumuna işyeri promosyon indirim kupon kodunu doğrulayıp uygulayın.
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
Kimliği doğrulanmış işyeri profilini, takas cüzdan adresini, baz puan cinsinden komisyon oranını (50 bps = 0.5%) ve aktif API anahtarlarını alın.
curl -X GET "https://xpayr.com/api/v1/me" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_merchant_balance
Para birimi ve blokzincir ağına göre gruplandırılmış onaylı gözetimsiz takas hacmini, işlem sayılarını ve platform ücretlerini sorgulayın.
curl -X GET "https://xpayr.com/api/v1/me/balance" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_supported_networks
Aktif tüm EVM, TRON, Solana ve Arc Mainnet/Testnet blokzincir ağlarını, zincir kimliklerini (chain ID), RPC uç noktalarını, bölüştürücü sözleşmeleri ve desteklenen tokenları listeleyin.
curl -X GET "https://xpayr.com/api/v1/me/networks" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_webhook_config
İşyeri webhook geri çağırma URL'sini, maskelenmiş HMAC-SHA256 imzalama sırrını ve abone olunan ödeme yaşam döngüsü olaylarını inceleyin.
curl -X GET "https://xpayr.com/api/v1/webhooks" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_set_webhook_endpoint
İşyeri HTTPS webhook alıcı URL'sini yapılandırın veya güncelleyin ve yeni bir 32 baytlık HMAC-SHA256 imzalama sırrı oluşturun.
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
İşyeri webhook imza doğrulamasını test etmek için HMAC-SHA256 başlıklarına sahip imzalı bir test.webhook yükü gönderin.
curl -X POST "https://xpayr.com/api/v1/webhooks/test" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_create_ai_agent
Kapsamlandırılmış kimlik bilgileri ve programlanabilir harcama koruma sınırlarıyla işyeri tarafından yönetilen yeni bir yapay zeka ticaret ajanı kimliği oluşturun.
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
İşyeri tarafından yönetilen tüm yapay zeka ticaret ajanlarını durumları, atanmış cüzdanları ve harcama politikalarıyla birlikte listeleyin.
curl -X GET "https://xpayr.com/api/v1/agents" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_update_ai_agent_policy
Bir yapay zeka ajanı için harcama politikası koruma sınırlarını yapılandırın (işlem başı maks. USD, günlük üst sınır, otomatik onay eşiği, izin verilen zincirler/tokenlar).
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
İşyeri politika kurallarına göre gerçek zamanlı değerlendirilen otonom bir yapay zeka ajanı ödeme niyeti gönderin (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
İşyeri için yapay zeka ajanı ödeme niyetlerini, politika değerlendirme kararlarını ve denetim izi kayıtlarını listeleyin.
curl -X GET "https://xpayr.com/api/v1/agent-intents" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_bridge_agent_intent_to_checkout
Onaylanmış bir yapay zeka ajanı ödeme niyetini, barındırılan ödeme URL'si ve zincir üstü doğrulama içeren canlı yürütülebilir bir XPayr ödeme oturumuna dönüştürün.
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
İşyeri onay kuyruğundaki bekleyen bir yapay zeka ajanı ödeme niyetini onaylayın ve ödeme oturumuna aktarın.
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
İşyeri onay kuyruğundaki bekleyen bir yapay zeka ajanı ödeme niyetini denetim gerekçesiyle reddedin.
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.
Evet! Tek tıkla https://xpayr.com/postman.json (Postman Koleksiyonu v2.1) veya https://xpayr.com/.well-known/openapi.json (OpenAPI 3.1.0) dosyasını içe aktarın.
Evet. sk_test_ anahtarından sk_live_ anahtarına geçmek; aynı uç nokta URL'lerini, JSON alan adlarını ve HMAC-SHA256 webhook olay şemalarını birebir korur.