Skip to main content

Stripe

Stripe

Stripe is a global payments platform. When connected to Altruon as a payment gateway, Stripe processes card payments while your billing platform stays the source of truth for subscriptions and invoices.

This connection is separate from Stripe Billing. Use this page when Stripe should charge the card. Use Stripe Billing when Stripe should own the subscription and the invoice.


Supported Payment Methods​

  • Card Payments
    • Credit cards
    • Debit cards
note

Stripe is currently enabled for card payments only in Altruon.


Requirements​

To connect your Stripe account to Altruon, you need one credential:

  • Secret Key

The key must start with sk_ or rk_.

  • A secret key looks like sk_test_... in a sandbox and sk_live_... in live mode.
  • A restricted key looks like rk_test_... or rk_live_.... It must be allowed to read and write Customers, PaymentIntents, SetupIntents, and Refunds. Altruon checks the key by listing one PaymentIntent.

Dashboard URLs​

In the Stripe Dashboard, open Developers > API keys and copy the Secret key.

Use a test key with the sandbox Dashboard, and a live key with the live Dashboard. The webhook you create in the next section has to be in the same mode as the key.

caution

A secret key is shown in full only when it is created. Copy it before you leave the page.


Step 1: Connect Stripe to Altruon​

  1. Log in to your Altruon account.
  2. Navigate to Settings > Payment Gateways.
  3. Click + Add Integration and select Stripe.
  4. Enter your Secret Key.
  5. Click Add Integration.

If the connection is successful, the Stripe integration is marked as Active in Altruon.


Step 2: Configure the webhook in Stripe​

Altruon needs a webhook from Stripe so card payments, saved cards, and refunds stay in sync. This is not the Stripe Billing webhook. Billing events and payment events go to different Altruon endpoints.

  1. In Altruon, go to Settings > Payment Gateways.

  2. Click View Integration on Stripe.

  3. Copy the Webhook endpoint URL.

    The URL Altruon generates looks like this:

    • Sandbox: https://{domain}.webhook.sandbox.altruon.io/webhooks/gateways/stripe/{connectionId}
    • Production: https://{domain}.webhook.altruon.io/webhooks/gateways/stripe/{connectionId}

    Paste the URL from Altruon. Do not build it yourself.

  4. Log in to the Stripe Dashboard in the same mode as the secret key.

  5. Go to Developers > Webhooks.

  6. Click + Add destination.

  7. Under Events from, choose Your account.

  8. Select these events:

    Payments

    • payment_intent.succeeded
    • payment_intent.payment_failed
    • payment_intent.canceled
    • payment_intent.processing
    • payment_intent.requires_action

    Setup (saving a card, including a trial or an added payment method)

    • setup_intent.succeeded
    • setup_intent.setup_failed
    • setup_intent.canceled
    • setup_intent.requires_action

    Refunds

    • refund.created
    • refund.updated
    • refund.failed
    • charge.refund.updated

    Disputes

    • charge.dispute.created
    • charge.dispute.updated
    • charge.dispute.closed
    • charge.dispute.funds_withdrawn
    • charge.dispute.funds_reinstated
  9. Click Continue.

  10. Set the Destination type to Webhook endpoint and click Continue.

  11. Paste the Altruon webhook URL into Endpoint URL.

  12. Name the destination Altruon payments.

  13. Click Create destination.

caution

Do not add these payment events to the Stripe Billing destination, and do not point this destination at the billing webhook URL. invoice.* and customer.subscription.* belong on Stripe Billing. The events above belong on this gateway endpoint.


🎉 Congratulations​

Your Stripe gateway is now connected to Altruon. You can process card payments through your Altruon checkout flow.