​
Overview

To ensure a successful integration with Phoenix, please adhere to the following technical requirements. These specifications are designed to provide optimal user experience and security.

​
Iframe Requirements

Iframe dimensions: Must be exactly 350px × 600px
The Phoenix payment interface is designed for these specific dimensions. Using different dimensions may result in a poor user experience with content being cut off or unnecessarily spaced out. 
<iframe
  src="https://app-partner.phoenix.market/"
  style="width: 350px; height: 600px; border: none;"
  title="Phoenix Payment"
  allow="clipboard-write"
></iframe>

​
Security Requirements

Origin validation: Always verify message origins for security
When receiving messages from the Phoenix iframe, always validate the origin to prevent cross-site scripting attacks: 
window.addEventListener('message', function(event) {
  // IMPORTANT: Verify origin for security
  if (event.origin !== 'https://app-partner.phoenix.market') return;
  
  // Process the message only if origin is valid
  // ...
});

​
Parameter Requirements

Required parameters: Both wallet address and amount must be provided
The Phoenix payment iframe requires the following parameters:

​
Required Parameters

  1. address: A valid Ethereum wallet address
  2. amount: A valid USD amount (numeric value)

​
Optional Parameters

  1. theme: The UI theme to use. Can be either ‘light’ or ‘dark’
// Example URL with parameters
const url = `https://app-partner.phoenix.market/?address=${walletAddress}&amount=${amount}&theme=${theme}`;

​
Browser Requirements

Phoenix works with modern browsers including:
  • Chrome 85+
  • Firefox 80+
  • Safari 14+
  • Edge 85+

​
Network Requirements

Your application should be served over HTTPS to ensure secure communication with the Phoenix payment iframe.

​
Production Deployment

Always use the production URL for the Phoenix payment service in your production environment.
In development environments, you may use a staging URL provided by the Phoenix team. For production, always use: 
https://app-partner.phoenix.market/

​
Testing Your Integration

Before going live, we recommend testing your integration with the following scenarios:
  1. Bank connection flow: Test the bank connection process
  2. Transaction flow: Complete a payment from end to end with the transaction success message
  3. Order tracking: Verify that order details are properly captured for record-keeping
  4. Parameter validation: Test with invalid parameters to ensure proper error handling
  5. Message handling: Ensure proper handling of all message types
  6. Security validation: Verify message origin validation

​
Support

For technical assistance with your integration, contact Phoenix support at main@phoenix.market