1nodes crypto payments for edd

Description

1nodes is a cryptocurrency payment gateway for Easy Digital Downloads.

The plugin connects your Easy Digital Downloads store to the 1nodes payment service, allowing customers to pay for their orders using cryptocurrency.

1nodes supports two payment models:

Standard Gateway

The standard payment option uses percentage-based transaction fees. Payment requests are created through 1nodes, and payment status updates are sent back to Easy Digital Downloads automatically.

Non-Custodial Payments

The non-custodial option allows merchants to receive cryptocurrency payments directly to their own wallet using an XPUB-based setup.

Payment addresses can be derived without providing wallet private keys or recovery phrases to 1nodes. Customer payments are sent directly to the merchant’s wallet rather than being held by 1nodes.

The non-custodial option uses a monthly subscription instead of percentage-based transaction fees.

Never provide your wallet private key or recovery phrase to 1nodes or enter them into this plugin.

The plugin supports:

  • Cryptocurrency payments for Easy Digital Downloads
  • Automatic payment verification
  • Automatic EDD payment status updates
  • Standard percentage-based payment processing
  • Non-custodial payments
  • XPUB-based direct-to-wallet payments
  • Monthly subscription option for non-custodial payments
  • Hosted cryptocurrency checkout
  • Signed webhook notifications
  • HMAC SHA-256 webhook verification
  • AJAX payment status checking after customer return

This plugin connects to the 1nodes API to create cryptocurrency payment requests and receive a hosted checkout URL.

After a customer completes the cryptocurrency payment, 1nodes sends a signed webhook notification to the store. The plugin verifies the webhook signature and automatically marks the corresponding EDD payment as complete.

The plugin also checks the payment status after the customer returns to the store and displays a payment verification message while waiting for payment confirmation.

External Services

This plugin connects to the 1nodes payment API to create cryptocurrency payment sessions and manage the cryptocurrency payment flow.

Service endpoint:
https://1nodes.com/wp-json/v1/api/create-payment

When a customer places an order using the 1nodes payment method, the plugin sends data to the 1nodes API in order to create a payment request and receive a hosted cryptocurrency checkout URL.

Data sent to the service:

  • Payment amount
  • Easy Digital Downloads payment ID
  • Customer email address
  • Callback URL for payment status updates
  • Return URL for redirecting the customer after payment
  • Merchant authentication token (Merchant Key) in the Authorization header

When data is sent:

  • When the customer submits the checkout form and chooses the 1nodes payment gateway

Why data is sent:

  • To create a cryptocurrency payment session
  • To generate a hosted cryptocurrency checkout URL
  • To verify and manage the cryptocurrency payment
  • To allow 1nodes to send payment status updates to the store
  • To complete the payment flow in Easy Digital Downloads

For merchants using the non-custodial payment option, 1nodes may use the merchant’s configured XPUB information as part of the direct-to-wallet payment process.

Wallet private keys and recovery phrases are not required by this plugin and should never be provided.

Webhook communication:

  • 1nodes sends payment status notifications to the callback URL provided by the plugin.
  • Webhook requests are verified using an HMAC SHA-256 signature.
  • The plugin processes successful payments when the webhook status is paid.

Terms of Service:
https://1nodes.com/terms/

Privacy Policy:
https://1nodes.com/terms/

Configuration

After activating the plugin:

  1. Go to Downloads → Settings → Payments.
  2. Enable the 1nodes payment gateway.
  3. Select the 1nodes settings section.
  4. Configure the checkout gateway label if required.
  5. Enter your Merchant Key.
  6. Enter your Secret Key.
  7. Save the settings.

You can obtain your Merchant Key and Secret Key from your 1nodes account dashboard.

The payment model and non-custodial settings, when available for your account, are managed through your 1nodes account.

Installation

  1. Upload the 1nodes-crypto-payments-for-edd folder to the /wp-content/plugins/ directory, or install the plugin ZIP file through Plugins → Add New Plugin → Upload Plugin.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Go to Downloads → Settings → Payments.
  4. Enable the 1nodes payment gateway.
  5. Open the 1nodes settings section.
  6. Enter your Merchant Key.
  7. Enter your Secret Key.
  8. Save the settings.

FAQ

Is Easy Digital Downloads required?

Yes. Easy Digital Downloads is required to use this plugin.

Which Easy Digital Downloads version is supported?

The plugin is designed for Easy Digital Downloads 3.7.0 and later compatible versions.

Which PHP version is required?

PHP 8.1 or later is required.

How do I get my Merchant Key and Secret Key?

Create a 1nodes account and obtain your Merchant Key and Secret Key from your account dashboard.

How does payment confirmation work?

After the customer completes the payment on 1nodes, 1nodes sends a signed webhook request to the store.

The plugin verifies the webhook signature and marks the corresponding EDD payment as complete.

When the customer returns to the store, the plugin also checks the local EDD payment status using AJAX while waiting for webhook confirmation.

Does the plugin support cryptocurrency payments?

Yes. The plugin allows customers to complete payments through the 1nodes hosted cryptocurrency checkout.

What is the non-custodial payment option?

The non-custodial option allows merchants to receive cryptocurrency payments directly to their own wallet using an XPUB-based setup.

Payment addresses can be derived without giving 1nodes access to the merchant’s private keys or recovery phrase.

Does 1nodes hold my funds when I use non-custodial payments?

With the non-custodial payment option, customer payments are sent directly to addresses derived for the merchant’s wallet rather than being held by 1nodes.

Do I need to provide my private key or recovery phrase?

No. Private keys and wallet recovery phrases are not required by this plugin and should never be provided to 1nodes.

What is the difference between the standard and non-custodial payment options?

The standard gateway uses percentage-based transaction fees.

The non-custodial option uses a monthly subscription and allows supported cryptocurrency payments to be sent directly to the merchant’s wallet using an XPUB-based setup.

Does the plugin require a separate webhook configuration?

No. The plugin automatically generates the webhook callback URL when a payment is created.

Is the Merchant Key secure?

The Merchant Key is stored in the WordPress database as an EDD gateway setting and is used for authenticated requests to the 1nodes API.

Is the Secret Key used for webhook verification?

Yes. The Secret Key is used to verify the HMAC SHA-256 signature included with webhook requests from 1nodes.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“1nodes crypto payments for edd” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.0

  • Initial release.
  • Added 1nodes cryptocurrency payment gateway for Easy Digital Downloads.
  • Added 1nodes payment API integration.
  • Added signed webhook verification.
  • Added automatic EDD payment completion.
  • Added AJAX payment status verification after customer return.