---
title: "Add payment method"
method: POST
path: "/subscriptions/{subscriptionId}/paymentmethods"
tags: ["Subscription Payments"]
---

# Add payment method

`POST /subscriptions/{subscriptionId}/paymentmethods`

Adds a new payment method to the account and sets it for the specified subscription 

Important notes:
* Can optionally set as default payment method for the entire account, or the specified subscription
* Can force immediate charge for overdue invoices for the specified subscription
* Payment information format depends on payment system

## Path parameters

- `subscriptionId` string, required

## Request body

- AddPaymentMethodRequest
  - `paymentSystemId` string, nullable — Payment system to use.
  - `paymentInformation` PaymentInformation — Base class for payment information.
  - `isDefault` boolean, nullable — Whether to set this as the default payment method for the entire account This does not set the default payment method for the subscription.
  - `chargeImmediately` boolean, nullable — Whether to charge immediately if subscription(s) are overdue. If true, the payment system will attempt to charge the customer immediately if there are any overdue subscriptions. If a subscription id is passed as a parameter to the request, only that subscription will be charged immediately if overdue.

## Response `202`

When request is accepted. Returns a 'Link' object.

- Link
  - `id` string, nullable
  - `href` string, nullable
  - `relation` string, nullable
  - `method` string, nullable

## Other responses

- `400` — When an unsupported request is made.
- `404` — When subscription with specified id does not exist.
- `500` — When an error occurs while adding payment method.

---

[API](https://skmtc.net/smokeball/apis/api.md) · [All operations](https://skmtc.net/smokeball/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smokeball/api/revisions/197984da9b42/schema)