CorefinityCorefinityDocs
Open the Control PanelControl Panel
Billing · 12 of 16

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.

GET/api/corestack/billing/payment-methods

Query parameters

accountinteger

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.

account_idinteger

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
cardsobjectRequired
Fields
can_addbooleanRequired
maxintegerRequired

The most cards an account can hold.

defaultstring or nullRequired

What is charged first.

cardmandatenull
mandateobject or any or nullRequired
methodsarray of objectsRequired
Fields of each item
added_atstring or nullRequired

Format: date-time.

brandstringRequired
exp_monthinteger or nullRequired
exp_yearinteger or nullRequired
idintegerRequired

At least 1.

kindstringRequired
cardwalletlink
labelstring or nullRequired
last4stringRequired

The last four digits. Empty when there are none.

providerstringRequired

The payment provider that holds the card.

rolestring or nullRequired

primary is charged first, backup when the primary fails.

primarybackupnull
statestringRequired
activeexpiringexpireddetached
walletstring or nullRequired
apple_paygoogle_paynull
blockedobjectRequired

Why 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
backupstring or nullRequired
primarystring or nullRequired
removestring or nullRequired
rightsobjectRequired

What you may do with the account.

Fields
can_editbooleanRequired
can_paybooleanRequired

Whether you may pay an invoice. Paying is done in the Control Panel.

can_viewbooleanRequired
reasonstring or nullRequired

billing_forbidden when you may not read the account, else null.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403billing_forbiddenBilling is for the organisation's owner and billing contacts. Ask one of them to do this.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
422invalidFix the field named in field; errors says why.
429rate_limitedWait 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"
{
  "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
  }
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT