This repository has been archived by the owner. It is now read-only.

set descriptor per-transaction #3507

Closed
chadwhitacre opened this Issue Jun 1, 2015 · 8 comments

Comments

Projects
None yet
1 participant
@chadwhitacre
Contributor

chadwhitacre commented Jun 1, 2015

In the charge notifications emails we send out, we include the names of the teams the person is giving to that resulted in the charge. It would be great to get this info onto their actual card statements if possible.

Want to back this issue? Post a bounty on it! We accept bounties via Bountysource.

@chadwhitacre

This comment has been minimized.

Show comment
Hide comment
@chadwhitacre

chadwhitacre Jun 1, 2015

Contributor

To: Braintree

What's the current descriptor for Gratipay? Is this something I can view and edit in the dashboard?

From: Braintree

Your descriptor currently appears as “GRATIPAY 4129254220 PA”. Let me know if you’d like to change this. This article may be helpful in better understanding your options! These details are not available within your gateway, but if you are interested in changing them, you can reach out to support@braintreepayments at any time.

To: Braintree

Thanks, []. Could we turn on dynamic descriptors for our account, please?

Contributor

chadwhitacre commented Jun 1, 2015

To: Braintree

What's the current descriptor for Gratipay? Is this something I can view and edit in the dashboard?

From: Braintree

Your descriptor currently appears as “GRATIPAY 4129254220 PA”. Let me know if you’d like to change this. This article may be helpful in better understanding your options! These details are not available within your gateway, but if you are interested in changing them, you can reach out to support@braintreepayments at any time.

To: Braintree

Thanks, []. Could we turn on dynamic descriptors for our account, please?

@chadwhitacre

This comment has been minimized.

Show comment
Hide comment
@chadwhitacre

chadwhitacre Jun 1, 2015

Contributor
Dynamic descriptor requirements

Name

  • Comprised of a business name and product name, separated by an asterisk (*)
  • Business name must be either 3, 7, or 12 characters; product descriptor can be up to 18, 14, or 9 characters respectively (with an * in between for a total of 22 characters).
  • Can contain special characters – . + -
  • Can contain lower and upper case
  • Can contain spaces, but cannot start with a space

Phone

  • Must contain exactly 10 digits
  • Can contain up to 14 characters total, including special characters
  • Can contain special characters . ( ) -

Merchant State

  • You don’t need to provide this when using dynamic descriptors; we will pull this information for you

Some examples of valid descriptor names are:

  • cmp*super wonderful product
  • company*wonderful product
  • amazing company*product

https://articles.braintreepayments.com/wells-flat/transactions/descriptors#dynamic-descriptor-requirements

API:

https://developers.braintreepayments.com/javascript+python/reference/request/transaction/sale#descriptor

https://developers.braintreepayments.com/javascript+python/reference/request/transaction/sale#dynamic-descriptors

Contributor

chadwhitacre commented Jun 1, 2015

Dynamic descriptor requirements

Name

  • Comprised of a business name and product name, separated by an asterisk (*)
  • Business name must be either 3, 7, or 12 characters; product descriptor can be up to 18, 14, or 9 characters respectively (with an * in between for a total of 22 characters).
  • Can contain special characters – . + -
  • Can contain lower and upper case
  • Can contain spaces, but cannot start with a space

Phone

  • Must contain exactly 10 digits
  • Can contain up to 14 characters total, including special characters
  • Can contain special characters . ( ) -

Merchant State

  • You don’t need to provide this when using dynamic descriptors; we will pull this information for you

Some examples of valid descriptor names are:

  • cmp*super wonderful product
  • company*wonderful product
  • amazing company*product

https://articles.braintreepayments.com/wells-flat/transactions/descriptors#dynamic-descriptor-requirements

API:

https://developers.braintreepayments.com/javascript+python/reference/request/transaction/sale#descriptor

