Inspecciona cada endpoint de producción y Testnet directamente desde nuestra especificación canónica /.well-known/openapi.json , descarga nuestra lista para usar Colección Postman v2.1, o genera código de aplicación completo en 8 lenguajes.
xpayr_health_check
Comprueba la salud operativa, la versión y la marca de tiempo del servidor de XPayr Gateway API v1.
curl -X GET "https://xpayr.com/api/v1/health"
xpayr_create_payment_session
Crea una sesión de pago cripto no custodial compatible con pago Web3 en 1 clic, transferencia QR directa desde exchanges, enlaces multicadena, enlaces reutilizables por 1 año y envío automático de facturas HTML por correo.
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
Lista las sesiones de pago cripto del comercio filtrando por estado, moneda, red y paginación.
curl -X GET "https://xpayr.com/api/v1/payments" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_payment_session
Recupera todos los detalles, metadatos, importes de división de liquidación, modo de checkout y hash de transacción on-chain de una sesión de pago.
curl -X GET "https://xpayr.com/api/v1/payments/{session_id}" \
-H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_public_payment_status
Consulta en tiempo real el estado público del checkout, tx_hash on-chain, dirección de billetera remitente, confirmaciones de bloque y marca de tiempo paid_at sin clave API.
curl -X GET "https://xpayr.com/api/v1/payments/{session_id}/status"
xpayr_apply_payment_coupon
Valida y aplica un código de cupón promocional de descuento del comercio a una sesión de pago pendiente activa.
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
Recupera el perfil autenticado del comercio, la dirección de billetera de liquidación, la tasa de comisión en puntos básicos (50 bps = 0.5%) y las claves API activas.
curl -X GET "https://xpayr.com/api/v1/me" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_merchant_balance
Consulta el volumen confirmado de liquidación no custodial, el recuento de transacciones y las comisiones de plataforma agrupados por moneda y red blockchain.
curl -X GET "https://xpayr.com/api/v1/me/balance" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_supported_networks
Lista todas las redes blockchain activas de EVM, TRON, Solana y Arc Mainnet/Testnet, IDs de cadena, endpoints RPC, contratos divisores y tokens compatibles.
curl -X GET "https://xpayr.com/api/v1/me/networks" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_get_webhook_config
Inspecciona la URL de callback de webhook del comercio, el secreto de firma HMAC-SHA256 enmascarado y los eventos suscritos del ciclo de vida del pago.
curl -X GET "https://xpayr.com/api/v1/webhooks" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_set_webhook_endpoint
Configura o actualiza la URL receptora HTTPS de webhooks del comercio y genera un nuevo secreto de firma HMAC-SHA256 de 32 bytes.
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
Envía una carga útil test.webhook firmada con encabezados HMAC-SHA256 para comprobar la verificación de firmas de webhook del comercio.
curl -X POST "https://xpayr.com/api/v1/webhooks/test" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_create_ai_agent
Aprovisiona una nueva identidad de agente de comercio de IA gestionada por el comercio con credenciales acotadas y límites de gasto programables.
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
Lista todos los agentes de comercio de IA gestionados por el comercio junto con su estado, billeteras asignadas y políticas de gasto.
curl -X GET "https://xpayr.com/api/v1/agents" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_update_ai_agent_policy
Configura los límites de la política de gasto de un agente de IA (máx. USD por transacción, tope diario, umbral de aprobación automática, cadenas/tokens permitidos).
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
Envía una intención de pago autónoma de agente de IA evaluada en tiempo real frente a las reglas de política del comercio (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
Lista las intenciones de pago de agentes de IA, las decisiones de evaluación de políticas y los registros de auditoría del comercio.
curl -X GET "https://xpayr.com/api/v1/agent-intents" \ -H "Authorization: Bearer sk_test_your_workspace_key"
xpayr_bridge_agent_intent_to_checkout
Convierte una intención de pago aprobada de agente de IA en una sesión de pago XPayr ejecutable en vivo con URL de checkout alojada y verificación 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
Aprueba una intención de pago pendiente de un agente de IA desde la cola de aprobación del comercio y vincúlala al checkout.
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
Rechaza una intención de pago pendiente de un agente de IA en la cola de aprobación del comercio indicando un motivo de auditoría.
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.
¡Sí! Importa https://xpayr.com/postman.json (Colección Postman v2.1) o https://xpayr.com/.well-known/openapi.json (OpenAPI 3.1.0) en un solo clic.
Sí. Cambiar de sk_test_ a sk_live_ mantiene exactamente las mismas URLs de endpoints, nombres de campos JSON y esquemas de eventos webhook HMAC-SHA256.