---
title: "Top up account balance"
method: POST
path: "/payout/account/topup"
tags: ["Account"]
---

# Top up account balance

`POST /payout/account/topup`

This **POST** endpoint is used to initiate a topup from the funding instrument to your MassPay account balance. <br> You can use this endpoint to start the topup process. <br> The body of the request requires the token of the funding instrument, the type of rail you would like to use, the amount to topup and the currency. <br> The response will include a JSON objects containing a success boolean.

## Request body

- object
  - `funding_instrument_token` string, required — Token of funding instrument
  - `type` 'ACH' | 'AFT', required — Type of transaction
  - `currency_code` string, required — 3 letter currency code to top up
  - `amount` number, required — Amount to top up

## Response `200`

successful operation

- object
  - `topup_token` string, uuid, required — Topup token representing the topup transaction

## Other responses

- `400` — Bad request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Not found.
- `405` — Method Not Allowed.
- `500` — Internal server error.
- `504` — Gateway Time-out.

---

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