Accept Payments with the Creem Gateway
Selling software or digital downloads abroad means VAT across Europe and sales tax in a growing list of US states, each with its own registration and filing. For a small store, that paperwork can cost more than the sales it covers.
Creem is a merchant of record: it sells to the buyer for you, then works out, collects and remits the tax. Stackless for FluentCart adds it to FluentCart → Settings → Payments as Creem (Stackless), next to Stripe and PayPal. Buyers pay on Creem’s hosted checkout by card, Apple Pay or Google Pay, Creem bills and renews subscriptions, and refunds and cancellations stay in step both ways through a webhook that sets itself up.
Turn On the Gateway
- Go to FluentCart → Stackless and switch on Payment Gateways on the Stackless Dashboard. The switch saves at once.
- Open Settings on the Payment Gateways card, tick Creem under Gateways to add to FluentCart and click Save changes. Clearing it later takes Creem off checkout and keeps its settings saved.
- Open FluentCart → Settings → Payments and choose Manage on Creem (Stackless).
Creem sits in the same list as FluentCart’s own gateways, with the Stackless label. At checkout, buyers see it as Creem.
Connect Your Creem Account
Creem has separate test and live keys. FluentCart’s store mode decides which pair is used: Test order mode uses the test key, Live order mode the live one.
- In Creem, open Developers and copy your API key. The Get live API key and Get test API key buttons on the settings screen open the same page. For the test key, switch the Creem dashboard to test mode first, at the bottom of the sidebar. A test key starts with
creem_test. - Paste the keys into Live API key and Test API key on the Live credentials and Test credentials tabs.
- Turn on Payment Activation and save.
Saving checks the key with Creem and says “Creem connected.” when it works. A live key in the test field, or the other way round, gets an error that says so. Changing a key forgets the Creem products saved for that mode, so new ones are created.
To keep the credentials out of the database, define them in wp-config.php. Their fields then hide. The constants apply to the original gateway, not to copies.
define('GTFC_CREEM_LIVE_API_KEY', 'creem_...');
define('GTFC_CREEM_LIVE_WEBHOOK_SECRET', 'whsec_...');
define('GTFC_CREEM_TEST_API_KEY', 'creem_test_...');
define('GTFC_CREEM_TEST_WEBHOOK_SECRET', 'whsec_...');
Connect the Webhook
On a public HTTPS site there’s nothing to do. Saving an API key creates a webhook in that Creem mode, named after your site, subscribes it to the events below and saves its secret. A webhook already pointing at your URL is reused.
A local site, a site that isn’t on public HTTPS, or a copy of the live store gets an error on save instead. Add the webhook by hand in your Creem dashboard (Creem’s webhook guide shows where), using the URL in the gateway’s Webhook URL field:
https://yoursite.com/?fluent-cart=fct_payment_listener_ipn&method=creem
Select these events, then paste the webhook secret into Live webhook secret or Test webhook secret for the same mode:
checkout.completedsubscription.activesubscription.trialingsubscription.paidsubscription.updatesubscription.scheduled_cancelsubscription.canceledsubscription.past_duesubscription.unpaidsubscription.pausedsubscription.expiredrefund.createddispute.created
Webhooks confirm payments when a buyer closes the tab before coming back, record renewals and failed renewals, and bring refunds, cancellations and disputes made in Creem into FluentCart. Each event is applied once, and an unsigned or badly signed one is refused.
Set How Tax Works
- Prices and tax: Add tax on top of my prices (the default) or My prices already include tax.
- Tax category: Software as a service (the default), Digital goods or services or E-books. Creem uses it to pick the rate for each buyer’s country.
Turn off FluentCart tax for orders paid through Creem, or buyers get taxed twice. Changing either setting starts fresh Creem products.
What Buyers See
- With tax on top, a note under the payment method says “Creem adds sales tax or VAT for your location on the next step, so you may pay more than the total shown here.” If you write your own checkout instructions, they show first and the note follows.
- Placing the order shows “Redirecting to Creem to complete your payment” and sends the buyer to Creem’s checkout with their email filled in.
- Back on your site, Stackless reads the checkout from Creem before it marks the order paid. If Creem hasn’t finished, the receipt shows the real state and the webhook completes it.
- When Creem added tax, the receipt and the order email show what the buyer paid, such as “You paid $23.90 through Creem: $20.00 for this order plus $3.90 sales tax or VAT, which Creem collects as the merchant of record.”
If Creem reports a payment in another currency or for another amount, the order isn’t confirmed automatically, and its log says to check the payment in Creem before you deliver.
Products in Your Creem Catalog
Every Creem checkout sells a product from your Creem catalog. Stackless creates them on first use and remembers them for each mode, so there’s nothing to set on your FluentCart products.
- One-time orders pass the order total to Creem, so coupons, sale prices and Pay What You Like amounts need no new product.
- Carts with several items show in Creem as one product named after your store, such as “Your Store order”.
- Subscriptions use one Creem product per option, schedule, amount and trial length.
- A product archived or deleted in Creem is created again on the next checkout.
Creem Subscriptions
Creem runs the renewal schedule for subscriptions set to renew automatically:
- Daily, weekly, monthly, quarterly, half-yearly and yearly plans work. A plan on another schedule is refused at checkout.
- Creem bills the same amount every cycle, so a subscription with a signup fee or a different first payment can’t use Creem. Free trials work: the trial checkout is $0 and saves the card.
- Each renewal Creem charges becomes a paid renewal order in FluentCart. A failed renewal adds a “Creem renewal failed” note, and Creem retries the card on its own schedule.
- Canceling in FluentCart cancels in Creem, at once or at the end of the paid period. Canceling in Creem cancels the FluentCart subscription. When Creem reports a subscription as expired, FluentCart follows the status Creem gives it, so an active subscription stays active.
- Changing a subscription’s plan or payment method in FluentCart cancels the Creem subscription.
- Sync on the subscription reads its latest state and payment from Creem. Billing Health can sync overdue Creem subscriptions in bulk.
Creem Refunds
- A refund from FluentCart refunds the whole payment in Creem.
- For a partial refund, make it in the Creem dashboard. It appears on the order by itself.
- Refunds made in Creem are recorded on the order once. A refund you start in FluentCart gets Creem’s refund ID when Creem confirms it by webhook.
- A dispute adds a “Creem dispute” note to the order. Respond to it in Creem.
Currencies
Creem charges in US dollars and euros, from 1.00, and one-time payments up to 999,999.99. A checkout in any other currency that tries Creem gets “Creem cannot charge in GBP. Choose another payment method.” With Multi-Currency Checkout, route USD and EUR to Creem and other currencies to another gateway.
More Than One Creem Store
Creem supports gateway copies. Duplicate it on the Payments screen to connect a second Creem store, with its own keys, webhook URL and products. Copies use the method key creem_copy2 and so on, which Payment method links and Modal Checkout classes such as pay-via-creem also use.
Limits
- Stackless’s Creem gateway was checked against Creem’s API reference and tested against a simulated Creem API, not a live Creem account. Before you take real payments, place a test-mode order and a test refund, and check that the webhook shows up in Creem and the order turns paid.
- Creem takes US dollars and euros only, from 1.00 per payment. A one-time payment above 999,999.99 is refused before checkout.
- No signup fees or discounted first payments on subscriptions.
- Partial refunds have to start in the Creem dashboard.
- Use FluentCart coupons, not Creem discount codes. A payment with a Creem discount doesn’t match the order total, so it isn’t confirmed automatically.
- Stackless doesn’t offer buyers a Creem page to update their card, and pausing or resuming a subscription happens in Creem only.
- Sync only sees a subscription’s latest Creem payment. Record an older missed renewal by hand.
- On copies of the live store, nothing is refunded or canceled at Creem, and a copy never takes over the live webhook. Use test mode there.
For Developers
| Hook | Type | Use |
|---|---|---|
gtfc/creem/settings | filter | The gateway’s settings when they load: ($settings). |
gtfc/creem/currencies | filter | The currencies Creem is offered for: ($currencies). It can only narrow USD and EUR. |
gtfc/creem/billing_intervals | filter | Maps FluentCart billing intervals to Creem’s. |
gtfc/creem/checkout_args | filter | The checkout request sent to Creem: ($body, $context), where the context holds the order, transaction and subscription. |
gtfc/creem/product_args | filter | A Creem product before it is created: ($body, $item, $billing, $mode). |
gtfc/creem/webhook | action | Runs for each verified event: ($type, $object, $mode). |
gtfc/creem/subscription_synced | action | Runs after a subscription is updated from Creem: ($subscription, $remote, $event). |
Offer Creem for euro carts only:
add_filter('gtfc/creem/currencies', function () {
return ['EUR'];
});