DIBS Easy – Subscription support
DIBS Easy is compatible with the WooCommerce Subscriptions extension for handling of recurring payments.
To get started with recurring payments via DIBS Easy in your WooCommerce store, you will need the following:
- The extension WooCommerce Subscriptions installed and configured.
- In the WooCommerce Accounts & Privacy settings (→ WooCommerce → Settings → Accounts & Privacy) the checkboxes Automatically generate username from customer email and Automatically generate customer password needs to be checked so new customer accounts can be created.
Get started with subscriptions
- Create a simple subscription product. Set it to a daily renewal so that we can test the renewal process as well.
- Make a test purchase (either with a real account or a test account).
- Make sure that:
– The subscription order is created in both DIBS and WooCommerce.
– A DIBS transaction number is added to the order notes in WooCommerce.
– The subscription status is set to Active in WooCommerce.
- Wait 24 hours and check that the renewal order is created, a new reservation number from DIBS is added to the order notes in the renewal order and the subscription is set to Active again.
Don’t have time to wait for the renewal to be triggered?
You can also change the date and time for Next payment in the subscription and set it to an earlier time than 24 hours if you don’t want to wait that long.
- Navigate to the subscription (→ WooCommerce → Subscriptions) you want to test.
- In the right column you should see a box named Billing Schedule.
- Click the date field of the Next Payment section. A calendar is now displayed where you can select todays date. The nearest time you can set the renewal to be triggered is 1 hour in the future.
- Wait 1 hour for the renewal to be triggered and then make sure the renewal and subscription behaves as explained in the Get started with subscriptions sec
Moving subscription orders from DIBS D2 to DIBS Easy
Subscriptions orders in DIBS D2 are created with a DIBS recurring token. This recurring token are saved in the post meta field:
_dibs_ticket. In DIBS Easy this recurring token is saved in the post meta field:
_dibs_recurring_token. These are the steps to move the subcription order from DIBS D2 to DIBS Easy:
- Navigate to the subscription order.
- Create a new "Custom Field" and name it: _dibs_recurring_token
- Enter the DIBS Easy recurring token as the value of the field.
- Change the payment method to DIBS Easy.
If the "Add Custom Field" option does not appear on the order page there might be two things that are causing this.
1. In the "Screen Options" tab the "Custom Field" checkbox must be checked. The "Screen Options" can be found in the top right corner when viewing an order.
add_filter( 'acf/settings/remove_wp_meta_box', '__return_false' );
Custom button text for subscription payments
If the cart in WooCommerce contain a subscription product, you have the possibility to change the text displayed on the Complete payment button. The setting can be found in the DIBS Easy plugin settings under: "Complete payment button text". The default value for this setting is "Subscribe".
Translations for the "Complete payment button text" setting selections:
No subscription is being created. When a customer signs up there is only a regular order created.
This is usually happening because a new customer account wasn’t created. The most common reason for this is that the account settings described in the Requirement section isn’t configured correctly.
No renewals are triggered at all
This is usually because you are working in a staging/test environment. WooCommerce Subscriptions have a built-in feature that determine if your installation is a production site or a staging site. From the staging site no renewals are being triggered. Read more about how WooCommerce Subscriptions handle staging sites and migrations here.