List the payment methods
Answers the cards on the account, its Direct Debit mandate when it has one, which of them is charged first and what you may do; a card is its brand, its last four digits and its expiry, never its number. Adding, removing and reordering cards, and setting up Direct Debit, are done in the Control Panel.
Query parameters
The billing account to read, by its id (see GET /corestack/billing/account). Left out, the request acts on your company's default billing account. An account that does not exist and one that is not your company's answer the same 404. At least 1.
The same as account, under the name the MCP tools use. Send one of the two: when they name different accounts the request is refused 422 invalid on account_id. At least 1.
Returns
200 The payment methods.
Fields of the 200 answer
Fields
The most cards an account can hold.
What is charged first.
cardmandatenullFields of each item
Format: date-time.
At least 1.
cardwalletlinkThe last four digits. Empty when there are none.
The payment provider that holds the card.
primary is charged first, backup when the primary fails.
primarybackupnullactiveexpiringexpireddetachedapple_paygoogle_paynullWhy each change to the card would be refused in the Control Panel now, or null when it would be taken: making it the primary card, making it the backup, and removing it.
Fields
What you may do with the account.
Fields
Whether you may pay an invoice. Paying is done in the Control Panel.
billing_forbidden when you may not read the account, else null.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | billing_forbidden | Billing is for the organisation's owner and billing contacts. Ask one of them to do this. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/corestack/billing/payment-methods \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/corestack/billing/payment-methods');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/billing/payment-methods', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.get(
"https://manage.corefinity.com/api/corestack/billing/payment-methods",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"cards": {
"can_add": true,
"max": 2
},
"default": "card",
"mandate": null,
"methods": [
{
"added_at": "2026-11-01T09:05:00Z",
"blocked": {
"backup": "primary_required",
"primary": null,
"remove": "last_method"
},
"brand": "visa",
"exp_month": 12,
"exp_year": 2030,
"id": 4410,
"kind": "card",
"label": null,
"last4": "4242",
"provider": "stripe",
"role": "primary",
"state": "active",
"wallet": null
}
],
"rights": {
"can_edit": true,
"can_pay": false,
"can_view": true,
"reason": null
}
}{
"message": "Unauthenticated."
}{
"code": "billing_forbidden",
"message": "Billing is available to your company's owner and billing contacts.",
"reason": "billing_forbidden"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "invalid",
"errors": {
"account_id": [
"Send account or account_id, not both: they name different billing accounts."
]
},
"field": "account_id",
"message": "Send account or account_id, not both: they name different billing accounts.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}