Paymos for Easy Digital Downloads

By Paymos

0+ active installationsVersion 1.7.8

Accept stablecoin payments in Easy Digital Downloads with Paymos hosted checkout.

Description

The official package contains no merchant credentials. Open Downloads -> Settings -> Payments -> Paymos and click Connect Paymos. Approve the current project in Paymos; the plugin receives Sandbox and Live credentials once, stores them in an AES-256-GCM encrypted WordPress option, and discards the short-lived OAuth token.

Runtime Merchant API requests remain HMAC signed. Signed webhooks update invoices without a local invoice reconciliation job: a delivery that fails is retried by Paymos across roughly 16 hours, and anything that outlives the ladder is replayed from the Paymos dashboard. Pending refunds are reconciled locally by a 1-minute WP-Cron job (paymos_edd_refunds_reconcile).

External services

Paymos handles payment requests for this Easy Digital Downloads gateway. To connect, click Connect Paymos in your WordPress admin and approve the connection in Paymos. Device authorization starts at https://app.paymos.io/connect/cms/device; the plugin polls https://app.paymos.io/connect/token for approval. The browser approval URL carries the plugin identifier, store origin, admin return URL, and user_code. The plugin sends the secret device_code to the token endpoint. It stores the returned Sandbox and Live credentials in AES-256-GCM-encrypted WordPress options and discards the short-lived OAuth token.

For payments, the plugin creates invoices at https://api.paymos.io/v1/invoices, checks them with GET /v1/invoices/{invoice_id}, and cancels them with POST /v1/invoices/{invoice_id}/cancel. Each signed request sends a key ID, timestamp, and HMAC signature. The API secret stays with the plugin for signing. Invoice fields include project_id, amount, currency, external_order_id, and, when available, the native customer ID as client_id. New orders use a random opaque reference. Existing references remain in use and can contain an EDD purchase key.

For refunds, the plugin sends POST /v1/refunds requests to https://api.paymos.io/v1/refunds with only invoice_id, mode (full or overpayment), and external_order_id; Paymos returns funds strictly to the verified first_sender address recorded on the invoice. The plugin checks individual refund status with GET /v1/refunds/{refund_id}, polls cursor-paginated refund pages with GET /v1/refunds (cursor, limit, invoice_id, and status), and in Sandbox mode simulates terminal outcomes with POST /v1/sandbox/refunds/{refund_id}/simulate sending status (completed, failed, or cancelled). Pending refunds are polled by a 1-minute WP-Cron job (paymos_edd_refunds_reconcile).

Buyers pay over HTTPS at https://checkout.paymos.io. Signed invoice and payment webhooks return to the store to update orders. Service terms and data handling appear in the Terms and Privacy Policy.

Installation

  1. Install and activate the official release.
  2. Open the intended project in Paymos; that current project is used automatically.
  3. Open Downloads -> Settings -> Payments -> Paymos.
  4. Click Connect Paymos and approve the displayed store URL and current project.
  5. Test in Sandbox, then switch to Live.

FAQ

Does the ZIP contain secrets?

No. Every merchant downloads the same public package.

Where are credentials stored?

In a non-autoloaded WordPress option encrypted with AES-256-GCM using installation security salts.

Changelog

1.7.8

  • chore: rebuild canonical CMS package

1.7.7

  • fix(plugins): guard PHP 8.5 setAccessible deprecations and Drupal SDK path in tests
  • fix(refunds): decouple refund RBAC from Withdraw and unify 12 CMS refund adapters
  • chore: rebuild canonical CMS package

1.7.6

  • fix(woocommerce,edd): a network error during Connect keeps the flow alive

1.7.5

  • chore: rebuild canonical CMS package

1.7.4

  • chore: rebuild canonical CMS package

1.7.3

  • merge: integrate Windows WIP onto origin/main (CMS binding, SDK preview, dashboard, plugins, specs)
  • chore: bundle Paymos PHP SDK v1.10.2

1.7.2

  • chore: rebuild canonical CMS package

1.7.1

  • chore: bundle Paymos PHP SDK v1.10.1
  • chore: rebuild canonical CMS package

1.7.0

  • fix(plugins): unblock WordPress checks and align native recovery tests
  • feat(notifications): rewrite all 71 email and 52 Telegram RU templates, lifecycle series, and R01-R34 audit fixes
  • chore: bundle Paymos PHP SDK v1.10.0
  • chore: rebuild canonical CMS package

1.6.5

  • chore: rebuild canonical CMS package