Prenumerationer
Coin Moebius kan sälja återkommande prenumerationer på varje fiat-leverantör i din meny. Handlaren konfigurerar priset och intervallet en gång på en produkt; köpknappen på webbplatsen förblir exakt densamma. Betalningsleverantören kör den återkommande debiteringen, håller kortet, gör nya försök vid misslyckade förnyelser och hostar uppsägningssidan. Coin Moebius vidarebefordrar livscykelhändelserna till din kod.
Sätta upp en återkommande produkt
I instrumentpanelens Produkter-flik, ställ in fältet Debitering till Månadsvis eller Årsvis istället för Engångs. Ett valfritt fält Gratis provperiod visas för eventuella provdagar du vill ge före den första debiteringen. Spara produkten.
Köpknappens HTML ändras inte. Samma attribut product-id="pro-plan" fungerar för engångs eller återkommande; workern kontrollerar produktens debiteringsinställning vid checkout-tillfället och dirigerar genom leverantörens prenumerations-API när det är tillämpligt.
<coin-moebius-buy
project-id="proj_YOUR_ID"
product-id="pro-plan"
label="Subscribe to Pro">
</coin-moebius-buy>Vad du inte behöver bygga
Leverantören kör schemat. Vi lagrar inga kort. Vi kör inga cron-jobb. Vi gör inga nya försök vid misslyckade debiteringar. Vi skickar inga påminnelsemejl. Vi hostar ingen uppsägningssida. Hela den sidan av systemet lever inuti Stripe (eller vilken fiat-leverantör du än anslutit). Du lägger ut de svåra delarna av återkommande debitering på företaget som redan kör dem för miljontals handlare.
Prenumerationshändelser
Förnyelser och uppsägningar dyker upp som webhook-händelser som din server kan reagera på. Fem normaliserade typer täcker livscykeln:
| Händelse | När den utlöses |
|---|---|
subscription.created | Ny registrering. Bär den första cykelns belopp. |
subscription.renewed | En icke-initial cykel lyckades. Förläng åtkomsten genom det nya periodslutet. |
subscription.payment_failed | En cykels kort nekades. Leverantörens påminnelser gör nya försök enligt sitt schema; du loggar oftast bara detta för synlighet. |
subscription.canceled | Slutgiltig uppsägning. Köparen sade upp, påminnelserna tog slut, eller handlaren sade upp. |
subscription.updated | Statusändring, kortuppdatering, planändring. Inspektera den nya statusen. |
Identifiera köpare utan att lagra dem
Coin Moebius är en betalningsrouter, inte en kunddatabas. Vi lagrar aldrig köpares e-postadresser, namn, adresser eller leverantörens interna kund-id:n. Om din applikation har användarkonton (de flesta prenumerationsappar har det), skicka ditt eget ogenomskinliga användar-id som customer-ref på köpknappen. Knappen vidarebefordrar det till workern som metadata.customerRef, vi trär det genom till leverantören, ytar det tillbaka på varje händelse, och lagrar endast den ogenomskinliga strängen. För oss är den meningslös; för dig är den främmande nyckeln in i ditt eget användarsystem.
<coin-moebius-buy
project-id="proj_YOUR_ID"
product-id="pro-plan"
customer-ref="user_bob_42">
</coin-moebius-buy>När du behöver djupare köpardetaljer (e-post, kortets fyra sista, tvistanteckningar) länkar instrumentpanelen varje korttransaktion ut till leverantören som hanterade den (Stripe, PayPal, Square eller Authorize.Net), där köparposten faktiskt lever. Du klickar dig vidare; vi duplicerar den aldrig.
Uppsägning: länka ut, bygg inte
Köpare säger upp i leverantörens värdbaserade portal: Stripe Customer Portal, köparens PayPal-kontosida, och så vidare. Portalen hanterar uppsägning, kortuppdateringar, kvittonedladdningar och planändringar, allt gränssnitt du inte behöver bygga. Du kan släppa in köparen i portalen med ett API-anrop:
const res = await fetch(
`https://api.coinmoebius.com/api/subscriptions/${projectId}/${subId}/portal-url`,
{ method: 'POST', body: JSON.stringify({ returnUrl: 'https://you.example/account' }) },
);
const { url } = await res.json();
window.location.assign(url);Vilka leverantörer stödjer prenumerationer idag
Stripe och PayPal fungerar från början till slut genom den värdbaserade köpknappen. Ställ in en produkt på Månadsvis eller Årsvis i din instrumentpanel, klistra in knappen på din sida, och klicket startar en riktig prenumeration. Leverantören kör förnyelserna.
Square och Authorize.Net kör inte prenumerationer genom den värdbaserade köpknappen. Du skapar prenumerationen genom din egen integration med leverantören (för Authorize.Net innebär det att samla in kortet på din egen sida med Accept.js; Square har sin egen värdbaserade prenumerationscheckout som du kan använda), och pekar sedan leverantörens webhook mot oss. Därifrån fungerar resten av systemet (webhook-dirigering, instrumentpanel, statusendpoint, kundlänkning) exakt på samma sätt som det gör för Stripe- och PayPal-prenumerationer. Se nästa avsnitt.
Kryptoleverantörer (NOWPayments) stödjer inte återkommande debitering i den här produkten. Återkommande krypto är friktionstungt på varje gateway vi utvärderat; vi skickar hellre inget än skickar en halvtrasig berättelse om det.