Integracao em 5 minutos

Crie uma sessao de pagamento cripto.

Use a API de sessao de pagamento para criar uma URL de checkout hospedada. O mesmo objeto pode carregar IDs de pedido, IDs de cliente, codigos de produto, contexto de cupom e detalhes de callback do webhook.

1. Envie a requisicao de criacao de sessao

Os campos obrigatorios sao amount, currency e network. Use chaves de teste primeiro e mude para chaves de producao apos a ativacao na mainnet.

cURL

curl -X POST https://xpayr.com/api/v1/payments \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 49.90,
    "currency": "USDT",
    "network": "tron-mainnet",
    "is_multi_chain": true,
    "is_reusable": false,
    "send_invoice_email": true,
    "customer_email": "buyer@example.com",
    "metadata": {
      "order_id": "ORDER-1001",
      "customer_id": "cus_123"
    },
    "success_url": "https://example.com/paid",
    "cancel_url": "https://example.com/cancel",
    "ipn_callback_url": "https://example.com/webhooks/xpayr"
  }'

Node.js

const response = await fetch("https://xpayr.com/api/v1/payments", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.XPAYR_SECRET_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    amount: 49.90,
    currency: "USDT",
    network: "tron-mainnet",
    is_multi_chain: true,
    is_reusable: false,
    send_invoice_email: true,
    customer_email: "buyer@example.com",
    metadata: { order_id: "ORDER-1001", customer_id: "cus_123" },
    success_url: "https://example.com/paid",
    cancel_url: "https://example.com/cancel",
    ipn_callback_url: "https://example.com/webhooks/xpayr"
  })
});

const session = await response.json();
console.log(session.payment_url);

PHP

$payload = [
    'amount' => 49.90,
    'currency' => 'USDT',
    'network' => 'tron-mainnet',
    'is_multi_chain' => true,
    'is_reusable' => false,
    'send_invoice_email' => true,
    'customer_email' => 'buyer@example.com',
    'metadata' => ['order_id' => 'ORDER-1001', 'customer_id' => 'cus_123'],
    'success_url' => 'https://example.com/paid',
    'cancel_url' => 'https://example.com/cancel',
    'ipn_callback_url' => 'https://example.com/webhooks/xpayr',
];

$ch = curl_init('https://xpayr.com/api/v1/payments');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('XPAYR_SECRET_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);

$session = json_decode(curl_exec($ch), true);
curl_close($ch);
echo $session['payment_url'] ?? 'No payment URL returned';

2. Redirecione para a URL de pagamento retornada

{
  "id": "ps_abc123",
  "object": "payment_session",
  "amount": "49.90",
  "currency": "USDT",
  "network": "tron-mainnet",
  "status": "pending",
  "payment_url": "https://xpayr.com/test/ps_abc123",
  "livemode": false
}

3. Confirme o status

Use o endpoint publico de status para confirmacao leve e webhooks assinados para atualizar pedidos em producao.

curl https://xpayr.com/api/v1/payments/ps_abc123/status

4. Baixe os arquivos de inicio rapido

SDKs Oficiais no NPM (v0.2.0) e Servidor MCP Remoto

Integre Mais Rápido com Pacotes Oficiais da XPayr e MCP sem Instalação

Instale @xpayr/node-sdk (v0.2.0), @xpayr/payment-evidence (v0.2.0), @xpayr/extension-kit (v0.2.0)ou @xpayr/mcp-server (v1.0.0) pelo NPM, ou execute chamadas de ferramentas JSON-RPC 2.0 ao vivo via POST https://xpayr.com/api/mcp.

Playground MCP ao Vivo (/tools/mcp-playground) Verificador de Licenças ES256 Simulador de Políticas para Agentes de IA Testador de Webhook HMAC-SHA256 mcp.xpayr.com docs.xpayr.com api-docs.xpayr.com