PayNow

Connect PayNow with an API key. Analyse creates and manages the webhooks for orders, refunds, chargebacks and subscriptions.

Updated September 15, 20262 min read

PayNow is the least work to connect: you create one API key and Analyse sets up the webhooks for you.

1. Make a role for Analyse

In the PayNow dashboard, open Access, then Roles, and create a role called Analyse with these permissions:

RequiredOptional
View StoreView Subscriptions
View OrdersView Affiliate Links
View PaymentsView Coupons
View WebhooksView Products
Create Webhooks
Delete Webhooks

The optional permissions add subscription details, creator codes from affiliate links, coupon codes and your product catalog.

2. Create an API key

  1. Open Integrations, then API Keys, and create a key with the Analyse role.
  2. Copy the token.

3. Connect in Analyse

  1. In the game's Settings, Integration, choose Connect and pick PayNow.
  2. Paste the token into API key.
  3. If the key can reach more than one store, pick the store that sells for this game.
  4. Choose Connect webhooks. Analyse creates one webhook per event in your PayNow store.

When you disconnect, Analyse deletes the webhooks it created. If someone removes them in PayNow, use Recreate webhooks from the store menu.

Events

PayNow eventWhat Analyse does
ON_ORDER_COMPLETEDRecords the order as completed
ON_REFUNDMarks the refunded lines (or the whole order) as refunded
ON_CHARGEBACKMarks the order as a chargeback
ON_CHARGEBACK_CLOSEDSets the order back to completed if the chargeback was won
ON_SUBSCRIPTION_ACTIVATEDRecords a new subscription
ON_SUBSCRIPTION_RENEWEDRecords the renewal and its payment
ON_SUBSCRIPTION_CANCELEDRecords the cancellation

How purchases map

  • Player: the Minecraft UUID on the order. Bedrock players buying with an Xbox account are matched to their Floodgate UUID. If only a username is known, it is matched as an offline-mode player. Gifts count for the recipient, not the buyer.
  • Package: the PayNow product. Each order line becomes its own row, marked as a one-time purchase, first subscription payment or renewal.
  • Creator code: the affiliate link code. Coupon: the coupon code, when the optional permission is granted.

Past payments

Choose Import past payments in the setup dialog to bring in your order history.