README

Add Waffy escrow payments to your Magento 2 or Adobe Commerce store. Instead of money moving straight from buyer to seller, payments are held safely by Waffy and released once the order is confirmed — building buyer trust and reducing payment risk for merchants.

Lightweight, native, and built on the official Waffy PHP SDK (bundled — no extra dependencies to install).

Features

• Escrow-backed checkout — Waffy appears as a payment method; buyers pay on Waffy's secure hosted payment page, so card data never touches your store.
• Simple admin setup — connect your account with your Waffy API credentials and a sandbox/production toggle, all from the Magento admin.
• Automatic order status updates — a built-in webhook receiver keeps the Magento order in sync as the payment is secured in escrow and later released.
• Configurable contracts — return policy, delivery/inspection/acceptance flags, milestone deadline, and buyer-facing category.
• Self-contained — the Waffy PHP SDK is bundled, so installation pulls in everything the extension needs.

Compatibility

Installation

Install with Composer — works on Adobe Commerce and Magento Open Source, no access keys required:

composer require waffy/module-payment
bin/magento module:enable Waffy_Payment
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

In production mode also run bin/magento setup:static-content:deploy -f.

📖 Full guide (Adobe Marketplace, Cloud, and manual/offline installs): INSTALL.md

Configuration

You'll need Waffy API credentials — contact support@waffyapp.com to get them.

In the admin, go to Stores → Configuration → Sales → Payment Methods → Waffy Escrow Payment:

1. Set Environment to Sandbox for testing.
2. Enter your Waffy Client ID / Secret and admin email & password.
3. Set your Merchant Phone (E.164, e.g. +9665XXXXXXXX).
4. Copy the Webhook URL shown and send it to the Waffy team to register your store.
5. Adjust the contract settings, set Enabled → Yes, and Save Config.

Then place a test order and pay with Waffy to confirm the flow end to end. See INSTALL.md for the detailed walkthrough and go-live steps.

How it works

1. The buyer selects Waffy at checkout and is redirected to the secure Waffy hosted payment page.
2. Funds are held in escrow by Waffy, protecting both parties.
3. Waffy notifies your store as the payment is secured and later released, and the Magento order status updates automatically.

Support

• 📧 support@waffyapp.com
• 🌐 waffyapp.com
• 🐛 Issues

License

Licensed under the OSL-3.0 license.