Add credits (payment link)
Returns a Stripe Checkout link for a person to pay (VAT added at checkout, one invoice per top-up); the API never charges a card. Checkout opens in the key creator’s language (else the owner’s, else Italian for an Italian company) and offers only the current default card. Live keys, billing:write, created by someone who can manage billing; not for a client company.
Returns a Stripe Checkout link for a person to pay (VAT added at checkout, one invoice per top-up); the API never charges a card. Checkout opens in the key creator’s language (else the owner’s, else Italian for an Italian company) and offers only the current default card. Live keys, billing:write, created by someone who can manage billing; not for a client company.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
Idempotency-Key?stringRecommended. Retrying with the same key and body within 24 hours replays the first response (header Idempotent-Replayed: true) instead of acting twice. The same key with a different body returns 422 idempotency_key_reused.
length <= 255Getbeel-Company?stringAct on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.
uuidapplication/json- body
amount_cents*integerCredit to add, net of VAT (from 1000 to 1000000)
1000 <= value <= 1000000OK
application/json- response
object*stringcurrency*stringamount_cents*integerEUR cents, net of VAT
-9007199254740991 <= value <= 9007199254740991checkout_url*stringurinote*stringcurl -X POST 'https://www.getbeel.com/api/v1/billing/topups' \ -H 'Content-Type: application/json' \ -d '{ "amount_cents": 2500}'{ "object": "topup_checkout", "currency": "EUR", "amount_cents": -9007199254740991, "checkout_url": "http://example.com", "note": "string"}The price list GET
Every billable item with its unit and tiers (per billing account per calendar month). The same list as the pricing page.
Change the card (setup link) POST
Returns a Stripe Checkout link (setup mode, nothing is charged) for a person to enter a new card; it becomes the default card and the one auto top-ups charge. The same card saved twice is kept once. Live keys, billing:write, created by someone who can manage billing; not for a client company; 409 no_card (application/problem+json, the same shape as the 402) when no card is saved yet. The Checkout opens in the key creator’s language (else the owner’s, else Italian for an Italian company).