Skip to content

Latest commit

 

History

History
56 lines (39 loc) · 3.11 KB

README.md

File metadata and controls

56 lines (39 loc) · 3.11 KB

Stripe API

Compatible with Stripe API version 2022-11-15

Configuration

File: src/.env (you can copy-paste content of src/.env.example)

  • APP_DEBUG - Debug mode (true or false)
  • STRIPE_SECRET_KEY - Stripe secret key (should start with sk_live_) ; see API keys

If you want to use Stripe Connect, you should also set these variables:

  • STRIPE_SECRET_KEY - Stripe secret key for the "parent" account (should start with sk_live_) ; see API keys
  • STRIPE_CONNECTED_ACCOUNT - Stripe account ID of the "child" account (should start with acct_) ; see settings
  • FEE_PERCENTAGE - Fee percentage (e.g. 0.10 for 10%)

Usage

Create checkout session

Documentation: https://stripe.com/docs/api/checkout/sessions/create

Subscription mode

POST /checkout/session/subscription
Parameter Required Description
successUrl required The URL to which Stripe should send customers when payment or setup is complete.
cancelUrl required The URL the customer will be directed to if they decide to cancel payment and return to your website.
plan required Plan ID for this item.
locale (optional) The IETF language tag of the locale Checkout is displayed in.

Note
If you're upgrading from version 1.x, you must use subscription instead of plan in the request URL.

Payment mode

POST /checkout/session/payment
Parameter Required Description
successUrl required The URL to which Stripe should send customers when payment or setup is complete.
cancelUrl required The URL the customer will be directed to if they decide to cancel payment and return to your website.
amount required The amount to be collected per unit of the line item.
currency required Three-letter ISO currency code, in lowercase.
message (optional) The description for the line item, to be displayed on the Checkout page.
locale (optional) The IETF language tag of the locale Checkout is displayed in.

Note
If you're upgrading from version 1.x, you must use payment instead of donation in the request URL.