Hosted Integration

The Server-to-Server (S2S) integration method enables merchants to have full control over the payment flow by directly communicating with EdfaPay’s servers via API. This method allows advanced customization and seamless integration with merchant platforms.

Prerequisites

Before proceeding, ensure the following:

• Plugin is installed and activated (see Plugin Installation).
• You have LIVE API credentials from EdfaPay.
• SSL-enabled domain

Steps to Configure Hosted Checkout

1. Navigate to WooCommerce → Settings → Payments
   Locate EdfaPay in the list of available payment methods.

   

2. Click the “Manage” button next to the “EdfaPay” method to access its settings page.

   

3. Fill in the required fields on Both Edfapay And Apple pay Settings:

   • Merchant Key

   • Merchant Password

   • Checkout Type → Set to Hosted Checkout

     

4. Please copy the Webhook URL shown in the settings and send it to the EdfaPay Tech support team so we can activate callbacks on our side.

   

5. Order Status
   Choose the desired Order Status that should be automatically assigned when a payment is successfully completed. This status is essential for tracking order progress and triggering any post-payment actions in your system.

6. Apple Pay Configuration (Required for S2S Apple Pay)
   If you are enabling Apple Pay under the Server-to-Server (S2S) integration, the following configuration is mandatory:

   • Display Options:

     • Show Apple Pay on Product Page
       Allow customers to purchase directly from individual product pages.
     • Show Apple Pay on Cart Page
       Display the Apple Pay button on the cart page for quicker checkout.

   • Authentication:

     • Upload the following:
       • Apple Pay Certificate (.pem file)
       • Apple Pay Private Key File
     • These files must be correctly generated and tied to your Apple Pay Merchant ID.
       To obtain these files, please contact our technical support team.
     
     

7. Save Changes
   Once all settings are updated, scroll down and click the Save changes button.

Notes

• Checkout Type:
  Ensure the Checkout Type is set to Embedded Payment (S2S) for both Visa Card and Apple Pay sections.
• Webhook URL:
  The Webhook URL shown in the EdfaPay plugin settings must be shared with the EdfaPay team for proper transaction notifications.
• Redirect Behavior:
  After a successful payment, the user will be redirected back to your website along with a status parameter. This allows WooCommerce to reflect the order status accordingly. You can track the result through the Orders section in WooCommerce.
• To obtain the PEM and Key files, please contact the technical support team at [email protected].