Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
PricingDashboard
GuidesAPI ReferenceCLI
API ReferenceBilling and usageBilling

Remove a saved card

Detaches a saved card from the org. Removing the default card clears the default, so no charge goes to it. A card that is not the org's returns 404.

Required permission

Requires the billing.manage permission. See Permissions for the roles and API key permissions that include it.

Command line

The orl CLI wraps this endpoint:

orl billing payment-method delete <payment-method-id>
DELETE
/v1/orgs/{orgId}/billing/payment-methods/{paymentMethodId}

Authorization

apiKey
headerAuthorizationBearer <token>

OpenRelay API key. Send it as Authorization: Bearer or_… (legacy vl_… keys still work).

Path Parameters

orgId*string
paymentMethodId*string

Response Body

Removed

Example Request
curl -X DELETE 'https://api.openrelay.inc/v1/orgs/string/billing/payment-methods/string'
Example Response
Empty

List saved cards (brand/last4/exp only) GET

Returns the org's saved cards (id, brand, last four digits, and expiry month and year) and the id of the default card. Empty when no card is saved.

Set a saved card as the default for charges POST

Makes a saved card the org's default for off-session charges (deposits and auto-recharge). Another org's card, or one not yet settled as saved, returns 404.