Payment Methods

Activate a payment method

curl -X POST https://api.subscriby.net/v1/projects/$PROJECT_ID/payment-methods/$METHOD_ID/activate \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

Offers the method at checkout again and re-queues the plan sync for that gateway. Answers 200 with the method. Idempotent: switching a method to the state it is already in writes nothing and emits nothing; when the switch flips, project.payment_method.updated fires once with changes.active.

Stripe needs its Connect handshake first. A Stripe method whose Connect onboarding never finished is refused: the row exists only so the creator can resume onboarding, and switching it on would offer buyers a gateway that fails at checkout. Finish onboarding from the dashboard, the only place the Connect handshake can complete.

post/v1/projects/{project}/payment-methods/{method}/activate

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/projects/{project}/payment-methods/{method}/activate
  • Auth: HTTP bearer

Path parameters

projectstring uuid required

The project, resolved by the route binder.

methodstring uuid required

The method, resolved within the project by the route binder.

Headers

Idempotency-Keystring uuid required

A key unique to this operation, such as a fresh UUID. The same key replays the original 2xx response for 24 hours (with Idempotent-Replay: true), so a retry after a timeout never repeats the write; the same key with a different body is refused with 409.

Response

The method, switched on.

Example response

{
  "data": {
    "id": "a15d70c8-3e46-4b92-b70f-58c9d2140e63",
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
    "provider": "stripe",
    "mode": "live",
    "linked": true,
    "active": true,
    "created_at": "2026-05-18T10:05:00Z",
    "updated_at": "2026-05-18T10:05:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.