---
name: implement-mass-payments
description: Implements Yoursafe Mass Payments from a business account. Use when uploading a payout CSV, calling the Mass Payments API, or releasing a batch in the Yoursafe App.
title: Mass Payments
summary: Payouts from a business account. Use the official CSV layout or the API, then release the batch in the Yoursafe App.
slug: mass-payments
order: 5
---

# Implement Mass Payments

Mass Payments sends many payouts from a Yoursafe business account. Use a file upload when a person can approve the batch. Use the API when your system submits the file itself. If this skill and a product page disagree, follow the product page.

## Read first

1. [Mass Payments Upload](/en/uploading-csv-files) for the file workflow and the CSV templates
2. [Mass Payments API](/en/mass-payments-api) for straight-through submission
3. [YOU Account Linking](/en/agents/you-account-linking) when the beneficiary is a linked creator

## Implement in this order

1. Choose one path. Portal upload and the API are separate ways to submit the same kind of batch.
2. Download the official CSV templates and match column names, delimiters, and required fields.
3. Check amounts, currency, and references before submit.
4. Submit in the Business portal or through the API.
5. Approve the batch in the Yoursafe App when the app asks. Submitting the file is not the release.

## Credentials

- A Yoursafe Business user who can open Mass Payments at [business.yoursafe.com](https://business.yoursafe.com).
- API credentials from the Mass Payments API reference, kept on the server. Take the authentication scheme from that reference.

## Traps

- Build the file from the downloaded template. The portal expects those column names and delimiters.
- The batch stays unreleased until someone confirms it in the Yoursafe App.
- A linked creator is paid with the `publicToken` from YOU Account Linking. That token is the beneficiary reference for the payout.
- Request fields for the API live in the Mass Payments API reference. Read them there before writing the client.

## Done when

A batch built from the official template is accepted, then released after the Yoursafe App confirmation, and the payments match the rows you submitted.