New permission! - API Tokens

All merchants using Recharge can now access a new 'permission' to set whether a Recharge user can view/access the 'API Tokens' page under Integrations page. 

With this update, Recharge API token generation is ungated for any user with the appropriate permission!

Who has access by default? 

  • All users with 'Store Owner' profile
  • All users on stores that had API token permissions prior to Nov 5, 2021

Confirm you've access! A 'Store Owner' can instantly enable this permission for users by clicking the 'API tokens' checkbox on the 'Permissions' section of their merchant portal. 

IMPORTANT: The 'store owner' must read and accept the new terms of service for Recharge API before any user can access the API tokens page or generate a new API token. 

To learn more about permissions, click here

To learn more about our updated API terms of service, click here

New API endpoint: Token Information

Developers using Recharge API (v2021-01 and v2021-11) now have the ability to access key API token information with a simple GET request. 

Once executed, the API resource will return information such as

  • API token name
  • Contact email associated with the API token
  • Permission scope associated with the API token

Developers working with multiple tokens can use this endpoint as an admin tool to speed up their workflows. For example, a developer could prevent errors associated with incorrect permissions by quickly checking the API token permissions prior to accessing the endpoint.

Try it today with GET api.rechargeapps.com/token_information

To learn more, visit our API reference documentation here

You can also check out this blog post on how Recharge is empowering our developer community. 

Configurable rate limits for Recharge API tokens!

Merchants using the Recharge API can now have access to configurable rate limits through their API tokens. This update represents significant efficiency gains within our API and with these configurable rate limits, merchants can scale rapidly and implement innovative promotions reliably. 

  • New API tokens for merchants on the PRO or ENTERPRISE plan now default to 2X the existing call volumes.
  • Even higher rate limits are available upon request for merchants who use the Recharge API heavily. 

These new rate limits can be several times the existing rate limits and enabling them would require the generation of a new API token from the Integrations page. Once created, these new API Tokens will include a prefix, as shown below:

  • ‘sk’ indicates that this is a secret key that must remain confidential and not shared publicly in any way
  • Example: 2x1 - this is the rate limit multiplier with 2X the current leak rate (standard is 2 requests/sec) and 1X the bucket size (standard bucket size of 40 requests).

If a store is at the maximum token limit, an existing token should be replaced with a new API token that supports the higher rate limits. 

Check it out today! 

Recharge API v2021-11 is now available!

The 2021-11 version of the Recharge API includes exciting updates that represent a stronger foundation for the future and show our commitment to an API-first approach that will enable the Recharge community to meet evolving business needs.

Here are six notable changes.
  1. Global standards: This version includes many new global standards across all resources. This helps provide a consistent and intuitive experience across the entire scope of the Recharge API.
  2. Products and Plans: We have rearchitected our Products resource and added a new Plans resource,  paving the way to a more flexible future, with support for complex purchase options
  3. StoreThe store resource replaces the Shop resource from 2021-01.
  4. Payment Methods : This new resource includes payment method information associated with customers. Each customer can have multiple payment methods.
  5. Improved Pagination: Cursors included as in-body attributes. You no longer have to parse through response headers to retrieve cursors, and can page through data faster than ever before.
  6. Token Information Resource: Retrieve the name and permission scopes associated with your token without having to go to the Token Information page.
To learn more about this new version, check out the following resources. 

Storefront widget customization with Recharge CDN

Merchants using Recharge Platform APIs for a custom/headless store now have direct access to non-sensitive data within Recharge CDN. This access includes the following:

  • Product data
  • Subscription plan data
  • Recharge storefront widget settings
  • Store settings

Merchants can use this direct CDN access to more efficiently and securely build highly customized versions of the Recharge storefront widget. 

To learn more, visit our developer guides here.

API automation for adding one-time purchase to a scheduled charge

Merchants using the Recharge Platform APIs can use the Onetimes API to set one-time purchases to automatically add itself to the next scheduled charge for the associated address. 

This automation can streamline one-time purchase workflows for our merchants by eliminating manual intervention while simultaneously reducing required API calls. 

For more information, view our API documentation here

Test Webhook Connectivity

Summary API Feature 

ReCharge has added support for testing webhooks, leveraging our latest, highly performant webhook architecture!

How to

Using the ReCharge API, you can now POST to the following URL, using a webhook_id that you have registered using your API Token:

https://api.rechargeapps.com/webhooks/<webhook_id>/test

Immediately following your request, a webhook with empty payload will be delivered to the registered address. This enables users to quickly and easily verify that they can receive Webhooks from ReCharge.

Learn more

For details, and to learn more about ReCharge Webhooks, visit our API documentation here!

New Webhooks for Refunds and Cancelled Orders

With an average latency of just two seconds, webhooks are the best way for your connected applications to get real-time notification of events within ReCharge. In addition to significant performance improvements, ReCharge now offers two new webhook topics to keep systems in sync.

  • charge/refunded - When a charge is refunded from within the ReCharge Admin Portal or via API, a charge/refunded webhook will be dispatched to the subscribed URL. The webhook will contain the standard payload of a charge, included a total_refunds parameter to indicate the total refunded amount (in dollars) associated with the charge. 
  • order/cancelled  - when an order is cancelled from within the ReCharge Admin Portal or via API, an order/cancelled webhook will be dispatched to the subscribed URL. The webhook will contain the standard payload of an order webhook, including a status indicator denoting that the order has been cancelled.

Learn more about using ReCharge webhooks, including a comprehensive list of available topics, by checking out the ReCharge API Reference

ReCharge API - Sort Results of GET (list) Requests

How does it work? API 

When retrieving lists of data with the ReCharge API, users can now include a sort_by parameter in the URL of the GET request to specify the order of results. Sort_by values indicate the parameter to sort on, and the direction of sorting (such as updated_at-desc). 

Example:

GET https://api.rechargeapps.com/orders?sort_by=shipping_date-desc

Where can I learn more?

Available sort_by values vary between endpoints. For a complete list of available sort_by values for each resource, and to learn more about sorting API results, see the "Retrieving Data" section of our API documentation

Discounts by Channel, Async Batch API, and More...

Feature

Discounts - Channel Settings

  • Merchants can now control which channels (checkout, customer portal, etc.) will accept a discount. This is a great way to offer subscriber-only discounts (only applicable in the customer portal channel), admin-only discounts (only applicable in the merchant portal), and more.

Enhancement 

  • Added option to turn off failed charges handling by ReCharge so that it can be handled by a 3rd party service. Useful if you have 3rd party service handling your dunning emails and charge retries.
  • Added an option to control if one-time products are available for purchase on the customer portal
  • Customer email is now included in the new subscriptions CSV exports 

API & Webhooks 

Async Batch API - Updates

  • Async batch API permissions are now available when creating an API token
  • New batch_types to create, update, and delete products
  • New batch_types to create, update, and delete subscriptions 
  • Attempting to process an async_batch with 0 tasks now returns an error

Webhook - Updates

  • Subscription/updated webhook is triggered upon subscription activation and cancellation
  • Fixed a bug resulting in empty charge/created and charge/updated webhooks
  • Fixed a bug resulting in missing address/updated webhooks

API - Enhancements

  • Subscription cycle parameters are now added to Shopify order notes_attributes for Signifyd integration users
  • Improved validation for phone numbers when creating a customer via API
  • Customer payment method updates are now reflected on customer object without processing next charge

API - Bug Fixes

  • Fixed a bug where entering emoji in discount code field caused 500 error
Show Previous EntriesShow Previous Entries