---
agentTools:
  projectIndex: https://developers.masspay.io/llms.txt
---

# May 13th 2026

# Added

\[Payin Catalog]

Introduced dedicated pay-in catalog endpoints and separated payout/pay-in catalog groupings.

* Added `Payin Catalog` tag group
* Added `GET /payin/country/list`
* Added `GET /payin/country/{country_code}/best`

These endpoints provide supported pay-in countries and available pay-in service offerings.

# Improved

\[Catalog organization]

Renamed existing `Catalog` tag to `Payout Catalog` for clearer separation between payout and pay-in services.

Updated all payout catalog endpoints to use the new tag grouping.

# Improved

\[Initiate pay-in response model]

Expanded `POST /payin/{user_token}` response documentation to support asynchronous and multi-step pay-in flows.

Added:

* New `InitiatePayinResp` schema
* `required_action` support
* `instructions`
* `requires_commit`
* `network_response`
* `error` and `error_type`
* `funding_code`
* `payment_reference`

Added comprehensive examples for:

* Approved card AFT
* Instant completed pay-ins
* Cash deposit flows
* Partner declines
* Validation failures

Clarified that HTTP `201` only indicates request acceptance and that integrators must inspect the response `status` and `error` fields.

# Improved

\[Tax forms]

Added optional `address` support to:

* `Form1099NECRequest`
* `Form1099MISCRequest`
* `Form1099KRequest`

When provided, the supplied address is used to update the user profile before generating the tax form.

# Improved

\[File upload requests]

Added `file_upload_link` field to file upload request responses.

If the upload has not yet been completed, this field contains a URL where the user can upload the requested files.

# Improved

\[Documentation cleanup]

Improved multiple catalog and pay-in endpoint descriptions for clarity and consistency, including:

* Better payout/pay-in terminology separation
* More accurate service descriptions
* Clarified asynchronous processing behavior