Create Agent Top-Up Checkout Session | Caesar

Create a Stripe Checkout session URL for a one-time credit top-up. Redirects are managed by the API and always return to the environment-specific /payment/success page.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

amount_centsintegerRequired>=1000

Top-up amount in USD cents. Minimum is 1000 ($10).

Response

Stripe Checkout session URL for completing the top-up.

checkout_urlstring

Stripe-hosted checkout URL for completing the top-up.

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

Bearer authentication of the form Bearer <token>, where token is your auth token.

This endpoint expects an object.

Top-up amount in USD cents. Minimum is 1000 ($10).

Stripe Checkout session URL for completing the top-up.

Stripe-hosted checkout URL for completing the top-up.

$	curl -X POST https://api.caesar.xyz/agents/topup \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"amount_cents": 1500
>	}'

$	curl -X POST https://api.caesar.xyz/agents/topup \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"amount_cents": 1500
>	}'

1	{
2	"checkout_url": "https://checkout.stripe.com/pay/cs_test_a1b2c3d4e5f6g7h8i9j0klmnopqrstuv"
3	}