---
title: "Create typed data for payments"
method: POST
path: "/v2/payments"
tags: ["B2B Payments"]
---

# Create typed data for payments

`POST /v2/payments`

Create typed data for payments. The typed data can be signed and then executed to create the payments on-chain.

## Headers

- `x-idempotency-key` string, required

## Request body

- object
  - `from` string, required — Identifier of a Rise team (a workspace below a company). 15-character nanoid prefixed with `te-`.
  - `to` object[], required
    - `to` string, required — Identifier of a Rise user. 15-character nanoid prefixed with `us-`.
    - `amount_cents` integer, required
    - `currency_symbol` 'USD'
    - `invoice_description` string
  - `pay_now` boolean, required
  - `network` 'arbitrum'

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object, required
    - `to_sign` union, required
      - object
        - `domain` object, required
          - `name` string, required
          - `version` string, required
          - `chainId` number, required
          - `verifyingContract` string, required — EVM address (0x + 40 hex chars) or null/empty for unknown.
        - `types` object, required
          - `CreatePaymentAuthorizationForwardRequest` object[], required
            - `name` string, required
            - `type` string, required
          - `RisePaymentAuthorizationRequest` object[], required
            - `name` string, required
            - `type` string, required
        - `typed_data` object, required
          - `from` string, required — EVM address (0x + 40 hex chars) or null/empty for unknown.
          - `to` string, required — EVM address (0x + 40 hex chars) or null/empty for unknown.
          - `salt` string, required
          - `expires` string, required
          - `data` object, required
            - `groupID` string, required
            - `merkleRoot` string, required
            - `paymentsCount` string, required
            - `maxAmountPerPayment` string, required
            - `deadline` string, required
        - `primary_type` string, required
      - object
        - `domain` object, required
          - `name` string, required
          - `version` string, required
          - `chainId` number, required
          - `verifyingContract` string, required — EVM address (0x + 40 hex chars) or null/empty for unknown.
        - `types` object, required
          - `CreatePaymentsAndExecutePayNowForwardRequest` object[], required
            - `name` string, required
            - `type` string, required
          - `RisePayNowBatchRequest` object[], required
            - `name` string, required
            - `type` string, required
          - `RisePayNow` object[], required
            - `name` string, required
            - `type` string, required
        - `typed_data` object, required
          - `from` string, required — EVM address (0x + 40 hex chars) or null/empty for unknown.
          - `to` string, required — EVM address (0x + 40 hex chars) or null/empty for unknown.
          - `salt` string, required
          - `expires` string, required
          - `data` object, required
            - `groupID` string, required
            - `token` string, required — EVM address (0x + 40 hex chars) or null/empty for unknown.
            - `payments` object[], required
              - …
        - `primary_type` string, required
    - `payment_data` object, required
      - `checksum` string, required
    - `failed_payments` object[], required
      - `userNanoid` string, required — Identifier of a Rise user. 15-character nanoid prefixed with `us-`.
      - `error` string, required
    - `duplicates` object, required
      - `payments` object[], required
        - `to` string, required — Identifier of a Rise user. 15-character nanoid prefixed with `us-`.
        - `amount_cents` integer, required
        - `currency_symbol` 'AED' | 'ARS' | 'AUD' | 'BDT' | 'BIF' | 'BOB' | 'BRL' | 'BTC' | 'CAD' | 'CDF' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CZK' | 'DKK' | 'EGP' | 'ETB' | 'EUR' | 'GBP' | 'GHS' | 'GMD' | 'GTQ' | 'HKD' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'JOD' | 'JPY' | 'KES' | 'KRW' | 'KWD' | 'LKR' | 'MAD' | 'MMK' | 'MNT' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NGN' | 'NOK' | 'NPR' | 'NZD' | 'PEN' | 'PHP' | 'PKR' | 'PLN' | 'QAR' | 'RON' | 'RWF' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TZS' | 'UGX' | 'USD' | 'USDC' | 'USDT' | 'UYU' | 'UZS' | 'VND' | 'XAF' | 'XOF' | 'ZAR', required — Any currency Rise supports — fiat (ISO-4217 codes like USD, GBP) or crypto (USDC, EURC, BTC, etc.).
        - `invoice_description` string
      - `days_checked` integer, required

## Other responses

- `400` — Bad Request
- `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)