Payment Kit

The decentralized Stripe for the Blocklet platform.

Contribution

$3

1. Clone the repository
2. Run make build
3. Run cd blocklets/core && blocklet dev

#### Troubleshooting

Error: "pre-start error component xxx is not running or unreachable"

- Create a .env.local file in the project root
- Add BLOCKLET_DEV_APP_DID="did:abt:your payment kit server did"
- Add BLOCKLET_DEV_MOUNT_POINT="/example"
- Copy .env.local to the /core directory
- Edit BLOCKLET_DEV_MOUNT_POINT="/"

Error: "Insufficient funds to pay for transaction cost from xxx, expected 1.0020909, got 0"

- Copy the BLOCKLET_DEV_APP_DID
- Transfer 2 TBA from your DID Wallet to the copied address

$3

Before using Stripe as a payment method, you need to configure the webhook secret:

1. Set the STRIPE_WEBHOOK_SECRET environment variable in your Blocklet settings
- Add the environment variable STRIPE_WEBHOOK_SECRET with your Stripe webhook signing secret
- You can find this in your Stripe Dashboard > Developers > Webhooks > Signing Secret

$3

1. Install and log in following the instructions at: https://stripe.com/docs/stripe-cli
2. Start your local Payment Kit server and note its port
3. Run stripe listen --forward-to http://127.0.0.1:8188/api/integrations/stripe/webhook --log-level=debug --latest
4. Copy the webhook signing secret from the CLI output and set it as STRIPE_WEBHOOK_SECRET environment variable

$3

Invoices for subscriptions are not finalized automatically. You can use the Stripe Postman collection to finalize them and then confirm the payment.

$3

Non-public environment variables used in the code that can change the behavior of Payment Kit:

- PAYMENT_CHANGE_LOCKED_PRICE: Allows changing locked price (must be set to "1" to enable)
- PAYMENT_RELOAD_SUBSCRIPTION_JOBS: Reloads subscription jobs on start (must be set to "1" to enable)
- PAYMENT_BILLING_THRESHOLD: Global default billing threshold (must be a number)
- PAYMENT_MIN_STAKE_AMOUNT: Global minimum stake amount limit (must be a number)
- PAYMENT_DAYS_UNTIL_DUE: Global default days until due (must be a number)
- PAYMENT_DAYS_UNTIL_CANCEL: Global default days until cancellation (must be a number)