Installation form

When you have uploaded the script, you will see an installation form. You can skip the manual configuration below.

Manual configuration

In the root of the project there is a file named .env.example. Rename this file to .env and open it with an editor. After configuring all settings, upload the file.

Make sure there is a dot (.) in front of the file name. If you rename the file in Windows check this out.

Mailgun

If you use mailgun, change:

MAIL_DRIVER=mail

to:

MAIL_DRIVER=mailgun

And enter settings accordingly as found here.

MAIL_DRIVER=mailgun
MAIL_HOST=smtp.mailgun.org
MAIL_PORT=587
MAIL_ENCRYPTION=tls
MAIL_USERNAME=[SMTP username]
MAIL_PASSWORD=[SMTP password]

# Mailgun settings (optional)
MAILGUN_DOMAIN=[your mailgun domain, e.g. mg.example.com]
# You can find the Private API key by logging in to your Mailgun dashboard
# and navigate to Settings > API Security.
MAILGUN_SECRET=[Private API key]

Payment gateway

Manual

By default the admin can manage subscriptions and expiration dates manually.

Stripe

If you use Stripe your webhook url is https://example.yourdomain.com/api/webhooks/stripe. Replace "example.yourdomain.com" with the domain or subdomain of your installation. You can configure this in your Stripe dashboard if you go to Developers > Webhooks > Add endpoint. Or click here.

Select receive all events when adding the webhook endpoint, or:

  • customer.deleted
  • invoice.payment_succeeded
  • customer.subscription.updated

Paddle

If you use Paddle your receiving webhook url is https://example.yourdomain.com/api/webhooks/paddle. Replace "example.yourdomain.com" with the domain or subdomain of your installation. You can configure this in your Paddle dashboard if you go to Developer Tools > Alers / Webhooks > URL for receiving webhook alerts. Or click here.

2Checkout

For 2Checkout your webhook (IPN) is https://example.yourdomain.com/api/webhooks/2checkout/ipn. Replace "example.yourdomain.com" with the domain or subdomain of your installation. You can configure this in your 2Checkout dashboard if you go to Integrations > Webhooks & API > IPN settings > Add IPN URL. Or click here.

You will also find your Merchant code and Secret key on the IPN settings page.

Make sure these response tags are checked (others can be checked too, but the tags below are required):

  • AVANGATE_CUSTOMER_REFERENCE
  • EXTERNAL_CUSTOMER_REFERENCE
  • IPN_PID
  • IPN_DATE
  • IPN_LICENSE_EXP
  • ORDERSTATUS
  • FIRSTNAME
  • LASTNAME

Edit .env file

After editing and uploading this file, proceed with the next step.