StripeDocsPatch

HomePage | RecentChanges | Preferences

Stripe Docs Patch

https://stripe.com/docs/api/php#create_subscription says application_fee_percent is 'A positive decimal (with at most two decimal places) between 1 and 100...' but https://stripe.com/docs/connect/collecting-fees#subscriptions still says ‘an _integer_ between 1 and 100’.

https://stripe.com/docs/api/ruby#errors and scroll down... the "Handling Errors" section needs an anchor

https://stripe.com/docs/api/ruby#update_card says "When you update a card, Stripe will automatically validate the card." however there is no mention of what happens if the card doesn't validate. It just says "Returns the card object." How do you know whether it validated?

https://support.stripe.com/questions/what-if-i-decide-to-leave-stripe-can-i-export-card-data needs to mention the exports on the dashboard or link to https://support.stripe.com/questions/what-kind-of-reporting-is-available

https://stripe.com/docs/api/curl#metadata should talk about how to clear the metadata (send an empty string? or an empty array?)

https://support.stripe.com/questions/how-can-i-change-the-billing-cycle-of-a-subscription needs to be updated for the new StripeBillingCycleAnchor when that launches.

https://stripe.com/docs/tutorials/sending-transfers says 2 days but the api docs say 7

https://stripe.com/docs/api/curl#create_customer
... delete the default customer CARD if one exists....
also, what does it mean to validate the card? (authorize a small amount, apparently.)

https://stripe.com/docs/api/ruby#list_invoiceitems shows "count: 3" in the sample output, but that does not appear with the code provided "Stripe::InvoiceItem?.all". You have to do this to get it: Stripe::InvoiceItem?.all( {customer: $cust.id, include: ["total_count"] } )

TO DO

https://stripe.com/docs/api/curl#update_recipient does not mention accepting a token for the bank account when updating a recipient. seems like it should... need to test.

https://support.stripe.com/questions/what-if-i-decide-to-leave-stripe-can-i-export-card-data what about if I've only done one-off charges and didn't save customers/cards to my account?

The Dashboard needs to say that receipts are never sent in test mode.

Explain the difference between cvc_invalid and cvc_incorrect on https://stripe.com/docs/api/ruby#errors

Apparently you can release an authorization by refunding the charge when charge.capture=false. The docs should say that... API and https://support.stripe.com/questions/does-stripe-support-authorize-and-capture

The docs on testing and upgrading to a new version of the API need work.
There is no discussion of using setApiVersion?, it only appears in the sample code
And there is no description of what will actually happen when you press the upgrade button (just a scary warning)

What does 'paid' mean on a charge?

The 'PCI and our approach' link in
https://support.stripe.com/questions/why-is-stripe-better-than-the-other-options-im-considering
goes to
https://stripe.com/us/help/faq#pci-compliance
which redirects to
https://support.stripe.com/topics/getting-started
which is not relevant.

https://stripe.com/docs/connect/oauth
should say more about how long you can use the stripe_user_id, stripe_publishable_key, refresh_token and access_token
Or, if these are standard OAuth concepts, link to somewhere explaining that.

Should IP addresses be documented other than on the stripe-api-announce list?
https://groups.google.com/a/lists.stripe.com/forum/#!searchin/api-discuss/ip$20address

https://stripe.com/docs/connect/shared-customers
Needs to show how to set up a subscription for a shared customer

Also: minor UI bugs in the Dashboard

If you edit a test web hook url, the mode actually displays 'Live'
(though it is properly greyed out and you cannot change it, that's the wrong value.)

Why is it 'CVV' when adding a card through the Dashboard, and CVC in the Checkout overlay?

https://dashboard.stripe.com/account/recurring has "Retry 1 days after the previous attempt" in the drop downs. Should be ' 1day'.


https://stripe.com/docs/checkout/guides/php
Needs to not suggest putting config.php in the public web directory (or at least have a disclaimer that it needs to be moved as soon as possible.)
Remove the "couldn't be simpler!" bit -- not everyone has the assumed knowledge, and it makes them feel bad if they couldn't get it working.

Fixed

Submitted (via Twitter) 20140818, fixed by @kyle_conroy


The ‘refunding a charge’ link at the bottom of
https://stripe.com/docs/connect/collecting-fees
goes to
https://stripe.com/docs/api#refund_charge
which (the anchor) does not exist.
It should probably be
https://stripe.com/docs/api#refunds


https://stripe.com/docs/api#create_refund
refund_application_fee does not have a default listed (should be false)


https://stripe.com/docs/api#update_card
should mention
“When you update a customer's default credit card, we automatically retry the latest unpaid, unclosed invoice for each subscription. If the payment succeeds, the subscription transitions back to active.” - Jim Danz on Stripe API Discussion 20140620
Except that "Note that when a subscription has a status of unpaid, [...] updating customer card details will not lead to Stripe retrying the latest invoice.)"
(And, does anything else happen?)


https://stripe.com/docs/api/python#charge_object
balance_transaction: string
should say that this is the ID of the balance_transaction (like customer does, below it)


Contact me at wsmoak -at- gmail.com


HomePage | RecentChanges | Preferences
This page is read-only | View other revisions
Last edited November 29, 2014 2:56 am by WendySmoak (diff)
Search: