Yoursafe

Agents

Implement Mass Payments

Raw skill file

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 for the file workflow and the CSV templates
  2. Mass Payments API for straight-through submission
  3. 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.
  • 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.