GetbeelDocs

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.

POST
/billing/topups

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.

Autorizzazione

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Idempotency-Key?string

Recommended. 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.

Lengthlength <= 255
Getbeel-Company?string

Act 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.

Formatuuid
application/json
  1. body
amount_cents*integer

Credit to add, net of VAT (from 1000 to 1000000)

Range1000 <= value <= 1000000

Corpo della risposta

OK

application/json
  1. response
object*string
currency*string
amount_cents*integer

EUR cents, net of VAT

Range-9007199254740991 <= value <= 9007199254740991
checkout_url*string
Formaturi
note*string
Esempio di richiesta
curl -X POST 'https://www.getbeel.com/api/v1/billing/topups' \  -H 'Content-Type: application/json' \  -d '{  "amount_cents": 2500}'
Esempio di risposta
{  "object": "topup_checkout",  "currency": "EUR",  "amount_cents": -9007199254740991,  "checkout_url": "http://example.com",  "note": "string"}