---
title: "Creates a hosted checkout session for the authenticated customer to add the given amount to
 their prepaid balance."
method: POST
path: "/payment/topup"
tags: ["Payment"]
---

# Creates a hosted checkout session for the authenticated customer to add the given amount to
 their prepaid balance.

`POST /payment/topup`

Rejected for non-prepaid customers and for amounts below the configured minimum. On
 successful payment a voucher for the amount is minted, which raises the customer's balance.

## Request body

- CreateTopUpEndpointInput
  - `amount` number, double, required — The amount in dollars to add to the prepaid balance.

## Response `200`

OK

- CreateTopUpEndpointOutput
  - `url` string, required — The hosted Stripe checkout url to redirect the customer to.

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

---

[API](https://skmtc.net/rapidata/apis/rapidata-api.md) · [All operations](https://skmtc.net/rapidata/apis/rapidata-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rapidata/rapidata-api/revisions/e42ec51c7b88/schema)