Why would a Charge have a 'pending' status?

2,785 views
Skip to first unread message

Garrett Davis

unread,
Nov 22, 2016, 1:09:25 PM11/22/16
to Stripe API Discussion
I'm implementing Stripe API into a Rails app. We are doing straight capture, no pre-auth or subscriptions.
I see the Charge object can have 3 statuses. I'm curious as to how I could wind up with a 'pending' status so I
can handle the situation properly. I assume it's for auth/capture flows or pending subscription charges, which
we don't use, but that's just a guess.

Thanks in advance.

Remi J.

unread,
Nov 22, 2016, 1:23:06 PM11/22/16
to api-d...@lists.stripe.com
Hey Garrett,

When you charge a customer's bank account via ACH, we don't know immediately if the charge succeeded. We attempt to debit the bank account and it might take up to 5 business days to receive acknowledgment of success or failure! During that time, the charge is considered as "pending" until it either succeeds or fails. This is documented here: https://stripe.com/docs/ach#ach-payments-workflow

When you charge a credit or debit card though we always know instantly if the charge succeeded or not. If you only charge cards you don't have to care about `status: "pending"` in your code.

Hope this helps!
Remi

--
You received this message because you are subscribed to the Google Groups "Stripe API Discussion" group.
To unsubscribe from this group and stop receiving emails from it, send an email to api-discuss+unsubscribe@lists.stripe.com.
To post to this group, send email to api-d...@lists.stripe.com.
Visit this group at https://groups.google.com/a/lists.stripe.com/group/api-discuss/.

Garrett Davis

unread,
Nov 22, 2016, 1:49:26 PM11/22/16
to Stripe API Discussion
Awesome! Thank you for the clarification.
Reply all
Reply to author
Forward
0 new messages