Share this post on Twitter

Dynamic statement descriptions

Jeff Balogh on March 14, 2014

You can now add a per-charge description—a “dynamic descriptor” in the industry jargon—to transactions on your customers’ credit card statements. We still recommend that you include your business name in your per-charge description, but the additional context can help reduce confusion, customer enquiries, and chargebacks.

You can use the description for anything you like: the product purchased, the plan the customer subscribed to, or the name of the seller on a marketplace. To get started, just pass the statement_descriptor parameter when creating a charge:

curl \
  -u sk_test_mkGsLqEW6SLnZa487HYfJVLf: \
  -d customer=cus_6SLnZan487He \
  -d amount=400 \
  -d currency=usd \
  -d statement_descriptor="5K Race Ticket"

You can also specify a statement_descriptor on a plan. If you do this, all subscription charges created will automatically have this dynamic descriptor.

We added this feature based on your feedback—if you’ve got other suggestions, we'd love to hear from you.