Delen via


API's van Marketplace voor betaling naar gebruik - veelgestelde vragen

Zodra een klant zich abonneert op een SaaS-service, Azure-toepassing met een beheerd apps-abonnement of kubernetes-appaanbieding met facturering naar gebruik, houdt u het verbruik bij voor elke factureringsdimensie die wordt gebruikt. Als het verbruik de opgenomen hoeveelheden overschrijdt die zijn ingesteld voor de termijn die door de klant is geselecteerd, verzendt uw service gebruiksgebeurtenissen naar Microsoft.

Voor SaaS-aanbiedingen, beheerde apps en Kubernetes-app-aanbiedingen

Hoe vaak wordt verwacht dat het gebruik wordt verzonden?

Idealiter wordt verwacht dat u elk uur het gebruik voor het afgelopen uur verzendt, alleen als er gebruik is in het vorige uur.

Is er een maximale periode tussen één emissie en de volgende?

Er is geen dergelijke beperking. Verzendt alleen het gebruik naarmate deze zich voordoet. Als u bijvoorbeeld slechts één gebruikseenheid per levensduur van het abonnement hoeft in te dienen, kunt u dit doen.

Wat is de maximale vertraging tussen de tijd dat een gebeurtenis plaatsvindt en de tijd dat een gebruiks gebeurtenis naar Microsoft wordt verzonden?

In het ideale geval wordt de gebruiksgebeurtenis elk uur verzonden voor gebeurtenissen die in het afgelopen uur hebben plaatsgevonden. Vertragingen worden echter verwacht. De toegestane maximale vertraging is 24 uur, waarna gebruiksevenementen niet worden geaccepteerd. De best practice is om elk uur gebruik te verzamelen en te verzenden is als één gebeurtenis aan het einde van het uur.

Als een gebruiksevenement bijvoorbeeld om 13:00 uur op een dag plaatsvindt, hebt u tot 13:00 uur op de volgende dag om een gebruiksevenement te verzenden dat aan deze gebeurtenis is gekoppeld. Als het systeem dat het gebruik verzendt uitvalt, kan het de gebruiksgebeurtenis herstellen en vervolgens verzenden voor het uurinterval waarin het gebruik is gebeurd, zonder verlies van betrouwbaarheid.

Als 24 uur na het werkelijke gebruik is verstreken, kunt u de verbruikte eenheden nog steeds verzenden met latere gebruiksgebeurtenissen. Deze praktijk kan echter de geloofwaardigheid van de factureringsgebeurtenisrapporten voor de eindklant schaden. We raden u aan om het verzenden van meteruitgifte één keer per dag/week/maand te vermijden. Het is moeilijker om het werkelijke gebruik door een klant te begrijpen en om problemen of vragen op te lossen die kunnen worden gesteld met betrekking tot gebruiksevenementen.

Een andere reden om elk uur gebruik te verzenden, is om situaties te voorkomen dat de gebruiker het abonnement annuleert voordat de uitgever de dagelijkse/wekelijkse/maandelijkse emissie-gebeurtenis verzendt.

Wat gebeurt er wanneer u meer dan één gebruiksevenement in hetzelfde uur verzendt?

Er wordt slechts één gebruiksgebeurtenis geaccepteerd voor het interval van één uur. Het uurinterval begint op minuut 0 en eindigt op minuut 59. Als er meer dan één gebruiksgebeurtenis voor hetzelfde uur wordt verzonden, worden alle volgende gebruiksgebeurtenissen verwijderd als duplicaten.

Wat gebeurt er wanneer de klant de aankoop annuleert binnen de tijd die is toegestaan door het annuleringsbeleid?

Het forfaitaire bedrag wordt niet in rekening gebracht, maar het overschrijdingsgebruik zal zijn.

Kunnen aangepaste meterplannen worden gebruikt voor eenmalige betalingen?

Ja, u kunt een aangepaste dimensie definiëren als één eenheid van eenmalige betaling en deze slechts één keer verzenden voor elke klant.

Kunnen aangepaste meterabonnementen worden gebruikt voor gelaagd prijsmodel?

Ja, deze kan worden geïmplementeerd met elke aangepaste dimensie die één prijscategorie vertegenwoordigt.

