← Developers
Start here
QuickstartSDKAuthentication
Identity
Sign in with Shin ID
Access
EntitlementsUsage & Qualified Active Days
Money
Purchases & refundsWebhooksVerifying signatures
Selling
Importing a productGitHub importSelling without the SDKCurrencies and pricingBuy with Guiru from your own site
Operating
Integration diagnosticsErrors & rate limitsTestingMobile API
Reference
ReferenceVersioning & changesFor agents
Machine-readable
llms.txt
Money

Purchases & refunds

What Buy with Guiru does on your behalf, and the two events you actually handle.

With Buy with Guiru, checkout happens on the product page and Guiru handles payment, receipt, refund and the entitlement that follows. Your product is told about the result; it never sees a card.

The sequence, for one sale:

text
buyer pays on /p/<your-product>
  → entitlement granted
  → purchase.completed      (webhook)
  → entitlement.created     (webhook)
your app: GET /api/v1/entitlements → active: true

And for a refund or a chargeback, in the same shape — purchase.refunded (with chargeback: true when the bank decided it) and entitlement.refunded. Close the door when you receive it.

External and affiliate offers

A product sold on your own store or through an affiliate link carries no take rate, because Guiru is not in that transaction — and equally, none of this applies to it: no entitlement, no webhook, no Member reach, no pool. The API has nothing to say about a sale it never saw. See pricing.

Payouts

Money is reconciled on Guiru's side and settled to the builder; there is no payouts endpoint, and the ledger is visible in your product console rather than through the API.

PreviousUsage & Qualified Active DaysNextWebhooks
Guiru
AboutStoreHow Guiru worksQuality BarGSPGuiru MemberStatus
Buying
Buy with GuiruYour libraryRefundsBuyer termsTrust & safety
Builders
For buildersSubmit a productGuiru ProPricing & feesPromoteDeveloper docs
Help
Help centreYour libraryBuying & refundsHow a product gets listedHow ranking worksReport a problem
Legal
All policiesTermsPrivacyCookiesCreator PoolAffiliate disclosure
Your account
Account settingsSign in
Shin AI
Shin WebsiteKatsuiTrouble? Message Mario
Find your next favourite. Software, games and digital products on Guiru.Guiru Beta · Feedback© 2026 Shinai Tecnologias I.S.
Beta
StoreLibraryBuildersMember
Sign in
StoreSearchLibraryMemberSign in