CODEWITHSUNDEEP
phpstripe-paymentspayment-gateway
Jason Bale
Jason Bale

Reputation: 363

When is a payment successful in Stripe?

I am creating a web app:

I need to update the database when payment is successful and the card is charged (not decline).

my code is here: I first create the customer. (btw, the variables are declared, everything is working)

$customer = \Stripe\Customer::create(array(
      'email' => $_POST['stripeEmail'],
      'source'  => $_POST['stripeToken'],
      'description' => $stripeEmail
      ));

then I create the subscription for the customer:

$subscription = \Stripe\Subscription::create(array(
      "customer" => $customer->id,
      "plan" => $planName
      ));

My question: do I need to create a webhook to detect if payment is successful? or is it successful upon form submitting successfully?

Upvotes: 2

Views: 3040

Answers (1)

Ywain
Ywain

Reputation: 17533

In normal circumstances, when you create a subscription, Stripe will immediately attempt to charge the customer (subscriptions with Stripe are paid upfront). If the payment attempt fails, the API will immediately return an error and no subscription will be created.

In this case, you don't need to use webhooks. Just use normal error handling and check if a \Stripe\Error\Card exception is raised when you call \Stripe\Subscription::create(...).

Note that if there is nothing to bill immediately, the subscription creation will always succeed. This can happen in various circumstances:

  • if you provide a trial_end parameter when creating the subscription

  • if the plan has a default trial period

  • if you use a coupon or a negative invoice item that reduces the first invoice's total to $0

  • if the customer's account_balance can cover the cost of the first invoice

Upvotes: 5

Related Questions