https://developers.braintreepayments.com/javascript+python/reference/request/transaction/sale#dynamic-descriptors

@chadwhitacre

This comment has been minimized.

Show comment
Hide comment
@chadwhitacre

chadwhitacre Jun 1, 2015

Contributor

Gratipay.com*exercism
Gratipay.com*Perl Mave
Gratipay.com*SudoMesh
Gratipay.com*catapultp
Gratipay.com*Citizens
Gratipay.com*Kivy
Gratipay.com*Pageres
Gratipay.com*SublimeLi
Gratipay.com*Mojolicio
Gratipay.com*Cyberpipe
Gratipay.com*Nuvola Pl
Gratipay.com*sudo room
Gratipay.com*Duo
Gratipay.com*introtopy
Gratipay.com*Gratipay

Contributor

chadwhitacre commented Jun 1, 2015

Gratipay.com*exercism
Gratipay.com*Perl Mave
Gratipay.com*SudoMesh
Gratipay.com*catapultp
Gratipay.com*Citizens
Gratipay.com*Kivy
Gratipay.com*Pageres
Gratipay.com*SublimeLi
Gratipay.com*Mojolicio
Gratipay.com*Cyberpipe
Gratipay.com*Nuvola Pl
Gratipay.com*sudo room
Gratipay.com*Duo
Gratipay.com*introtopy
Gratipay.com*Gratipay

@chadwhitacre

This comment has been minimized.

Show comment
Hide comment
@chadwhitacre

chadwhitacre Jun 1, 2015

Contributor

I don't like the idea of truncating Gratipay, because I want people to be able to get back to our website from their bank statement. Gratipay is longer than seven characters, so we have to use 12 if we want the whole thing on there, in which case we may as well add the .com. That leaves nine characters. I guess we use the name of the team they give the most to and leave it at that.

Brainstorm: can we flip the order? I like this a lot better, if it's possible:

exercism * Gratipay
Perl Maven * Gratipay
SudoMesh * Gratipay
catapultpg * Gratipay
Citizens C * Gratipay
Kivy * Gratipay
Pageres * Gratipay
SublimeLin * Gratipay
Mojoliciou * Gratipay
Cyberpipe * Gratipay
Nuvola Pla * Gratipay
sudo room * Gratipay
Duo * Gratipay
introtopyt * Gratipay
Gratipay * Gratipay

Contributor

chadwhitacre commented Jun 1, 2015

I don't like the idea of truncating Gratipay, because I want people to be able to get back to our website from their bank statement. Gratipay is longer than seven characters, so we have to use 12 if we want the whole thing on there, in which case we may as well add the .com. That leaves nine characters. I guess we use the name of the team they give the most to and leave it at that.

Brainstorm: can we flip the order? I like this a lot better, if it's possible:

exercism * Gratipay
Perl Maven * Gratipay
SudoMesh * Gratipay
catapultpg * Gratipay
Citizens C * Gratipay
Kivy * Gratipay
Pageres * Gratipay
SublimeLin * Gratipay
Mojoliciou * Gratipay
Cyberpipe * Gratipay
Nuvola Pla * Gratipay
sudo room * Gratipay
Duo * Gratipay
introtopyt * Gratipay
Gratipay * Gratipay

@chadwhitacre

This comment has been minimized.

Show comment
Hide comment
@chadwhitacre

chadwhitacre Jun 1, 2015

Contributor

From: Braintree

Dynamic Descriptors are enabled for your Gratipay account. For more information on how to your developers can utilize this tool, please see this article.

To: Braintree

Awesome, thanks []! :-)

Question: Can I flip the company and product name? What if I want to do this: product * company? What happens if I don't use a *? How is that field validated? I guess I should just try it and see. :P

Contributor

chadwhitacre commented Jun 1, 2015

From: Braintree

Dynamic Descriptors are enabled for your Gratipay account. For more information on how to your developers can utilize this tool, please see this article.

