Payment gateways
Creem
Set up Creem, a merchant of record for card payments in USD or EUR, with refunds and subscriptions.
Creem is a merchant of record: it sells to the player in its own name, handles sales tax and pays you out. It supports refunds, disputes and subscriptions, and bills in USD or EUR only.
| Gateway id | creem |
| Refund by API | Yes, always the whole payment |
| Recurring | Yes, for durations of whole days (up to 365) or whole weeks (up to 52) |
| Status lookup | Yes |
| Disputes | Yes |
| Webhook | You add it in the Creem dashboard |
| Currencies | USD and EUR, minimum 1.00 |
Setup
Get an API key
Copy an API key from the Creem dashboard. Test mode and live mode are fully separate, with their own keys and webhook secrets.
Add the webhook
In the Creem dashboard, add a webhook pointing at <webhook.public-base-url>/webhook/creem and copy its secret. Emberstore uses checkout.completed, subscription.paid, subscription.canceled, subscription.scheduled_cancel, refund.created and dispute.created.
Fill in config.yml
creem:
enabled: true
icon: PRISMARINE_SHARD
currency: ""
# API key from your Creem dashboard
api-key: "..."
# Secret of the webhook registered for this plugin
webhook-secret: "..."
# Use the Creem test mode instead of live
sandbox: trueSet sandbox: false with live keys when you go live. Run /store admin reload.
Good to know
- Products are created for you. Creem cannot charge a free amount, so Emberstore creates one Creem product per item (tax included, as a digital good) and reuses it. Recurring items get one product per price, so a sale or code on a recurring item leaves extra products in your Creem store.
- Tax is included in the price. If you change a product to add tax on top, Emberstore no longer matches it and makes a fresh one.
- Discount codes on the Creem page lower what was paid, so that order goes to Needs review. Use Emberstore's own codes instead.
- Subscriptions bill every n days or n weeks, never by calendar month. Cancelling ends the subscription when the paid period is over.
- Creem has no expiry setting for its checkout page. A payment after Emberstore expired the order goes to Needs review.