Scrile Stream Integration
Accept crypto deposits on Scrile Stream platforms. Payments are automatically credited to customer accounts via the internal callback API.
How It Works
- Customer opens a payment link with their customer ID encoded in the invoice name
- They pay with cryptocurrency via the Zyrox checkout page
- Zyrox detects and confirms the payment on the blockchain
- Zyrox sends a POST request to
/exec/internalcallbackon your Scrile Stream instance, crediting the deposit - Every confirmed payment, the first one and each subscription renewal, arrives as a deposit (
type=1) and is credited to the customer's balance. Zyrox sends deposits only: there are no refund, failure or cancellation callbacks to Scrile Stream
Payment URL Format
For Scrile Stream, the invoice name must follow a specific format so Zyrox can extract the customer ID:
https://app.zyrox.io/pay/<merchant>/PAY-<customer_id>-<unique>?amount=<amount>&package_id=<package_id>
- merchant — Your Scrile Stream merchant slug in Zyrox (e.g.,
scrile-demo) - customer_id — The Scrile Stream customer/user ID. Extracted from the invoice name and sent in the callback.
- unique — A unique suffix to prevent invoice ID collisions (e.g., a timestamp or random number)
- package_id — The Scrile Stream package/product external ID. Sent as
package_idin the callback.
Example:
https://app.zyrox.io/pay/scrile-demo/PAY-12345-1707561234567?amount=9.99&package_id=premium_monthlyThis will credit customer ID12345with $9.99 for packagepremium_monthly.
Setup Guide
Step 1: Get Scrile Stream Callback Credentials
In your Scrile Stream admin panel, locate the internal callback configuration:
- Callback URL — the base URL of your Scrile Stream instance (e.g.,
https://www.demo-ai.scrile.com) - Secret Key — the "Internal callback secret key" from Scrile Stream system configuration
Step 2: Configure in Zyrox
- Go to Merchants → [Your Merchant] → Integrations
- Click Add Integration and select Scrile Stream
- Enter the Scrile Stream URL (base URL without
/exec/internalcallback) - Enter the Internal Callback Secret Key
Step 3: Generate Payment Links
On your Scrile Stream platform, generate payment links for customers using the URL format described above. The URL should be dynamically constructed with the customer's ID and the selected package.
Scrile Stream typically handles this automatically when configured to use Zyrox as a payment processor.
Callback Details
When a payment is confirmed, Zyrox sends a POST request to your Scrile Stream instance:
POST {callback_url}/exec/internalcallback
Content-Type: application/x-www-form-urlencoded
Parameters sent:
type=1(Deposit)secret_key— your configured secret keycustomer_id— extracted from invoice name (PAY-{customer_id}-...)amount— payment amount in USDpackage_id— from invoice metadata (if provided)external_id— blockchain transaction ID (for one-time payments)subscription_id— blockchain transaction ID (for subscription payments)customer_ip— customer's IP address (tracked from checkout page)
Subscription Support
The Scrile Stream integration supports both one-time and recurring (subscription) payments. For subscription payments, add the subscription parameter to the URL:
/pay/scrile-demo/PAY-12345-1707561234567?amount=9.99&subscription=monthly&token_symbol=USDT&network_id=3&package_id=premium
Both initial and recurring payments trigger the callback. For subscriptions, the subscription_id parameter is sent instead of external_id.
Troubleshooting
"Could not parse customer_id"
The invoice name doesn't match the expected format PAY-{customer_id}-{unique}. Ensure the URL contains the correct invoice name format.
Callback returns HTTP error Check that the callback URL is correct and accessible from the Zyrox server. Verify the secret key matches the one configured in Scrile Stream.
Customer not credited Check Integration Logs in the Zyrox dashboard for the callback request and response details. Ensure the customer ID exists in Scrile Stream.
All callback requests and responses are logged in Merchants → [Your Merchant] → Integration Logs for debugging purposes.
© 2026 Zyrox. Simple and secure crypto payment processing.