To: Braintree

Awesome, thanks []! :-)

Question: Can I flip the company and product name? What if I want to do this: product * company? What happens if I don't use a *? How is that field validated? I guess I should just try it and see. :P

@chadwhitacre

This comment has been minimized.

Show comment
Hide comment
@chadwhitacre

chadwhitacre Jun 1, 2015

Contributor

To: Braintree

Also, could you please change our phone number to have dashes in it?

412-925-4220

Adding dashes doesn't affect the number of characters available for the dynamic descriptor, does it?

Thanks! :)

Contributor

chadwhitacre commented Jun 1, 2015

To: Braintree

Also, could you please change our phone number to have dashes in it?

412-925-4220

Adding dashes doesn't affect the number of characters available for the dynamic descriptor, does it?

Thanks! :)

chadwhitacre added a commit to gratipay/inside.gratipay.com that referenced this issue Jun 1, 2015

Fix the descriptor
Braintree support reports that this is it right now. See
gratipay/gratipay.com#3507.
@chadwhitacre

This comment has been minimized.

Show comment
Hide comment
@chadwhitacre

chadwhitacre Jun 2, 2015

Contributor

From: Braintree

Thanks for reaching out and great question. Your account can pass dynamic descriptors. Here are the parameters for passing them via the API:
Dynamic Descriptors (name and phone number) are supported.
Company name/DBA section must be either 3, 7 or 12 characters and the product descriptor can be up to 18, 14, or 9 characters respectively (with an * in between for a total descriptor name of 22 characters)
No special characters in the Company name/DBA
Phone can only contain numbers, dashes and periods and must be less than or equal to 13 characters
Dynamic descriptors are enabled by default in the gateway, so no updates to the merchant account are needed
I’ve also updated your request to remove the dashes from your customer service number on your current descriptors. Hope this helps. Please reach out if you need any further assistance.

To: Braintree

Thanks, []. I did read the docs about dynamic descriptors. I guess I will play around with it and see what works and what doesn't. :-)

Re: dashes ... I was hoping to add them to the phone number, like so: 412-925-4220. Can we make that happen?

Contributor

chadwhitacre commented Jun 2, 2015

From: Braintree

Thanks for reaching out and great question. Your account can pass dynamic descriptors. Here are the parameters for passing them via the API:
Dynamic Descriptors (name and phone number) are supported.
Company name/DBA section must be either 3, 7 or 12 characters and the product descriptor can be up to 18, 14, or 9 characters respectively (with an * in between for a total descriptor name of 22 characters)
No special characters in the Company name/DBA
Phone can only contain numbers, dashes and periods and must be less than or equal to 13 characters
Dynamic descriptors are enabled by default in the gateway, so no updates to the merchant account are needed
I’ve also updated your request to remove the dashes from your customer service number on your current descriptors. Hope this helps. Please reach out if you need any further assistance.

To: Braintree

Thanks, []. I did read the docs about dynamic descriptors. I guess I will play around with it and see what works and what doesn't. :-)

Re: dashes ... I was hoping to add them to the phone number, like so: 412-925-4220. Can we make that happen?

@chadwhitacre

This comment has been minimized.

Show comment
Hide comment
@chadwhitacre

chadwhitacre Jun 2, 2015

Contributor

From: Braintree

No problem, I’ll them back right now!
Sorry for the confusion on my end.

To: Braintree

Thanks, []! :)

Contributor

chadwhitacre commented Jun 2, 2015

From: Braintree

No problem, I’ll them back right now!
Sorry for the confusion on my end.

To: Braintree

Thanks, []! :)

chadwhitacre added a commit to gratipay/inside.gratipay.com that referenced this issue Jun 14, 2015

Fix the descriptor
Braintree support reports that this is it right now. See
gratipay/gratipay.com#3507.

@chadwhitacre chadwhitacre removed the ★★☆ label Mar 4, 2016

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.