Gumroad Ping is a simple alert that notifies you in real time whenever one of your products is purchased.

The ping comes in the form of an HTTP POST request to the URL that you specify in your account settings. You can also use our API and subscribe to be notified of future sales. If your endpoint does not return a 200 HTTP status code, the POST is retried once an hour for up to 3 hours.

For security reasons we highly recommend that you use an HTTPS endpoint as your URL.

You can use Gumroad Ping to:

In each request, Gumroad sends these parameters:

  • sale_id (the id of the sale)
  • order_number (numeric version of sale_id)
  • seller_id
  • product_id
  • product_permalink
  • email (the email of the buyer)
  • full_name (if present, the name of the buyer)
  • purchaser_id (the id of the purchaser's Gumroad account, if the purchaser has one)
  • ip_country (if present, the country of the buyer's IP address)
  • price (the price paid, in USD cents)
  • recurrence (if present, the recurrence of the payment option chosen by the buyer such as 'monthly', 'yearly', etc)
  • variants (if present, a dictionary {'size' : 'large', 'color' : 'red'})
  • offer_code (if present)
  • test (if you are buying your own product, for testing purposes)
  • custom_fields (if present, a dictionary {'name' : 'john smith', 'spouse name' : 'jane smith'})
  • shipping_information (if present, a dictionary)
  • is_recurring_charge (if relevant, a boolean)
  • is_preorder_authorization (if relevant, a boolean)
  • license_key (if licenses are enabled for the product)
  • quantity
  • shipping_rate (the shipping paid, in USD cents, if the product is a physical product)
  • affiliate (if present, the affiliate's email address)
  • affiliate_credit_amount_cents (if present, the amount paid to the affiliate in USD cents)

You can quickly test and experiment with Ping by using RequestBin: http://requestb.in/.