Contoso wil bijvoorbeeld $ 0,5 per e-mail in rekening brengen voor de eerste 1000 e-mailberichten, $ 0,4 per e-mail tussen 1000 en 5000 e-mails en $ 0,2 per e-mail voor meer dan 5000 e-mailberichten. Ze kunnen drie aangepaste dimensies definiëren die overeenkomen met de drie prijscategorieën voor e-mail. Verzend eenheden van de eerste dimensie zolang het aantal e-mailberichten onder de 1000 blijft, vervolgens eenheden van de tweede dimensie wanneer het aantal e-mailberichten tussen 1000 en 5000 ligt en ten slotte eenheden van de derde dimensie voor meer dan 5000 e-mailberichten.

Wat gebeurt er als de Marketplace-meterservice een storing heeft?

Als de ISV een aangepaste meter verzendt en een fout ontvangt, die mogelijk is veroorzaakt door een probleem aan de zijde van Microsoft (meestal in het geval dat vergelijkbare gebeurtenissen werden geaccepteerd voordat er een fout optreedt), moet de ISV wachten en de emissie opnieuw proberen.

Als de fout zich blijft voordoen, dient u die aangepaste meter het volgende uur opnieuw in (de hoeveelheid verzamelen). Ga door met dit proces totdat er een niet-foutreactie wordt ontvangen.

Alleen voor SaaS-aanbiedingen

Wat gebeurt er wanneer u het gebruik verzendt voor een SaaS-abonnement dat al is afgemeld?

Elke gebruiksgebeurtenis die naar het Marketplace-platform wordt verzonden, wordt niet geaccepteerd nadat een SaaS-abonnement is verwijderd.

Gebruik kan alleen worden verzonden voor abonnementen in de status Geabonneerd (en niet voor abonnementen in PendingFulfillmentStart, Suspendedof Unsubscribed status).

De enige uitzondering is het rapporteren van gebruik voor het moment dat het SaaS-abonnement is geannuleerd.

De klant heeft bijvoorbeeld vandaag om 13:00 uur het SaaS-abonnement geannuleerd. Nu is het 17:00 uur, de uitgever kan nog steeds gebruik verzenden voor de periode tussen 18:00 en 18:00 uur vandaag voor dit SaaS-abonnement.

Kunt u een lijst krijgen met alle SaaS-abonnementen, inclusief actieve en afgemelde abonnementen?

Ja, wanneer u de GET Subscriptions List-API aanroept, omdat deze een lijst bevat met alle SaaS-abonnementen. Het statusveld in het antwoord voor elk SaaS-abonnement legt vast of het abonnement actief of afgemeld is.

Zijn de begin- en einddatums van de saaS-abonnementsperiode en overschrijdingsgebruiksemissie verbonden?

Overschrijdingsgebeurtenissen kunnen op elk moment worden verzonden voor een bestaand SaaS-abonnement in de status Geabonneerd . Het is de verantwoordelijkheid van de uitgever om gebruiksevenementen te verzenden op basis van het beleid dat is gedefinieerd in het factureringsplan. De overschrijding moet worden berekend op basis van de datums die zijn gedefinieerd in de termijn van het SaaS-abonnement.

Als de uitgever bijvoorbeeld een SaaS-abonnement definieert met 1000 e-mailberichten voor $ 100 in een maandelijks vast tarief, wordt elke e-mail boven de 1000 $ gefactureerd via een aangepaste dimensie.

Wanneer de klant het abonnement op 6 januari koopt en activeert, wordt de e-mail van 1000 die in het vaste tarief is opgenomen, meegeteld vanaf deze dag. Dus als tot 5 februari (einde van de eerste maand van het abonnement) slechts 900 e-mailberichten worden verzonden, betaalt de klant het vaste tarief alleen voor de eerste maand van dit abonnement en worden er tussen 6 en 5 februari geen overschrijdingsgebeurtenissen verzonden door de uitgever. Op 6 februari wordt het abonnement automatisch verlengd en wordt het aantal opnieuw gestart. Als op 15 februari de klant 1000 e-mailberichten heeft bereikt die zijn verzonden, worden de rest van de verzonden e-mailberichten tot 5 maart in rekening gebracht als overschrijding ($ 1 per e-mail) op basis van de overschrijdingsgebeurtenissen die door de uitgever zijn verzonden.

Volgende stappen