API Reference
Complete endpoint documentation
Detailed documentation for all API endpoints with request/response examples, authentication, and error codes.
View reference →
Developers
Stixpay API
Create payment requests via /api/gateway/request.php. Use X-API-Key for auth. Webhooks for payment status. Sandbox and production. Get keys in dashboard after KYB.
Documentation
Complete API reference
Comprehensive API documentation with endpoints, request/response examples, authentication, and error handling.
Get started quickly with our integration guides and code examples.
Get API keys →
Integration Guides
Step-by-step guides
Get started quickly with our integration guides. Step-by-step instructions for common use cases and payment flows.
View guides →
Code Examples
Ready-to-use examples
Code examples in multiple languages to help you integrate quickly. Copy, paste, and customize for your needs.
View examples →API Endpoints
RESTful API for payments
Authentication
Authenticate API requests using your API key in the X-API-Key header.
Get your API keys from your merchant dashboard after registration.
curl -X POST https://stixpay.com/api/gateway/request.php \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json" \
-d '{
"amount": 50.00,
"currency": "EUR",
"merchant_order_id": "ORDER_123"
}'Payment Requests
Create payment requests for gateway payments. Returns a payment URL that you can redirect customers to, or use for embedded payment forms.
POST /api/gateway/request.php
{
"amount": 50.00,
"currency": "EUR",
"description": "Product purchase",
"merchant_order_id": "ORDER_123",
"customer_email": "[email protected]",
"success_url": "https://yoursite.com/success",
"failure_url": "https://yoursite.com/failure"
}Webhooks
Real-time payment notifications
Receive real-time notifications when payment status changes. Configure webhook URLs in your dashboard to
receive callbacks for successful payments, failures, and other events.
Configure webhooks →
Webhook Events
We send webhooks for payment status changes, transaction updates, and other important events. All webhooks are signed for security verification.
- ✓ Payment succeeded
- ✓ Payment failed
- ✓ Transaction updated
- ✓ Reconciliation completed
Webhook Security
All webhooks are signed with your webhook secret. Verify signatures to ensure requests come from us and haven't been tampered with.
Learn more →Sandbox Testing
Test before you go live
Test your integration in our sandbox environment. Use test API keys and test card numbers to simulate
payments without processing real transactions.
Get sandbox keys →
Test Cards
Use our test card numbers to simulate different payment scenarios. Test successful payments, failures, 3D Secure flows, and more.
4242 4242 4242 4242- Success4000 0000 0000 0002- Declined4000 0025 0000 3155- 3D Secure- Any future expiry date, any CVC
Sandbox Environment
Our sandbox environment mirrors production exactly. Test all features, webhooks, and integrations before going live with real payments.
Get started →Code Examples
Get started quickly
PHP Example
$ch = curl_init('https://stixpay.com/api/gateway/request.php');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-Key: your_api_key',
'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'amount' => 50.00,
'currency' => 'EUR',
'merchant_order_id' => 'ORDER_123'
]));
$response = curl_exec($ch);
$data = json_decode($response, true);
// Redirect to $data['data']['payment_url']JavaScript Example
fetch('https://stixpay.com/api/gateway/request.php', {
method: 'POST',
headers: {
'X-API-Key': 'your_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 50.00,
currency: 'EUR',
merchant_order_id: 'ORDER_123'
})
})
.then(res => res.json())
.then(data => {
window.location.href = data.data.payment_url;
});