Production Environment

This guide provides essential information for seamlessly transitioning your EdfaPay integration from the sandbox to the production environment. It outlines key requirements, critical security guidelines, and important considerations to ensure a successful and secure launch.


Requirements for Production Readiness

Before deploying to the production environment, ensure the following prerequisites are met:

  1. Merchant Registration Completion: Confirm with the EdfaPay onboarding team that all necessary merchant registration steps have been finalized.
  2. Production Credentials Issuance: You must have received your live production credentials, which include:
    • client_key
    • password
  3. Production Webhook URL Configuration: Update your live webhook URL within your EdfaPay dashboard. Navigate to: Portal → Settings → Webhook Settings.
  4. Domain Whitelisting: Provide your production domains or IP addresses to EdfaPay to prevent request blocking and ensure uninterrupted service.

Security Best Practices

Adhering to these security guidelines is crucial for protecting sensitive data and maintaining the integrity of your integration:

  • Secure Communication: Always use HTTPS for all API endpoints and Webhook URLs.
  • Request Authentication: Ensure all requests include the securely generated hash.
  • Credential Protection: Never log, store, or expose sensitive credentials such such as passwords, full card numbers, or CVVs in unsecured environments.

Key Differences: Sandbox vs. Production

Understanding the distinctions between the sandbox and production environments is vital for a smooth transition:

FeatureSandboxProduction
Environment URLhttps://sandbox.edfapay.com/https://api.edfapay.com/
TransactionsSimulated onlyReal transactions involving actual funds
Card DataTest cards onlyRequires valid, live card information
Hash KeyTest secretLive secret issued by the onboarding team

Important Considerations

Webhook Endpoint Update

Ensure your Webhook endpoint is updated for the production environment to receive real-time transaction updates. Failure to do so will prevent receipt of these updates.

Communication of Changes

Proactively communicate any modifications to callback URLs or integration behavior to the EdfaPay onboarding or support team.

Final Sandbox Validation

Conduct a comprehensive final test in the sandbox environment before switching to production to validate the latest integration build and ensure all functionalities work as expected.