Emberstore logoEmberstore
Payment gateways

Litepay

Set up Litepay.ch crypto invoices with your vendor id and secret key.

Litepay.ch takes crypto through a simple merchant invoice. It has no refunds, no subscriptions and no way to look a payment up, so orders wait for Litepay's callback.

Gateway idlitepay
Refund by APINo, refunds are handled outside the plugin
RecurringNo
Status lookupNo
DisputesNo
WebhookSent with each checkout (as a GET request), nothing to register
CurrenciesUSD, EUR, GBP, AUD, CHF, CAD, RON, PLN and INR, minimum 1 unit

Setup

Get your vendor details

Your vendor id (6 characters) and secret key (32 characters) arrive by email when the vendor id is created. The secret is shown only once.

Fill in config.yml

litepay:
  enabled: true
  icon: GLOWSTONE_DUST
  currency: ""
  # Vendor id from your Litepay merchant dashboard
  vendor-id: "..."
  # Secret key emailed when the vendor id was created
  secret-key: "..."

success-url must be set, Litepay needs a return address. Run /store admin reload.

Good to know

  • How callbacks are trusted. Litepay does not sign its callbacks, so Emberstore adds a token made from your secret key to each callback address, and accepts only callbacks from Litepay's two published addresses. Behind a reverse proxy, set proxy.real-ip-header and proxy.trusted-addresses so the real sender can be seen, otherwise only the token is checked.
  • The amount is not reported, so a short payment cannot be spotted. Keep Litepay's Cover Amount setting low.
  • Incomplete payments you accept by hand at Litepay should be given with /store admin give.
  • The callback address must stay under 255 characters, so keep webhook.public-base-url short.
  • A payment after Emberstore expired the order goes to Needs review.

On this page