---
title: "Prepare batch payment (V1 Legacy)"
method: PUT
path: "/v1/payments/batch-pay"
tags: ["Payments"]
---

# Prepare batch payment (V1 Legacy)

`PUT /v1/payments/batch-pay`

V1-compatible endpoint to prepare a batch of pay-now payments for signing. Returns EIP-712 typed data.

## Request body

- object
  - `wallet` string, required — Wallet address of the payer.
  - `rise_id` union, required — RiseID, address, or team nanoid of the paying team.
    - string
    - number
  - `total_amount` union, required — Sum of all payment amounts, in micro-USD (1,000,000 = $1.00); must match the payments array.
    - string
    - number
  - `payments` object[], required
    - `recipient` union, required — RiseID, address, or user nanoid of the payee.
      - string
      - number
    - `amount` union, required — Payment amount in micro-USD (1,000,000 = $1.00).
      - string
      - number
    - `salt` union, required — Unique salt for this payment.
      - string
      - number

## Response `200`

Default Response

- object
  - `data` object, required
    - `domain` object, required — EIP-712 domain separator.
    - `types` object, required — EIP-712 type definitions.
    - `message` unknown, required
    - `primaryType` string, required — EIP-712 primary type name.
  - `duplicates` object — Present only when potential duplicate payments (same payee/amount within the lookback window) were detected.
    - `days_checked` number, required
    - `payments` object[], required
      - `to` string, required
      - `amount_cents` number, required
      - `currency_symbol` string, required
      - `invoice_description` string, required
      - `payment_details` string, required
      - `external_id` string, required
      - `created_at` union, required
        - string
        - string, date-time

## Other responses

- `400` — Bad Request - Invalid parameters
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

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